快速开始

列出模型

文档最后更新于 2026年10月16日 02:29

实时返回当前可调用的全部模型,以及响应里每个字段的含义。

端点:GET /v1/models

实时返回当前可以调用的全部模型。模型 ID 的拼写以本接口返回为准。

请求

鉴权使用 Authorization: Bearer sk-xxxxxx 或 x-api-key: sk-xxxxxx(本接口与 /v1/messages 是仅有的两个接受 x-api-key 的端点),无请求体。

参数

无。

响应

json
{
  "success": true,
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5",
      "object": "model",
      "created": 1626777600,
      "owned_by": "openai",
      "supported_endpoint_types": ["openai", "anthropic"]
    },
    {
      "id": "gpt-5.6-sol",
      "object": "model",
      "created": 1626777600,
      "owned_by": "openai",
      "supported_endpoint_types": ["openai", "openai-response"]
    }
  ]
}
字段说明
success固定为 true(本站扩展字段,OpenAI SDK 会忽略)
object固定为 list
data[].id模型 ID,调用接口时填的就是它
data[].object固定为 model
data[].created占位时间戳(Unix 秒),不代表模型发布时间
data[].owned_by协议兼容标记,不是厂商名,请勿据此判断模型归属(常见值 openai、google gemini、xai、advanced_custom、task plugin 等)
data[].supported_endpoint_types该模型声明的调用协议,取值同 查询模型定价 的同名字段;实际可用协议以 协议支持的模型 为准
调用了不存在的模型名时返回 503 model_not_found,message 末尾会附最多 3 个近似的可用调用名(如 qwen3.8-flsh → 「你是否想用:qwen3.8-flash」),只做提示,不会自动改用。

示例

本页接口与模型无关,示例用 https://acapi.top;换成国内通道 https://api.acapi.top 同样可用,两个地址均可用,见 调用地址。

bash
curl https://acapi.top/v1/models \
  -H "Authorization: Bearer sk-xxxxxx"

错误

鉴权失败统一返回 401,详见 鉴权。

共 30 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。