端点: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,详见 鉴权。