模型列表
AIRouter 的可用模型由平台配置、账号权限、API Key 限制共同决定。不要只依赖静态文档中的模型名称,接入前请查询实时模型列表。
在控制台查看
登录后进入「模型」页面:
https://aigc.aochengcloud.com/models
模型页可用于查看当前站点开放的模型、供应商、价格和状态。管理员可能会调整模型名称、价格或可用范围,以页面实际展示为准。

通过 API 查询
curl https://aigc.aochengcloud.com/v1/models \
-H "Authorization: Bearer $AIROUTER_API_KEY"
响应示例:
{
"object": "list",
"data": [
{
"id": "claude-sonnet-4-6",
"object": "model",
"created": 1626777600,
"owned_by": "vertex-ai",
"supported_endpoint_types": ["openai"]
}
]
}
调用接口时使用 data[].id:
curl https://aigc.aochengcloud.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AIROUTER_API_KEY" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "user", "content": "你好"}
]
}'
模型不可用时怎么排查
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
/v1/models 中没有目标模型 | 账号或分组未开放该模型 | 换用列表中的模型,或联系管理员开通 |
| 调用提示模型不存在 | 模型 ID 拼写错误或已下线 | 重新复制模型 ID |
| 调用提示无权限 | API Key 设置了 Model Limits | 编辑 API Key,放开模型限制 |
| 调用失败但模型存在 | 上游暂时不可用或余额不足 | 查看「使用日志」和钱包余额 |
选择模型的建议
- 先用
/v1/models确认可用模型,再写入配置。 - 生产环境把模型 ID 做成配置项,避免模型调整时必须改代码。
- 对成本敏感的业务,先在模型页查看价格,再逐步放量。
- 如果 API Key 设置了模型限制,确保业务使用的模型都在允许列表内。