Vidu 参考生视频 viduq4-preview

curl --request POST \
  --url https://api.powertokens.ai/vidu/ent/v2/reference2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
  ],
  "sounds": [
    "https://scene-aliyun.vidu.zone/media-asset/022634-H3gq7ivRZgfAYKs3.mp3"
  ],
  "prompt": "在参考图1的场景中，参考图2使用参考音频1，对参考图3说：\"你在干什么？\"，参考图3激动地说：\"q4大卖！！！\"",
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "3:4",
  "resolution": "1080p"
}
'

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
  ],
  "sounds": [
    "https://scene-aliyun.vidu.zone/media-asset/022634-H3gq7ivRZgfAYKs3.mp3"
  ],
  "prompt": "在参考图1的场景中，参考图2使用参考音频1，对参考图3说：\"你在干什么？\"，参考图3激动地说：\"q4大卖！！！\"",
  "duration": 5,
  "seed": 123456789,
  "resolution": "1080p",
  "payload": "",
  "credits": 10,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

{
  "code": "bad_request_body",
  "message": "请求体格式错误或字段取值非法",
  "data": null
}

{
  "code": "access_denied",
  "message": "无效的令牌",
  "data": null
}

{
  "code": "insufficient_user_quota",
  "message": "当前账户额度不足，请稍后重试",
  "data": null
}

{
  "code": "internal_server_error",
  "message": "服务器内部错误，请稍后重试",
  "data": null
}

POST

vidu

ent

reference2video

curl --request POST \
  --url https://api.powertokens.ai/vidu/ent/v2/reference2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
  ],
  "sounds": [
    "https://scene-aliyun.vidu.zone/media-asset/022634-H3gq7ivRZgfAYKs3.mp3"
  ],
  "prompt": "在参考图1的场景中，参考图2使用参考音频1，对参考图3说：\"你在干什么？\"，参考图3激动地说：\"q4大卖！！！\"",
  "duration": 5,
  "seed": 0,
  "aspect_ratio": "3:4",
  "resolution": "1080p"
}
'

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"
  ],
  "sounds": [
    "https://scene-aliyun.vidu.zone/media-asset/022634-H3gq7ivRZgfAYKs3.mp3"
  ],
  "prompt": "在参考图1的场景中，参考图2使用参考音频1，对参考图3说：\"你在干什么？\"，参考图3激动地说：\"q4大卖！！！\"",
  "duration": 5,
  "seed": 123456789,
  "resolution": "1080p",
  "payload": "",
  "credits": 10,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

{
  "code": "bad_request_body",
  "message": "请求体格式错误或字段取值非法",
  "data": null
}

{
  "code": "access_denied",
  "message": "无效的令牌",
  "data": null
}

{
  "code": "insufficient_user_quota",
  "message": "当前账户额度不足，请稍后重试",
  "data": null
}

{
  "code": "internal_server_error",
  "message": "服务器内部错误，请稍后重试",
  "data": null
}

授权

Authorization

string

header

必填

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

请求体

application/json

model

enum<string>

必填

模型名称，可选值：viduq4-preview

viduq4-preview：Vidu最新旗舰模型（预览版），支持参考 1 - 15 张图片，支持参考 0-3 个音频

可用选项:

viduq4-preview

images

string[]

必填

支持多张图片，模型将以此参数中传入的图片中的主题为参考生成具备主体一致的视频，具体要求如下：注1：viduq4-preview 模型支持上传 1～15 张图片；注2：支持传入图片 Base64 编码或图片URL（确保可访问）；注3：图片支持 png、jpeg、jpg、webp格式，图片最大50MB；注4：http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}

Required array length: 1 - 15 elements

prompt

string

必填

文本提示词生成视频的文本描述。注：字符长度不能超过 20000 个字符

Maximum string length: 20000

sounds

string[]

支持上传 0～3 个音频，模型将以此参数中传入的音频作为参考，生成具备主体一致的视频。注1：每个参考音频的时长范围 3-12s；注2：音频支持 mp3格式；注3：每个音频文件大小不超过50M；注4：http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： data:video/mp3;base64,{base64_encode}

Maximum array length: 3

audio

boolean

默认值:true

是否使用音视频直出能力

false：不需要音视频直出，输出静音视频
true：需要音画同步，输出声音的视频（包括台词和音效）注：viduq4-preview 模型默认audio为true

duration

integer

默认值:5

视频时长参数默认值: 5 枚举值: 3 - 16

必填范围: 3 <= x <= 16

seed

integer

随机种子当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子

aspect_ratio

enum<string>

默认值:16:9

视频比例参数默认值: 16:9 枚举值: 1:1 / 9:16 / 16:9 / 3:4 / 4:3

可用选项:

16:9,

9:16,

1:1,

3:4,

4:3

resolution

enum<string>

视频分辨率参数默认值: 720p 枚举值: 540p / 720p / 1080p / 2K / 4K 注：viduq4-preview 支持 2K、4K 规格视频输出

可用选项:

540p,

720p,

1080p,

2K,

4K

payload

string

透传参数不做任何处理，仅数据传输注：最多 1048576个字符

Maximum string length: 1048576

watermark

boolean

默认值:false

是否添加水印

true：添加水印
false：不添加水印注：目前水印内容为固定，内容由AI生成，默认不加

wm_position

enum<integer>

默认值:3

水印位置，表示水印出现在图片的位置，可选项为： 1：左上角 2：右上角 3：右下角 4：左下角默认值: 3

可用选项:

1,

2,

3,

4

必填范围: 1 <= x <= 4

wm_url

string

水印内容，此处为图片URL不传时，使用默认水印：内容由AI生成

meta_data

string

元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式，示例如下： { "Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2" } 该参数为空时，默认使用vidu生成的元数据标识

callback_url

string

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

processing 任务处理中
success 任务完成（如发送失败，回调三次）
failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：https://platform.vidu.cn/docs/callback-signature

响应

提交成功，返回视频任务对象。

task_id

string

Vidu 生成的任务ID

state

enum<string>

处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败

可用选项:

created,

queueing,

processing,

success,

failed

model

string

本次调用的模型名称

prompt

string

本次调用的提示词参数

images

string[]

本次调用的图像参数

sounds

string[]

本次调用的声音参数

duration

integer

本次调用的视频时长参数

seed

integer

本次调用的随机种子参数

resolution

string

本次调用的分辨率参数

payload

string

本次调用时传入的透传参数

credits

integer

本次调用使用的积分数

watermark

boolean

本次提交任务是否使用水印

created_at

string<date-time>

任务创建时间

聊天模型

图像模型

视频模型

音频模型

资产库

Vidu 参考生视频 viduq4-preview

授权

请求体

响应