> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/ai/aig/models.md).

# 模型列表(models)

## 1. 概述

通过本接口获取当前 API\_KEY 在当前接入地区可调用的全部模型列表，用于在应用中动态渲染模型选择器，或在调用具体业务接口前校验模型 ID 是否可用。

{% hint style="success" %}
本 API 与 OpenAI 接口格式兼容，可直接使用各语言的 OpenAI SDK 的 `models.list()` 方法调用。
{% endhint %}

{% hint style="info" %}
返回结果为**动态列表**，会根据请求所携带的 API\_KEY 及请求接入的地区实时过滤：

* 若该模型未对当前 API\_KEY 开放，则不会出现在返回列表中；
* 若当前接入地区不支持该模型（受模型供应商的地区可用性限制），则不会出现在返回列表中。

因此，不同 API\_KEY、不同地区请求同一接口，返回的模型数量与内容可能不同。列表中未出现的模型即表示当前不可调用，请勿据此判断该模型在平台上是否存在。如需开通更多模型权限，请联系支持团队。
{% endhint %}

## 2. 请求说明

* **请求方法**:`GET`
* **请求地址**:

  > `https://gateway.theturbo.ai/v1/models`

***

## 3. 请求参数

### 3.1 Header 参数

| 参数名称            | 类型     | 必填 | 说明                                         | 示例值                    |
| --------------- | ------ | -- | ------------------------------------------ | ---------------------- |
| `Authorization` | string | 是  | 身份验证所需的 API\_KEY，格式 `Bearer $YOUR_API_KEY` | `Bearer $YOUR_API_KEY` |

***

## 4. 请求示例

{% tabs %}
{% tab title="HTTP" %}

```http
GET /v1/models
Authorization: Bearer $YOUR_API_KEY
```

{% endtab %}

{% tab title="Shell" %}

```sh
curl https://gateway.theturbo.ai/v1/models \
	-H "Authorization: Bearer $YOUR_API_KEY"
```

{% endtab %}

{% tab title="Go" %}

```go
package main

import (
	"context"
	"fmt"

	"github.com/openai/openai-go"
	"github.com/openai/openai-go/option"
)

func main() {
	apiKey := "sk-123456789012345678901234567890123456789012345678"

	client := openai.NewClient(
		option.WithAPIKey(apiKey),
		option.WithBaseURL("https://gateway.theturbo.ai/v1"),
	)

	page, err := client.Models.List(context.Background())
	if err != nil {
		fmt.Println("error:", err)
		return
	}

	for _, model := range page.Data {
		fmt.Printf("%s (owned_by: %s)\n", model.ID, model.OwnedBy)
	}
}

```

{% endtab %}

{% tab title="Python" %}

```python
#!/usr/bin/env python3

from openai import OpenAI

def main():
    api_key = "sk-123456789012345678901234567890123456789012345678"

    client = OpenAI(
        api_key=api_key,
        base_url="https://gateway.theturbo.ai/v1"
    )

    models = client.models.list()

    for model in models.data:
        print(f"{model.id} (owned_by: {model.owned_by})")

if __name__ == "__main__":
    main()

```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-123456789012345678901234567890123456789012345678",
  baseURL: "https://gateway.theturbo.ai/v1",
});

const models = await client.models.list();

for (const model of models.data) {
  console.log(`${model.id} (owned_by: ${model.owned_by})`);
}
```

{% endtab %}

{% tab title="Java" %}

```java
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.models.ModelListPage;

public final class Main {
    public static void main(String[] args) {
        String apiKey = "sk-123456789012345678901234567890123456789012345678";

        OpenAIClient client = OpenAIOkHttpClient.builder()
                .apiKey(apiKey)
                .baseUrl("https://gateway.theturbo.ai/v1")
                .build();

        ModelListPage page = client.models().list();

        page.data().forEach(model ->
                System.out.println(model.id() + " (owned_by: " + model.ownedBy() + ")"));
    }
}
```

{% endtab %}
{% endtabs %}

## 5. 响应示例

```json
{
	"object": "list",
	"data": [
		{
			"id": "claude-haiku-4-5-20251001",
			"object": "model",
			"owned_by": "anthropic"
		},
		{
			"id": "claude-opus-4-6",
			"object": "model",
			"owned_by": "anthropic"
		},
		{
			"id": "deepseek-v3.1",
			"object": "model",
			"owned_by": "deepseek"
		},
		{
			"id": "deepseek-v4-flash",
			"object": "model",
			"owned_by": "deepseek"
		},
		{
			"id": "gemini-2.5-flash",
			"object": "model",
			"owned_by": "google"
		},
		{
			"id": "gemini-2.5-flash-image",
			"object": "model",
			"owned_by": "google"
		},
		{
			"id": "gpt-4.1",
			"object": "model",
			"owned_by": "openai"
		},
		{
			"id": "gpt-4o",
			"object": "model",
			"owned_by": "openai"
		}
	]
}
```

## 6. 响应参数说明

| 参数名称       | 类型     | 说明                                                      | 示例值                 |
| ---------- | ------ | ------------------------------------------------------- | ------------------- |
| **object** | string | 响应对象类型，固定为 `list`。                                      | `list`              |
| **data**   | array  | 当前 API\_KEY 在当前地区可调用的模型数组，按 `owned_by` 升序、再按 `id` 升序排列。 | -                   |
| id         | string | 模型 ID，调用各业务接口时作为 `model` 参数传入。                          | `deepseek-v4-flash` |
| object     | string | 数组元素对象类型，固定为 `model`。                                   | `model`             |
| owned\_by  | string | 模型所属的供应商标识。                                             | `deepseek`          |

{% hint style="info" %}
`data` 数组可能为空（即 `"data": []`），表示当前 API\_KEY 在当前地区暂无任何可调用模型，请确认 API\_KEY 的模型开通范围及请求接入地区。
{% endhint %}