模型列表

返回当前 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,更换分组或调整模型限制。

相关文档