接口地址
POST /v1/images/generations
支持模型
vidu-imageviduq3-fastviduq2-providuq2-fast
模型说明
请求参数
string
必填
只支持这 4 个模型名:
vidu-imageviduq3-fastviduq2-providuq2-fast
string
必填
文本提示词
string[]
参考图 URL,支持 0-7 张
integer
默认值:1
仅支持
1string
默认值:"1:1"
支持比例值,也支持像素值,例如
1024*1024支持的比例值:1:14:33:416:99:163:22:3
string
默认值:"1K"
当
size 传比例值时可选分辨率:1K2K4K
viduq2-fast 仅支持 1K。当 size 使用比例值且 metadata.resolution 为 2K 或 4K 时会直接报错。integer
随机种子
boolean
默认值:false
是否加水印
请求示例
提交成功响应
client_business_id,响应顶层也会带出该字段。
查询任务
GET /v1/images/generations/{task_id}
处理中
成功
失败
计费与行为说明
- 这 4 个模型都走统一图片异步任务接口:
POST /v1/images/generations - 返回值中的
object固定为generation.task - 结果完成后通过
result.data[].url返回图片地址 viduq2-fast是轻量规格,只保留1K- 如需更高分辨率,优先使用
vidu-image、viduq3-fast或viduq2-pro
说明
- Vidu 图片渠道会先在上游创建任务,再轮询上游任务状态。
- 成功结果会镜像到 ToAPIs 自有 R2,再返回统一图片任务响应。
expires_at为completed_at + 24h。