Skip to main content

接口地址

POST /v1/images/generations

支持模型

  • vidu-image
  • viduq3-fast
  • viduq2-pro
  • viduq2-fast

模型说明

请求参数

string
必填
只支持这 4 个模型名:
  • vidu-image
  • viduq3-fast
  • viduq2-pro
  • viduq2-fast
string
必填
文本提示词
string[]
参考图 URL,支持 0-7 张
integer
默认值:1
仅支持 1
string
默认值:"1:1"
支持比例值,也支持像素值,例如 1024*1024支持的比例值:
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16
  • 3:2
  • 2:3
string
默认值:"1K"
size 传比例值时可选分辨率:
  • 1K
  • 2K
  • 4K
viduq2-fast 仅支持 1K。当 size 使用比例值且 metadata.resolution2K4K 时会直接报错。
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-imageviduq3-fastviduq2-pro

说明

  • Vidu 图片渠道会先在上游创建任务,再轮询上游任务状态。
  • 成功结果会镜像到 ToAPIs 自有 R2,再返回统一图片任务响应。
  • expires_atcompleted_at + 24h