API
Models
获取当前 API key 可访问的模型列表，并按客户端格式返回 OpenAI、Anthropic 或 Gemini 结构。
概述
Models 接口返回当前 API key 可访问的模型。默认返回 OpenAI-style 列表；如果请求头包含 Anthropic 或 Gemini 兼容标记，网关可按对应格式返回。
公开模型信息和价格请优先查看 `/models`，程序化探测可使用本接口。
请求
`GET https://api.example.com/v1/models`
Headers
| Header | 必需 | 说明 |
|---|---|---|
| Authorization | ✓ | `Bearer $UOUODUO_API_KEY` |
| anthropic-version | 否 | 搭配 `x-api-key` 时可返回 Anthropic-style |
| x-api-key | 否 | Anthropic-style key 头 |
| x-goog-api-key | 否 | Gemini-style key 头 |
Query 参数
| 参数 | 类型 | 必需 | 默认 | 说明 |
|---|---|---|---|---|
| key | string | 否 | - | Gemini-style API key query 参数 |
示例
curl https://api.example.com/v1/models \
-H "Authorization: Bearer $UOUODUO_API_KEY"响应
OpenAI-style
| 字段 | 类型 | 说明 |
|---|---|---|
| object | string | `list` |
| data | array<object> | 模型列表 |
| data[].id | string | 模型 ID |
| data[].object | string | `model` |
| data[].created | integer | 创建时间，可能为 0 |
| data[].owned_by | string | 所属供应商或组织 |
{
"object": "list",
"data": [
{
"id": "gpt-4o-mini",
"object": "model",
"created": 0,
"owned_by": "openai"
}
]
}Anthropic / Gemini-style
部分客户端会通过 `anthropic-version`、`x-api-key`、`x-goog-api-key` 或 `key` 查询参数请求供应商原生格式。网关会尽量返回对应结构，但生产系统不应依赖这些列表里的价格和上下文窗口；价格、context 和 modality 以 `/models` 和控制台配置为准。
错误
| HTTP | 说明 | 处理建议 |
|---|---|---|
| 401 | API key 缺失或无效 | 重新创建 key |
| 403 | key 被禁用或无模型权限 | 检查 `/app/keys` |
| 500 | 模型表或上游异常 | 查看 `/status` |
注意事项
- 模型可见不代表所有 endpoint 都支持；请看具体模型的 endpoints。
- 如果客户端自动探测模型列表失败，可以手动填写模型 ID。
- 自部署小众模型需要先在 UOUODUO 控制台注册，才会稳定出现在 `/models`。