跳转到主要内容
POST
/
vidu
/
ent
/
v2
/
reference2image
curl --request POST \
  --url https://api.powertokens.ai/vidu/ent/v2/reference2image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq2",
  "prompt": "一只可爱的小猫在草地上玩耍，阳光明媚",
  "aspect_ratio": "16:9",
  "resolution": "4K",
  "seed": 42
}
'
{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq2",
  "images": [
    "your_image_url1",
    "your_image_url2",
    "your_image_url3"
  ],
  "prompt": "your_prompt",
  "seed": 0,
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "payload": "",
  "credits": 2,
  "created_at": "2025-09-08T09:53:22.083033428Z"
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json
​
model
enum<string>
必填

模型名称

  • viduq2: 支持文生图、图片编辑、参考生图
可用选项:
viduq2
​
prompt
string
必填

文本提示词，用于描述图片生成内容，最大长度 2000 字符。 注意：viduq2 支持仅使用 prompt 生成图片（无需提供参考图片）。

Maximum string length: 2000
​
images
string[]

图像参考

  • viduq2: 支持输入 0～7 张图片 模型将以此参数中传入的图片中的主题为参考，生成与图片中主体一致的视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问） 注2：图片支持 png、jpeg、jpg、webp格式 注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1 注4: 且大小不超过50M 注5：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}
Maximum array length: 7
​
seed
integer

随机种子。

  • 默认为随机种子数
  • 手动设置值将覆盖默认随机种子
​
aspect_ratio
enum<string>
默认值:16:9

图片宽高比。

  • viduq2: 默认 16:9，可选值：16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2
  • auto: 生成的图片宽高比与第一张输入图片保持一致
可用选项:
16:9,
9:16,
1:1,
3:4,
4:3,
21:9,
2:3,
3:2,
auto
​
resolution
enum<string>
默认值:1080p

图片分辨率。

  • viduq2: 默认 1080p，可选值：1080p, 2K, 4K
可用选项:
1080p,
2K,
4K
​
payload
string

透传参数。 不做处理，仅做数据透传，最大长度 1048576 字符。

Maximum string length: 1048576
​
callback_url
string

Callback 协议 需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的"status"包括以下状态：

  • processing 任务处理中
  • success 任务完成（如发送失败，回调三次）
  • failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

响应

提交成功，返回图片任务对象。

​
task_id
string

任务ID。

​
state
enum<string>

任务处理状态：

  • created: 任务创建成功
  • queueing: 任务排队中
  • processing: 任务处理中
  • success: 生成成功
  • failed: 任务失败
可用选项:
created,
queueing,
processing,
success,
failed
​
model
string

本次调用使用的模型参数。

​
prompt
string

本次调用使用的文本提示词。

​
images
string[]

本次调用使用的图片。

​
seed
integer

本次调用使用的随机种子参数。

​
aspect_ratio
string

本次调用使用的宽高比参数。

​
resolution
string

本次调用使用的分辨率参数。

​
credits
integer

本次调用消耗的积分。

​
callback_url
string

本次调用使用的回调URL参数。

​
payload
string

本次调用使用的透传参数。

​
created_at
string<date-time>

任务创建时间。