模型列表
本页示例中的 {BASE_URL} 表示 https://api.uniall.ai。
模型列表是当前 UniAll 选定模型文档的统一入口。这里按能力组织页面,而不是沿用原始 Apifox 菜单顺序。
当客户端需要在运行时发现当前 API Key 可用的模型时,可以调用模型列表接口。
能力分类
| 分类 | 页面 | 常用接口 |
|---|---|---|
| 图像生成 | 通用异步图像生成、Seedream、Seedream 5.0 Pro、GPT-Image-2、GPT-Image-2.5、GPT-Image-2.6、Qwen Image、Nano 系列(含 Nano Banana 2.1)、Kling | POST /v1/images/tasks、POST /v1/images/generations 或 POST /v1/images/edits |
| 视频生成 | Happy Horse、Seedance 2.0、Seedance 2.5、Grok Imagine、Veo 3.1、Gemini Omni Flash Preview、Vidu Q3、Hailuo、MiniMax H3 / H3 Max、Kling、Wan 2.6、Sora 2 | POST /v1/video/generations、POST /v1/videos、POST /v1beta/interactions 或 POST /v2/video_generation |
| 语音与音乐 | 音乐生成、语音合成 | 模型专属音频接口 |
| 数字人 | 数字人口播 | 模型专属数字人视频接口 |
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.5-flare",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2.6-flare",
"object": "model",
"created": 0,
"owned_by": "uniall"
},
{
"id": "gpt-image-2.6-sunburst",
"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
-
Nano Banana 2.1:OpenAI 风格使用
nano-banana-2.1,参阅 OpenAI Images 指引;Gemini 风格使用官方 IDgemini-nano-banana-2.1,参阅 Gemini generateContent 指引。两种风格均同步返回结果。 -
图像生成或图像编辑任务使用 通用异步图像生成。
-
使用 Qwen Image 调用 3.0、2.1、2.0 系列六个模型的 OpenAI Images 或百炼原生同步生图与编辑接口。
-
使用 GPT-Image-2.5 调用 GPT Image 2.5 的同步生成和编辑接口。
-
使用 GPT-Image-2.6 调用
gpt-image-2.6-flare和gpt-image-2.6-sunburst的同步生图、编辑及 GIF 生成接口。 -
当模型 ID 为
seedream-5.0-pro时,使用 Seedream 5.0 Pro 图像生成。 -
模型 ID
seedance2.5使用 Seedance 2.5,支持普通 1080p 输出及 480p Draft 转 1080p 成片流程。 -
使用 MiniMax H3 原生 API 调用
MiniMax-H3和MiniMax-H3-Max。 -
当模型 ID 为
grok-imagine时,使用 Grok Imagine 视频生成。 -
当模型 ID 为
gemini-omni-flash-preview时,使用 Gemini Omni Flash Preview 视频生成。 -
当模型 ID 为
hailuo-02、hailuo-2.3或hailuo-2.3-fast时,使用 Hailuo 视频生成。 -
使用 Kling 图片调用
kling-v3、kling-v3-omni或kling-image-o1图片任务。 -
能力专属页面会说明模型字段和任务生命周期。
-
/v1/models适合运行时发现模型,不应作为唯一集成规则来源。
Common Errors
| HTTP 状态 | 含义 |
|---|---|
401 | 缺少认证或认证无效。 |
403 | 当前 API Key 已禁用,或没有访问模型列表权限。 |