模型列表
返回当前 API Key 可调用的模型。结果按 API Key 的分组与「模型限制」过滤,与你实际能调用的模型一致,接入前建议先调用一次确认模型名。
| 项 | 值 |
|---|---|
| 方法与路径 | GET /v1/models、GET /v1/models/{model}、GET /v1beta/models、GET /v1beta/openai/models |
| 鉴权 | Authorization: Bearer YOUR_API_KEY(Anthropic、Gemini 格式的鉴权头见 返回格式由请求决定) |
| 计费 | 不消耗额度 |
快速示例
cURL
BASH
curl https://www.nextai-code.com/v1/models \
-H "Authorization: Bearer $NEXTAI_API_KEY"
Python(OpenAI SDK)
PYTHON
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NEXTAI_API_KEY"],
base_url="https://www.nextai-code.com/v1",
)
for m in client.models.list():
print(m.id)
Node.js(OpenAI SDK)
JAVASCRIPT
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.NEXTAI_API_KEY,
baseURL: "https://www.nextai-code.com/v1",
});
for await (const m of client.models.list()) {
console.log(m.id);
}
返回格式由请求决定
同一个 /v1/models 会根据请求头返回不同格式,便于各家 SDK 直接使用:
| 请求 | 返回格式 |
|---|---|
GET /v1/models + Authorization: Bearer |
OpenAI 格式 |
GET /v1/models + x-api-key 且 anthropic-version |
Anthropic 格式 |
GET /v1beta/models |
Gemini 格式 |
GET /v1beta/openai/models |
OpenAI 格式 |
需要 Gemini 格式请调用 /v1beta/models,不要在 /v1/models 上带 x-goog-api-key 或 ?key=(该组合不会返回模型列表)。
响应
OpenAI 格式
JSON
{
"success": true,
"object": "list",
"data": [
{
"id": "gpt-6.1-sol",
"object": "model",
"created": 1626777600,
"owned_by": "openai",
"supported_endpoint_types": ["openai"]
},
{
"id": "claude-sonnet-5-5",
"object": "model",
"created": 1626777600,
"owned_by": "custom",
"supported_endpoint_types": ["anthropic", "openai"]
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
object |
string | 固定 list |
data[].id |
string | 模型名,调用时填入 model |
data[].object |
string | 固定 model |
data[].created |
integer | 固定值,无实际含义,不要用于排序或判断上线时间 |
data[].owned_by |
string | 模型归属标识,仅供参考;部分模型为 custom |
data[].supported_endpoint_types |
string[] | 该模型支持的接口类型,见下表 |
success |
boolean | 平台扩展字段,固定 true |
supported_endpoint_types 取值:
| 值 | 对应接口 |
|---|---|
openai |
/v1/chat/completions |
openai-response |
/v1/responses |
anthropic |
/v1/messages |
gemini |
/v1beta/models/{model}:generateContent |
image-generation |
/v1/images/generations |
embeddings |
/v1/embeddings |
jina-rerank |
/v1/rerank |
openai-video |
/v1/videos |
Anthropic 格式
BASH
curl https://www.nextai-code.com/v1/models \
-H "x-api-key: $NEXTAI_API_KEY" \
-H "anthropic-version: 2023-06-01"
JSON
{
"data": [
{
"id": "claude-sonnet-5-5",
"created_at": "2021-07-20T10:40:00Z",
"display_name": "claude-sonnet-5-5",
"type": "model"
}
],
"has_more": false,
"first_id": "claude-sonnet-5-5",
"last_id": "claude-sonnet-5-5"
}
一次返回全部模型,has_more 固定为 false,不支持分页参数。display_name 与 id 相同,created_at 为固定值。
Gemini 格式
BASH
curl https://www.nextai-code.com/v1beta/models \
-H "x-goog-api-key: $NEXTAI_API_KEY"
JSON
{
"models": [
{
"name": "gemini-3.8-flash",
"baseModelId": null,
"version": null,
"displayName": "gemini-3.8-flash",
"description": null,
"inputTokenLimit": null,
"outputTokenLimit": null,
"supportedGenerationMethods": null,
"thinking": null,
"temperature": null,
"maxTemperature": null,
"topP": null,
"topK": null
}
],
"nextPageToken": null
}
只有 name 与 displayName 有值(均为模型名,不带 Google 的 models/ 前缀),其余字段为 null。所有模型一次返回,nextPageToken 固定为 null。
列出的模型并非都能通过 Gemini 原生接口调用,请结合 OpenAI 格式中的 supported_endpoint_types 判断。
查询单个模型
BASH
curl https://www.nextai-code.com/v1/models/gpt-6.1-sol \
-H "Authorization: Bearer $NEXTAI_API_KEY"
JSON
{
"id": "gpt-6.1-sol",
"object": "model",
"created": 1626777600,
"owned_by": "openai",
"supported_endpoint_types": null
}
带 x-api-key + anthropic-version 时返回单个 Anthropic 格式对象(id、created_at、display_name、type)。
该接口只适合查询常见模型的基本信息,与列表接口有三点不同:
- 不按你的 API Key 分组和模型限制过滤,能查到不代表能调用;
- 列表中
owned_by为custom的模型查询会返回不存在,查不到也不代表不能调用; supported_endpoint_types固定为null。
判断某个模型能否调用、支持哪些接口,请以 GET /v1/models 列表为准。
模型不存在时 HTTP 状态码仍为 200,响应体为错误对象,请检查响应中是否有 error 字段:
JSON
{
"error": {
"message": "The model 'xxx' does not exist",
"type": "invalid_request_error",
"param": "model",
"code": "model_not_found"
}
}
错误
- API Key 无效或已过期返回
401,API Key 额度用尽返回402,IP 不在白名单返回403,详见 错误码。 - 列表为空(
data: [])表示该 API Key 的分组下暂无可用模型,或「模型限制」中的模型均已停止提供。请在控制台「API Keys」页编辑该 API Key,更换分组或调整模型限制。