接口说明
图像生成接口说明
统一规范
不同模型的特有功能通过扩展字段传递，不传扩展字段也能正常工作。
同步接口
基础请求字段（所有同步模型通用）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | ✅ | - | 模型名称 |
| prompt | string | ✅ | - | 图片描述文本 |
| n | integer | 否 | 1 | 生成数量 1-10 |
| size | string | 否 | 1024x1024 | 图片尺寸，如 1024x1024、1792x1024 |
| quality | string | 否 | auto | 质量：auto/low/medium/high/standard/hd |
| response_format | string | 否 | url | 返回格式：url 或 b64_json |
基础响应格式（所有同步模型统一）
| 字段 | 类型 | 说明 |
|---|---|---|
| created | integer | 创建时间戳（Unix 秒） |
| data[] | array | 图片列表 |
| data[].url | string | 图片 URL |
| data[].b64_json | string | 图片 base64 数据 |
| data[].revised_prompt | string | 优化后的提示词（部分模型返回） |
| usage | object | Token 统计（部分模型返回） |
异步接口
查询：GET /v1/video/generations/:task_id
基础请求字段（所有异步模型通用）
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | ✅ | - | 模型名称 |
| prompt | string | ✅ | - | 描述文本 |
| size | string | 否 | 1024x1024 | 输出尺寸 |
| image | string | 否 | - | 参考图片 URL（图生图时使用） |
| duration | integer | 否 | 5 | 视频时长秒数（视频生成时使用） |
| metadata | object | 否 | - | 扩展参数（各模型特有参数放此处） |
基础响应格式（所有异步模型统一）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 任务 ID |
| object | string | 固定 "video" |
| model | string | 模型名称 |
| status | string | queued / in_progress / completed / failed |
| progress | integer | 进度 0-100 |
| created_at | integer | 创建时间戳 |
| 字段 | 类型 | 说明 |
|---|---|---|
| completed_at | integer | 完成时间戳 |
| metadata.url | string | 结果下载地址 |
| error | object | 错误信息（失败时） |
各模型扩展参数
修改于 2026-05-13 05:44:56