创建任务
POST
/ent/v1/explain-comic/tasks一键解决方案
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}script_namestring*剧集名称，不要超过20个字符
script_contentstring*无字数限制，剧本内容1200字中文以上，或者3000字英文以上，会自动拆分多个任务注1: 字符和最终时长大致的映射关系是400字左右/分钟，会有范围波动
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*idstring*任务id，由创建任务接口创建成功返回
assetsarray<object>资产列表，为确保一致性强烈推荐使用
idstring*数字，01、02、03等以此类推注1：支持上传14个以内的资产，推荐3-10个
typestring*资产类型，只支持：character、scene、tool注：角色、场景、道具
namestring*资产名称，不超过30个字符
image_uristring参考图像，一个资产只能对应一个图片注1：支持传入图片 Base64 编码或图片URL（确保可访问）注2：图片支持 png、jpeg、jpg、webp格式注3：图片像素不能小于 128*128，尽量不超过2k，且比例需要小于1:4或者4:1注4：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，base64,{base64_encode}注5：注意该字段名为image_uri，而非image_url，书写错误会导致资产图传参失败normal
data:image/pngresolutionstring清晰度，默认720p可选值：720p、1080p，
aspect_ratiostring输出比例，默认9:16可选值：16:9，9:16，4:3，3:4
stylestring视频风格，可以输入类似3d建模风格、2d动画风格等等，限制30个字符。**不可以有标点符号。**默认真人写实
languagestring语言，支持中文（zh）、英文（en）默认zh
tts_speednumbertts语速，支持1-1.5默认1.1推荐倍速1.3（400左右/min）
enable_lipsyncboolean是否对口型默认true（对口型），选false的话就没有口型。无对口型一致性更好，有对口型对话更自然
callback_urlstringCallback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调返回的"status"包括以下状态：- processing 任务处理中- success 任务完成（如发送失败，回调三次）- failed 任务失败（如发送失败，回调三次）Vidu采用回调签名算法进行认证，详情见：回调签名算法
comic_bgmstring背景音乐支持url，时长以视频为准，短于视频将重复播放，长于视频讲直接截断
add_subtitleboolean是否给视频加字幕true，false，默认false无字幕
subtitle_typestringsource_han_serif （思源宋体）source_han_sans （思源黑体）
qualitystringhigh/standard默认standard
descriptionstring对资产的描述。身份、形象、年龄之类的信息
voice_idstring音色id，**只有角色需要这个参数里面有内容，场景和道具可以空着（"voice_id":""）**中国-成女旁白推荐：Chinese_Female_Currency中国-成男旁白推荐：Chinese_Male_Currency注1:其他的音色：- Chinese_Male_Currency （全语言通用-男） - Chinese_Female_Currency （全语言通用-女） - Chinese_gravelly_storyteller_vv2 (中国-中年男) - Chinese (Mandarin)_Reliable_Executive (沉稳高管: 企业家、领导) - Chinese (Mandarin)_News_Anchor (新闻女声: 播报员、主持人) - Chinese (Mandarin)_Unrestrained_Young_Man (不羁青年: 自由角色) - Arrogant_Miss (嚣张小姐: 富家女、反派) - Robot_Armor (机械战甲: 机器人、AI) - Chinese (Mandarin)_Kind-hearted_Antie (有钱的中年女) - Chinese (Mandarin)_Humorous_Elder (中国-老年男) - Chinese (Mandarin)_Male_Announcer (播报男声: 解说员) - Chinese (Mandarin)_Wise_Women (阅历姐姐: 睿智女性) - Chinese (Mandarin)_Gentle_Youth (温润青年: 文艺青年) - Chinese (Mandarin)_Warm_Girl (温暖少女: 温暖角色) - Chinese (Mandarin)_Kind-hearted_Elder (老年女) - Chinese (Mandarin)_Cute_Spirit (通用-小男孩) - Chinese (Mandarin)_Radio_Host (电台男主播: 主持人) - Chinese (Mandarin)_Sincere_Adult (真诚青年: 正直角色) - Chinese (Mandarin)_Gentle_Senior (温柔学姐: 温柔学姐) 可前往新音色列表试听注2:若音色列表中没有想要的音色，可以前往声音复刻 | Vidu API 复刻需要的音色，存储好音色id，在本字段中上传id注3:旁白音色需要通过创建旁白角色控制，旁白角色的图片传什么都可以。
application/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payload本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstringapplication/json返回参数
idstring本次任务vidu生成的任务id
带水印的生成物url，24小时有效期
curl --request POST \
--url 'https://api.vidu.cn/ent/v1/explain-comic/tasks' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"script_name": "青云问道",
"script_content": "（旁白）：我叫林枫，是青云宗的一名普通弟子，身上这件青色长袍，是宗门赐下的信物，也是我修行路上的见证。此刻，我正站在云雾缭绕的青云大殿中，殿宇宏伟，仙气氤氲，手中紧握着斩妖剑，忽然听见殿外传来熟悉的声音。\\n（玄真道长）：“林枫，你又在此处练心？”\\n（旁白）：转头望去，正是师父玄真道长。我连忙拱手行礼。\\n（林枫）：“师父，弟子在此沉淀心性，不负您的教诲。”\\n（旁白）：师父缓步走近，目光落在我手中的斩妖剑上，轻声道。\\n（玄真道长）：：“此剑通体发光、符文暗藏，乃宗门至宝，你需谨记，剑心即人心，不可有半分懈怠。”\\n（旁白）：我重重点头，握紧剑柄，感受着剑身传来的温润灵力：\\n（林枫）“弟子明白，此剑承载着宗门期许，也藏着我斩妖除魔、守护苍生的初心，定不辱命。”\\n（旁白）：师父微微颔首，眼中满是赞许。\\n（旁白）：我抬头望向殿外的云海，眼神愈发坚定。入门三年，我日夜勤修不辍，褪去了最初的懵懂，多了几分沉稳。青云大殿的寂静，不是孤寂，而是我沉淀心性、锤炼剑技的道场。握紧斩妖剑，我知道，前路虽有荆棘，虽有妖邪挡道，但我终将以剑为刃，以心为盾，不负青云宗弟子之名，不负手中古剑之托。",
"assets": [
{
"id": "01",
"type": "character",
"name": "林枫",
"image_uri": "data:image/png",
"description": "青云宗弟子，身穿青色长袍，眼神坚定。",
"voice_id": ""
}
],
"resolution": "1080p",
"aspect_ratio": "9:16",
"style": "2D动画",
"language": "zh",
"tts_speed": 1.1,
"enable_lipsync": true,
"callback_url": "string",
"comic_bgm": "string",
"add_subtitle": true,
"subtitle_type": "string",
"quality": "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"
}
]
}