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

# 列出模型

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

## 簡介

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

## 自動格式識別

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

## 認證

Bearer Token，如 `Bearer sk-xxxxxxxxxx`

## 請求標頭說明

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

<ParamField header="x-anthropic-version" type="string">
  回傳 Anthropic 格式回應
</ParamField>

<ParamField header="x-goog-api-key" type="string">
  回傳 Gemini 格式回應
</ParamField>

<Note>
  預設回傳 OpenAI 格式回應
</Note>

## 程式碼範例

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

  <Tab title="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}")
    ```
  </Tab>

  <Tab title="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);
    ```
  </Tab>
</Tabs>

## 回應欄位說明

| 欄位                | 類型      | 說明                               |
| ----------------- | ------- | -------------------------------- |
| 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`

<RequestExample>
  ```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
  ```
</RequestExample>

<ResponseExample>
  ```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"
      }
    ]
  }
  ```
</ResponseExample>