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

# 列出模型

> 取得目前可用的模型清單

## 簡介

取得目前可用的模型清單。本介面支援自動識別回傳格式，無需手動指定。

## 自動格式識別

根據請求標頭自動回傳對應格式：Anthropic、Gemini 或 OpenAI 格式

## 認證

Bearer Token，如 `Bearer sk-xxxxxxxxxx`

## 請求標頭說明

根據請求標頭自動識別回傳格式：

**x-anthropic-version** `string`

回傳 Anthropic 格式回應

**x-goog-api-key** `string`

回傳 Gemini 格式回應

> [!NOTE]
>
> 預設回傳 OpenAI 格式回應

## 程式碼範例

**cURL**

```bash theme={null}
curl https://api.mixroute.ai/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

**Python**

```python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

models = client.models.list()

for model in models.data:
    print(f"Model ID: {model.id}, Provider: {model.owned_by}")
```

**Node.js**

```javascript theme={null}
const axios = require('axios');

const response = await axios.get('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});

console.log(response.data.data);
```

## 回應欄位說明

| 欄位 | 類型 | 說明 |
| - | - | - |
| object | string | 固定為 `list` |
| data | array | 模型列表 |
| data\[].id | string | 模型唯一識別碼 |
| data\[].object | string | 固定為 `model` |
| data\[].created | integer | 模型建立時間戳記（Unix 時間戳記） |
| data\[].owned\_by | string | 模型提供商（如：openai、anthropic、google） |

## 回應範例

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-3.5-flash",
      "object": "model",
      "created": 1746057600,
      "owned_by": "google"
    }
  ]
}
```

## HTTP 狀態碼

| 狀態碼 | 說明 |
| - | - |
| 200 | 請求成功 |
| 401 | API Key 無效或已過期 |
| 429 | 請求頻率過高 |
| 500 | 伺服器內部錯誤 |

## 錯誤回應範例

```json theme={null}
{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
```

## 注意事項

* 建議快取模型清單，避免頻繁請求（建議快取 1 小時）
* 回傳的模型清單會根據您的 API Key 權限動態變化
* 可在應用程式啟動時呼叫此介面進行可用性檢查
* 不同模型的 `created` 時間戳記可能差異較大，僅代表模型發布時間
* Python 範例依賴 `openai` 函式庫：`pip install openai`
* Node.js 範例依賴 `axios` 函式庫：`npm install axios`

```bash cURL theme={null}
curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'
```

```python Python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxxxx",
    base_url="https://api.mixroute.ai/v1"
)

models = client.models.list()
for model in models.data:
    print(f"Model ID: {model.id}")
```

```javascript JavaScript theme={null}
const response = await fetch('https://api.mixroute.ai/v1/models', {
  headers: {
    'Authorization': 'Bearer sk-xxxxxxxxxx'
  }
});
const data = await response.json();
console.log(data.data);
```

```php PHP theme={null}
<?php
$client = new GuzzleHttp\Client();
$response = $client->get('https://api.mixroute.ai/v1/models', [
    'headers' => [
        'Authorization' => 'Bearer sk-xxxxxxxxxx'
    ]
]);
echo $response->getBody();
```

```go Go theme={null}
package main

import (
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://api.mixroute.ai/v1/models", nil)
    req.Header.Set("Authorization", "Bearer sk-xxxxxxxxxx")
    http.DefaultClient.Do(req)
}
```

```java Java theme={null}
import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mixroute.ai/v1/models"))
    .header("Authorization", "Bearer sk-xxxxxxxxxx")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

```ruby Ruby theme={null}
require 'net/http'
require 'json'

uri = URI('https://api.mixroute.ai/v1/models')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer sk-xxxxxxxxxx'

response = http.request(request)
puts response.body
```

```json Response theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-opus-4-8",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.