> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Anaconda Desktop API

export const Comments = ({children}) => {
  return <div class="my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10" data-callout-type="comments">
      <div class="w-4">
        <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" xmlns="http://www.w3.org/2000/svg" class="w-5 h-5" aria-label="Comments">
            <path d="M320 112C434.9 112 528 205.1 528 320C528 434.9 434.9 528 320 528C205.1 528 112 434.9 112 320C112 205.1 205.1 112 320 112zM320 576C461.4 576 576 461.4 576 320C576 178.6 461.4 64 320 64C178.6 64 64 178.6 64 320C64 461.4 178.6 576 320 576zM280 400C266.7 400 256 410.7 256 424C256 437.3 266.7 448 280 448L360 448C373.3 448 384 437.3 384 424C384 410.7 373.3 400 360 400L352 400L352 312C352 298.7 341.3 288 328 288L280 288C266.7 288 256 298.7 256 312C256 325.3 266.7 336 280 336L304 336L304 400L280 400zM320 256C337.7 256 352 241.7 352 224C352 206.3 337.7 192 320 192C302.3 192 288 206.3 288 224C288 241.7 302.3 256 320 256z" />
        </svg>
      </div>
      <div class="text-sm prose min-w-0 w-full">
        {children}
      </div>
    </div>;
};

The Anaconda Desktop API provides a programmatic interface for managing models. It provides a complete infrastructure for downloading, hosting, and serving models on your own hardware.

## Configuring the Desktop API

To access your Desktop API key and API server port:

1. Select the user dropdown menu in the upper-right corner.
2. Select <Icon icon="gear" iconType="light" /> *Settings*.
3. Navigate to the *Desktop API Configurations* section.

From the configurations section, you can <Icon icon="eye" iconType="light" /> **View**, <Icon icon="copy" iconType="light" /> **Copy**, and <Icon icon="rotate-left" iconType="light" /> **Rotate** your API key, configure your API server port, and access interactive API documentation.

## Making your first request

### Understanding your server configuration

Your Desktop API server runs locally on your machine at the address `localhost` (also written as `127.0.0.1`).

The **Settings** page shows two additional key pieces of information you'll need:

* **Server port**: The port number where your server listens for requests.
* **API key**: Used for authentication in your requests.

Your base URL combines the server address and port. For example: `http://localhost:8001/`

### Testing your connection

To test your connection to the Desktop API server, open [Anaconda Prompt](/docs/reference/glossary#anaconda-prompt) (Terminal on macOS/Linux) and run the following command:

<CodeGroup>
  ```sh Anaconda Prompt theme={null}
  curl --request GET ^
      --url http://localhost:8001/api/models/health ^
      --header 'Authorization: Bearer <API_KEY>' ^
      --header "Content-Type: application/json" ^
  ```

  ```sh Anaconda PowerShell Prompt theme={null}
  curl --request GET `
      --url "http://localhost:8001/api/models/health" `
      --header "Authorization: Bearer <API_KEY>" `
      --header "Content-Type: application/json"
  ```

  ```sh Terminal  theme={null}
  curl --request GET \
      --url "http://localhost:8001/api/models/health" \
      --header "Authorization: Bearer <API_KEY>" \
      --header "Content-Type: application/json"
  ```
</CodeGroup>

<Comments>
  Replace \<API\_KEY> with the API key listed on the <Icon icon="gear" iconType="light" /> **Settings** page.
</Comments>

The API should return `/api/models/health ok`. If you receive an error, verify your API key and port number match what's on the **Settings** page, then try again.