模型列表
模型列表是当前 UniAll 选定模型文档的统一入口。这里按能力组织页面,而不是沿用原始 Apifox 菜单顺序。
当客户端需要在运行时发现当前 API Key 可用的模型时,可以调用模型列表接口。
能力分类
| 分类 | 页面 | 常用接口 |
|---|---|---|
| 图像生成 | 通用异步图像生成、Seedream、GPT-Image-2、Nano 系列 | POST /v1/images/tasks 或 POST /v1/images/generations |
| 视频生成 | Happy-Horse、Seedance 2.0、Grok Imagine、Veo 3.1、Vidu、Kling、Wan 2.6、Sora 2 | POST /v1/video/generations 或 POST /v1/videos |
| 语音与音乐 | 音乐生成、语音合成 | 模型专属音频接口 |
| 数字人 | 数字人口播 | 模型专属数字人视频接口 |
Model List Endpoint
GET /v1/models
该接口返回当前模型列表。UniAll 会根据请求 Header 返回不同兼容格式:
| 请求风格 | 判断规则 | 响应格式 |
|---|---|---|
| OpenAI 兼容 | 默认请求风格 | OpenAI 模型列表 |
| Anthropic 兼容 | 同时包含 x-api-key 和 anthropic-version | Anthropic 风格模型列表 |
| Gemini 兼容 | 包含 x-goog-api-key Header 或 key 查询参数 | Gemini 风格模型列表 |
在当前文档范围内,规范化页面重点覆盖已选定的图像、视频、语音音乐和数字人能力。
Required Headers
Authorization: Bearer sk-***
兼容格式客户端可以在对应格式文档允许时使用原生认证 Header。
Request Example
curl "{BASE_URL}/v1/models" \
-H "Authorization: Bearer sk-***"
Response Example
{
"object": "list",
"data": [
{
"id": "grok-imagine",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2",
"object": "model",
"created": 0,
"owned_by": "uniall"
}
]
}
Response Fields
| 字段 | 类型 | 说明 |
|---|---|---|
object | string | 列表对象标记。 |
data | array | 可用模型记录。 |
data[].id | string | API 请求中使用的模型 ID。 |
data[].object | string | 模型记录对象类型。 |
data[].created | number | 创建时间戳。部分兼容响应可能使用 0。 |
data[].owned_by | string | 所属方或供应商标签。 |
Selection Guidance
- 图像生成或图像编辑任务使用 通用异步图像生成。
- 当模型 ID 为
grok-imagine时,使用 Grok Imagine 视频生成。 - 能力专属页面会说明模型字段、计费说明和任务生命周期。
/v1/models适合运行时发现模型,不应作为唯一集成规则来源。
Common Errors
| HTTP 状态 | 含义 |
|---|---|
401 | 缺少认证或认证无效。 |
403 | 当前 API Key 已禁用,或没有访问模型列表权限。 |