创建任务 1.0
POST
/ent/v2/one-click/mv一键解决方案
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}imagesstring*用户生成mv时的模特图片或风格图片
注1：支持传入图片 Base64 编码或图片URL（确保可访问）；
注2：支持输入 1~7 张图；
注3：图片支持 png、jpeg、jpg、webp格式；
注4：图片比例需要小于 1:4 或者 4:1 ；
注5：图片大小不超过 50 MB；
注6：请注意，base64 decode之后的字节长度需要小于10M，且编码必须包含适当的内容类型字符串，base64,{base64_encode}normal
data:image/pngaudio_urlstring*需要生成mv的音频注1：支持传入 Base64 编码或音频URL（确保可访问）；注2：支持输入 1 个音频；注3：支持 mp3、wav、aac、m4a格式；注4：一次输出合成完的视频+分镜列表，上传音频最少10秒，最多300秒；注6：base64 decode之后的字节长度需要小于20M，且编码必须包含适当的内容类型字符串，base64,{base64_encode}normal
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*路径参数，任务的唯一标识（ID）。
{your_id}idstring*任务id，由创建任务接口创建成功返回
lip_ref_urls 为必传。⚠ lip_ref_urls 必传,最多 2 张,顺序 = 歌曲中谁先开口。
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}premium_mv_modestring*任务类型
sing （全程对口型）sing_perform（对口型和演绎出穿插）perform(演绎) dance(跳舞)Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*路径参数，任务的唯一标识（ID）。
{your_id}idstring*任务id，由创建任务接口创建成功返回
data:image/pnglip_syncbooleantrue：需要对口型
false：不需要对口型
默认false
开启之后，每秒增加4积分
注1：不支持非真人；
注2：不支持视频中非正面的片段；
注3: 只guan支持中景，视频开头正面对镜头的场景
注4: 不支持超过三分钟的任务，不会多扣积分
注5:当开启对口型，推荐720p和1080p，不支持540p
lip_ref_urlstringurl，唱歌的人脸，需要正面对镜头，近景
图像文件要求： - 内容：需包含一张清晰的人物正脸，且为视频中出现的人物 - 文件大小：文件≤10MB - 图像大小：长宽比小于等于2，最大边长小于等4096 - 格式：jpeg、jpg、png、bmp、webp
使用该参数，对口型成功率会大幅度上升
https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.pngstylestring直接输入风格文本：弥散风格、二次元风格等等
qualitystringhigh/standardhigh → MIX 链路。standard → Q2 参考生链路。（默认）
promptstring用户提示词
生成mv视频的文本描述。
注1：字符长度不能超过 3000 个字符
aspect_ratiostring输出比例，默认16:9
可选值 1:1，16:9，9:16，4:3，3:4
16:9resolutionstring清晰度，默认720p
可选值：540p、720p、1080p
add_subtitleboolean是否需要字幕，默认为 false
true：需要字幕
false：不需要字幕
subtitle_colorstring默认 #FFFFFF，白色
HEX格式字色
languagestring音频语言类型，默认为自动
可选 en、zh
srt_urlstring字幕文件url
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
lip_ref_urlsstring对口型人物参考图
必填说明：当premium_mv_mode取sing /sing_perform时为必传当premium_mv_mode取值为perform&dance时，无需传入该参数，传入视为无效。
最多 2 张,按歌曲开口先后排序;正面近景人脸;jpeg/jpg/png/bmp/webpimagesstring参考图
必填说明：当premium_mv_mode取sing /sing_perform时为可选当premium_mv_mode取值为perform&dance时，为必传
6张;URL 或 base64;png/jpeg/jpg/webp;比例 1:44:1;≤50MBaudio_urlstring*音频，音频必须包含歌词，不支持上传纯音乐
URL 或 base64;mp3/wav/aac/m4a;10~300 秒languagestring音频语言类型，默认为自动可选 en、zh、ja、ko、vi、th、id、ms、tl、hi、ar、fr、de、es、pt、ru、it、nl、sv、da、fi、no、el、pl、cs、hu、ro、bg、hr、sk、arstylestring如"弥散风格""二次元风格"
风格文本promptstring提示词
≤3000 字符aspect_ratiostring输出比例,默认 16:9
1:1 / 16:9 / 9:16 / 4:3 / 3:4resolutionstring清晰度,默认 720p
720p /1080padd_subtitleboolean是否烧字幕,默认 false
true / falsesubtitle_colorstring字幕颜色,默认白色
HEX，如#FFFFFFcallback_urlstring状态变化回调
URLapplication/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadapplication/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadapplication/json返回参数
idstring本次任务vidu生成的任务id
application/json返回参数
idstring本次任务vidu生成的任务id
本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstring本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstring带水印的生成物url，24小时有效期
带水印的生成物url，24小时有效期
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/mv' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"images": "data:image/png",
"audio_url": "data:image/png",
"lip_sync": true,
"lip_ref_url": "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png",
"style": "string",
"quality": "string",
"prompt": "",
"aspect_ratio": "16:9",
"resolution": "string",
"add_subtitle": true,
"subtitle_color": "string",
"language": "string",
"srt_url": "string",
"callback_url": "string"
}'{
"id": "your_id_here"
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json'{
"id":"your_task_id",
"state": "success",
"err_code": "",
"credits": 4,
"payload": "",
"creations": [
{
"id": "your_creations_id",
"url": "your_generated_results_url",
"cover_url": "your_generated_results_cover_url",
"watermarked_url": "your_generated_results_watermarked_url"
}
]
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/premium_mv' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"premium_mv_mode": "sing （全程对口型）sing_perform（对口型和演绎出穿插）perform(演绎) dance(跳舞)",
"lip_ref_urls": "最多 2 张,按歌曲开口先后排序;正面近景人脸;jpeg/jpg/png/bmp/webp",
"images": "6张;URL 或 base64;png/jpeg/jpg/webp;比例 1:44:1;≤50MB",
"audio_url": "URL 或 base64;mp3/wav/aac/m4a;10~300 秒",
"language": "音频语言类型，默认为自动可选 en、zh、ja、ko、vi、th、id、ms、tl、hi、ar、fr、de、es、pt、ru、it、nl、sv、da、fi、no、el、pl、cs、hu、ro、bg、hr、sk、ar",
"style": "风格文本",
"prompt": "≤3000 字符",
"aspect_ratio": "1:1 / 16:9 / 9:16 / 4:3 / 3:4",
"resolution": "720p /1080p",
"add_subtitle": "true / false",
"subtitle_color": "HEX，如#FFFFFF",
"callback_url": "URL"
}'{
"id": "your_id_here"
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json'{
"id":"your_task_id",
"state": "success",
"err_code": "",
"credits": 4,
"payload": "",
"creations": [
{
"id": "your_creations_id",
"url": "your_generated_results_url",
"cover_url": "your_generated_results_cover_url",
"watermarked_url": "your_generated_results_watermarked_url"
}
]
}