获取模型列表
查询当前可用的 AI 模型列表及其详细信息。
我们提供两个端点用于获取模型列表:AI 模型目录返回完整的模型信息和能力参数,兼容端点提供 Anthropic API 格式的精简列表。
AI 模型目录
返回完整的内部模型目录,包含模型 ID、显示名称、类别和能力参数。
GET/v1/ai-models
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| category | string | Optional | 按类别筛选:text、image、audio、embedding |
| active_only | boolean | Optional | 仅返回可用模型,默认 true |
响应示例
{
"object": "list",
"data": [
{
"id": "anthropic-claude-sonnet-4-6",
"model_id": "550e8400-...",
"display_name": "Claude Sonnet 4.6",
"category": "text",
"capabilities": {
"max_tokens": 200000,
"supports_streaming": true,
"supports_reasoning": true,
"supports_vision": false
},
"is_active": true
}
]
}请求示例
curl "https://api.aideskapp.com/v1/ai-models" \ -H "Authorization: Bearer sk-aidesk-YOUR_KEY" # 按类别筛选 curl "https://api.aideskapp.com/v1/ai-models?category=text" \ -H "Authorization: Bearer sk-aidesk-YOUR_KEY"
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 模型唯一标识,用于 API 请求中的 model 参数 |
| display_name | string | 模型的显示名称 |
| category | string | 模型类别:text、image、audio、embedding |
| capabilities | object | 模型能力参数(上下文长度、是否支持流式等) |
| is_active | boolean | 模型是否当前可用 |
Anthropic 兼容端点
返回 Anthropic API 格式的模型列表,适用于 Claude Code 等工具的模型验证。
GET/models
响应示例
{
"data": [
{
"type": "model",
"id": "anthropic-claude-sonnet-4-6",
"display_name": "Claude Sonnet 4.6",
"created_at": "2026-04-28T12:00:00+00:00"
}
],
"has_more": false,
"first_id": "anthropic-claude-sonnet-4-6",
"last_id": "deepseek-chat"
}请求示例
curl "https://api.aideskapp.com/models" \ -H "Authorization: Bearer sk-aidesk-YOUR_KEY"
工具模型映射
查询外部工具(Claude Code、Cursor 等)使用的模型名称与内部模型的映射关系。
GET/v1/tool-models
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tool | string | Optional | 按工具名筛选:claude_code、cursor、aidesk_web |
| active_only | boolean | Optional | 仅返回活跃映射,默认 true |
响应示例
{
"object": "list",
"data": [
{
"tool_name": "claude_code",
"model_name": "claude-sonnet-4-6",
"ai_model_code": "anthropic-claude-sonnet-4-6",
"description": "Claude Sonnet 4.6 model for Claude Code",
"is_active": true
}
]
}请求示例
# 查看 Claude Code 可用模型 curl "https://api.aideskapp.com/v1/tool-models?tool=claude_code" \ -H "Authorization: Bearer sk-aidesk-YOUR_KEY"