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

# Models

> List and query available models

# Models

List available models on the edge infrastructure.

<Note>
  Edge endpoints accept your `pg_*` API key as a bearer token. See [Authentication](/authentication) for details. The cURL examples below pin Toronto (`yto-01`) for concreteness — substitute another region or discover the fastest one via `GET https://autorouter.polargrid.ai/v1/route`. See [API Overview](/api-reference/overview#picking-a-region) for both patterns.
</Note>

## List Models

```
GET /v1/models
```

List all available models.

### Example Request

<CodeGroup>
  ```bash cURL theme={null}
  # Edge endpoints accept your pg_* API key as a bearer token — see Authentication
  curl https://api.yto-01.edge.polargrid.ai/v1/models \
    -H "Authorization: Bearer pg_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const { data: models } = await client.listModels();

  models.forEach(model => {
    console.log(`${model.id} (${model.ownedBy})`);
  });
  ```

  ```python Python theme={null}
  response = await client.list_models()

  for model in response.data:
      print(f"{model.id} ({model.owned_by})")
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "qwen-3.5-27b",
      "object": "model",
      "created": 1234567890,
      "owned_by": "qwen",
      "permission": [],
      "root": "qwen-3.5-27b",
      "parent": null
    },
    {
      "id": "qwen-3.5-27b",
      "object": "model",
      "created": 1234567890,
      "owned_by": "qwen",
      "permission": [],
      "root": "qwen-3.5-27b",
      "parent": null
    },
    {
      "id": "kokoro-82m",
      "object": "model",
      "created": 1234567890,
      "owned_by": "kokoro",
      "permission": [],
      "root": "kokoro-82m",
      "parent": null
    },
    {
      "id": "whisper-large-v3-turbo",
      "object": "model",
      "created": 1234567890,
      "owned_by": "openai",
      "permission": [],
      "root": "whisper-large-v3-turbo",
      "parent": null
    },
    {
      "id": "cohere-transcribe-03-2026",
      "object": "model",
      "created": 1234567890,
      "owned_by": "cohere",
      "permission": [],
      "root": "cohere-transcribe-03-2026",
      "parent": null
    },
    {
      "id": "tada-3b-ml",
      "object": "model",
      "created": 1234567890,
      "owned_by": "hume",
      "permission": [],
      "root": "tada-3b-ml",
      "parent": null
    }
  ]
}
```

## Available Model Types

### Text Generation

| Model          | Size | Use Case                                          |
| -------------- | ---- | ------------------------------------------------- |
| `qwen-3.5-27b` | 27B  | High quality, complex reasoning, tools, JSON mode |

### Speech-to-Text

| Model                       | Description                       |
| --------------------------- | --------------------------------- |
| `whisper-large-v3-turbo`    | Fast, accurate                    |
| `cohere-transcribe-03-2026` | Cohere multilingual transcription |

### Text-to-Speech

| Model        | Description         |
| ------------ | ------------------- |
| `kokoro-82m` | Lightweight, fast   |
| `tada-3b-ml` | Hume expressive TTS |