该接口可以根据提示词和参考图生成图片。

请求信息

请求 URL

POST /hub/vidu/v2/reference2image

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
model	string	是	模型名称。常见可选值：viduq2、viduq1
prompt	string	是	文本提示词，最长 2000 字符。viduq2 在不传 images 时也支持纯文生图
images	string[]	否	参考图片。viduq2 常见支持 0-7 张；viduq1 常见支持 1-7 张。支持 URL 或 Base64
seed	int	否	随机种子。传 0 或不传时自动生成
aspect_ratio	string	否	画面比例。viduq1 常见值：16:9、9:16、1:1、3:4、4:3；viduq2 额外常见支持 21:9、2:3、3:2、auto
resolution	string	否	输出分辨率。viduq1 常见仅支持 1080p；viduq2 常见支持 1080p、2K、4K
payload	string	否	透传字段，最长 1048576 字符
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

json{
  "model": "viduq2",
  "images": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "prompt": "生成一张电影质感的人像海报，保留参考图主体特征。",
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "2K"
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
model	string	模型名称
images	string[]	输入图片
prompt	string	提示词
seed	int	随机种子
aspect_ratio	string	画面比例
resolution	string	分辨率
payload	string	透传字段
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567900",
  "state": "created",
  "model": "viduq2",
  "images": [
    "https://example.com/ref-1.png",
    "https://example.com/ref-2.png"
  ],
  "prompt": "生成一张电影质感的人像海报，保留参考图主体特征。",
  "seed": 11223344,
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "payload": "",
  "credits": "12.000000",
  "created_at": "2026-04-16T09:40:00Z"
}

错误码

完整列表请参考客户端 API 错误码。