数据结构

CallbackConfig

事件回调设置

名称	类型	说明
callbackUrl	string	HTTP 回调地址
enableSign	boolean	是否开启签名
signKey	string	签名 key
enableMediaUploadCompleteEvent	boolean	是否开启媒资上传完成事件通知
enableMediaFetchCompleteEvent	boolean	是否开启媒资拉取完成事件通知
enableMediaTranscodeCompleteEvent	boolean	是否开启媒资转码完成事件通知
enableMediaThumbnailCompleteEvent	boolean	是否开启媒资截图完成事件通知
enableMediaAnalysisCompleteEvent	boolean	是否开启媒资分析完成事件通知
enableMediaRegulationCompleteEvent	boolean	是否开启媒资审核完成事件通知
enableComposeTaskStatusChangeEvent	boolean	是否开启视频云剪辑任务状态变更事件通知
enableMediaRestoreCompleteEvent	boolean	是否开启媒资取回完成事件通知
enableVideoGenerateCompleteEvent	boolean	是否开启视频生成完成事件通知

CallbackEvent

事件回调消息

名称	类型	说明
eventId	string	事件 ID
eventType	string	事件类型
eventTime	string	事件时间戳
mediaUploadCompleteEvent	MediaUploadCompleteEvent	媒资上传完成回调事件内容
mediaFetchCompleteEvent	MediaFetchCompleteEvent	媒资拉取完成回调事件内容
mediaTranscodeCompleteEvent	MediaTranscodeCompleteEvent	媒资转码完成回调事件内容
mediaThumbnailCompleteEvent	MediaThumbnailCompleteEvent	媒资截图完成回调事件内容
mediaAnalysisCompleteEvent	MediaAnalysisCompleteEvent	媒资分析完成回调事件内容
mediaRegulationCompleteEvent	MediaRegulationCompleteEvent	媒资审核完成回调事件内容
composeTaskStatusChangeEvent	ComposeTaskStatusChangeEvent	视频云剪辑任务状态变更回调事件内容
videoGenerateCompleteEvent	VideoGenerateCompleteEvent	视频生成完成回调事件内容

ComposeOutput

字段	类型	必要性	默认值	说明
fileName	string	是		导出视频保存到媒资库的文件名
videoCodec	string（枚举）		h264	导出视频编码，取值：h264, h265
audioCodec	string（枚举）		aac	导出音频编码，取值：aac, mp3
width	int		1920	导出分辨率宽度
height	int		1080	导出分辨率高度
frameRate	float		30	导出帧率
audioSampleRateInHz	int		44100	导出音频采样率。各编码支持的采样率： mp3: 44100, 48000, 32000, 22050, 24000, 16000, 11025, 12000, 8000. aac: 96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000, 7350.
audioChannels	int		2	导出音频声道数，取值范围 [1,7]
compressionType	string（枚举）		mid	导出视频压缩质量，取值：high（高）, mid（中）, low（低）
gop	int		125	导出视频 i 帧最大间隔

注意：导出配置将影响任务处理耗时，例如较高的分辨率、帧率、质量等都将增加任务耗时，请合理配置。

ComposeTaskInfo

视频云剪辑任务信息

名称	类型	说明
errMsg	string	错误信息
output	ComposeTaskOutput	视频云剪辑任务输出参数

ComposeTaskOutput

视频云剪辑任务输出信息

名称	类型	说明
mediaId	string	视频云剪辑视频导入媒资库的媒资 ID
url	string	视频云剪辑视频播放地址

ComposeTaskStatusChangeEvent

视频云剪辑任务状态变更回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间，例如 2024-10-11T13:48:01Z
finishTime	string	任务完成时间
beginProcessTime	string	任务开始时间
composeTaskInfo	ComposeTaskInfo	视频云剪辑任务信息

ComposeTimeline

字段	类型	必要性	轨道数范围	素材结点总数范围	说明
audioTracks	ComposeTimelineAudioTrack[]		[0,10]	[0,1000]	音频多轨道
videoTracks	ComposeTimelineVideoTrack[]	是	[1,10]	[1,1000]	视频多轨道（包括视频、图片）
subtitleTracks	ComposeTimelineSubtitleTrack[]		[0,10]	[0,1000]	字幕多轨道

ComposeTimelineAudioItem

字段	类型	必要性	默认值	说明
mediaId	string	与 sourceUrl 二选一		媒资库的媒资 id
sourceUrl	string			文件链接。当 mediaId 为空时必须提供 sourceUrl，发起任务后将自动保存到 VOD 媒资库
start	float	是		视频片段取自素材文件的起始时间，单位为秒，支持 3 位小数，默认为 0。
duration	float	是		视频片段时长，单位为秒。默认取视频素材本身长度，表示截取全部素材。必须大于 0
showStart	float	是		截取片段在作品中的播放起点，单位秒
showDuration	float	是		截取片段在作品中的播放时长，单位秒。必须大于 0
durationPaddingType	string（枚举）		loop	当 duration < showDuration 时，不足部分的填充方式。 loop：循环播放截取的片段 last_frame：静止播放截取片段的最后一帧
audioOperations	ComposeTimelineAudioOperation[]			对截取的音频片段进行的操作，如音量调节等。列表元素最多 1 个。

注意事项

• 优先使用mediaId而不是sourceUrl，因为提供sourceUrl会在处理之前先将其存储到媒资库，有一定的时间消耗。

ComposeTimelineAudioOperation

字段	类型	必要性	默认值	说明
volume	float		1.0	音量调节倍数，0 表示静音，取值范围 [0, 16]
speed	float		1.0	播放倍速，仅音频节点生效，取值范围 [0.01, 16]

ComposeTimelineAudioTrack

字段	类型	必要性	说明
audioItems	ComposeTimelineAudioItem[]	是	素材结点列表（音频文件）

ComposeTimelineImageOperation

字段	类型	必要性	默认值	说明
speed	float		1.0	播放倍速，精确到小数点后 2 位，取值范围为 [0.01,16]
crop	object			裁剪区域
[+] xpos	float		0	裁剪区域的左上角横坐标比例，取值范围为 [0.0~1.0]
[+] ypos	float		0	裁剪区域的左上角纵坐标比例，取值范围为 [0.0~1.0]
[+] width	float		1	裁剪区域的宽度比例，取值范围为 [0.0~1.0]。要求 xpos + width <= 1.0
[+] height	float		1	裁剪区域的高度比例，取值范围为 [0.0~1.0]。要求 ypos + height <= 1.0
rotate	int		0	顺时针旋转角度，取值 [0,359]
mirror	string（枚举）			镜像效果，取值：hori（左右镜像），vert（上下镜像），full（旋转 180 度）
posMovement	object			运动效果
[+] viewBox	string（枚举）		fixed	画布上用于展示运动效果的区域。取值： fixed：素材运动效果的展示区域固定在 VideoItem.{xpos, ypos, width, height}（默认全屏），输入视频会提前放大到适当比例再运动，保证运动过程中视频边缘不进入该区域。
[+] type	string（枚举）			运动方式。取值：left （向左）, right （向右）, up （向上）, down （向下）, leftUp （向左上）, leftDown （向左下）, rightUp （向右上）, rightDown （向右下）, zoomIn （放大）, zoomOut （缩小）
[+] speed	float		0	运动速度，单位“比例/秒”（每秒相对于输入画面的变化比例）。例如 speed=0.1，则 x 方向每秒可变化 0.1*VideoItem.width，y 方向每秒可变化 0.1*VideoItem.height。

注意事项

• 由于裁剪、旋转、镜像等操作的顺序不同则效果不同，请放置到列表VideoItem.imageOperations不同元素内以确保执行顺序；
• 在同一个 ImageOperation 内若共存以下多个字段，将按该参数表中的顺序执行。

ComposeTimelineSubtitleItem

字段	类型	必要性	默认值	说明
showStart	float	是		在作品中的播放起点，单位秒
showDuration	float	是		在作品中的播放时长，单位秒。必须大于 0
xpos	float		0.5	放置到作品中的水平横坐标
ypos	float		0.9	放置到作品中的竖直纵坐标。xpos, ypos 是字幕锚点的坐标
text	string	是		文本内容。仅支持可见文字及其标点符号（不支持 emoji 表情、特殊字符等），如需换行请使用 Unix 换行符 \n。不能超过 600 个 UTF-8 字符数。注意字数过多或字体过大可能会导致文字超出屏幕而不可见。
textAlign	string（枚举）		center	文本对齐方式，即字幕锚点，取值：left, center, right, bottomLeft, bottomCenter, bottomRight, topLeft, topCenter, topRight
fontFamily	string（枚举）		方正黑体简体	字体名称。取值：方正黑体简体, 楷体, 思源宋体 CN, Noto Sans SC Black, Noto Sans SC SemiBold, Noto Sans SC Medium, Noto Sans SC Thin；全部字体名称列表及示例请参考文末附录
fontSize	int		40	字体大小，即字体高度的像素点数。无大小限制，注意过大会超出屏幕范围，过小会难以看到。
fontSpacing	int		0	字间距，单位为像素。无大小限制，注意过大会超出屏幕范围，过小会难以看到。
fontBold	bool		false	字体是否加粗
fontItalic	bool		false	斜体
fontUnderline	bool		false	下划线
fontStrikeOut	bool		false	删除线
fontColor	string		#FFFFFF	文字颜色，默认白色。取值范围 #000000, #FFFFFF
fontAlpha	float		0	文字透明度，取值 [0.0,1.0]，默认不透明
fontOutlineColor	string		#000000	字体描边颜色，默认黑色。取值范围 #000000, #FFFFFF
fontOutlineAlpha	float		0	字体描边透明度，取值范围 [0.9,1.0]，默认不透明
fontOutlineWidth	int		2	每个字的描边厚度，单位为像素。取值最小为 0，注意值过大会导致文字难以观看。

ComposeTimelineSubtitleTrack

字段	类型	必要性	说明
subtitleItems	ComposeTimelineSubtitleItem[]	是	素材结点列表

ComposeTimelineVideoItem

字段	类型	必要性	默认值	说明
mediaId	string	与 sourceUrl 二选一		媒资库的媒资 id
sourceUrl	string			文件链接。当 mediaId 为空时必须提供 sourceUrl，发起任务后将自动保存到 VOD 媒资库
type	string（枚举）	是	video	素材类型，取值：video, image, mosaic。注意 gif 动图请填 video 类型。
start	float	type=video 时必需	0	视频片段取自素材文件的起始时间，单位为秒
duration	float	type=video 时必需		视频片段时长，单位为秒。默认取视频素材本身长度，表示截取全部素材。必须大于 0
showStart	float	是	0	截取片段在作品中的播放起点，单位秒
showDuration	float	是		截取片段在作品中的播放时长，单位秒。必须大于 0
durationPaddingType	string（枚举）		loop	当 duration < showDuration 时，不足部分的填充方式。 loop：循环播放截取的片段 last_frame：静止播放截取片段的最后一帧
audioOperations	ComposeTimelineAudioOperation[]			对输入音频的操作。列表元素最多 1 个。
imageOperations	ComposeTimelineImageOperation[]			对输入图像的操作（包括视频、图片、马赛克）。列表元素最多 5 个，且裁剪/旋转/镜像三种不允许放在同一个元素内。
position	string（枚举）		custom	处理后的画面放置到作品中的位置，取值： custom自定义xpos,ypos,width,height; fill保持宽高比不变，缩放至填充满整个屏幕，并居中，多余部分裁剪掉； fit保持宽高比不变，完整显示整个图像，缩放至最大并居中，可能会留下黑边； stretch自动拉伸宽高与屏幕重合，注意图像可能会变形； center保持原图像尺寸不变，居中
xpos	float		0.0	素材放置到作品中的水平横坐标，允许超出屏幕范围，超出部分在屏幕外自然不可见
ypos	float		0.0	素材放置到作品中的竖直纵坐标
width	float		1.0	素材放置到作品中的宽度，取值大于 0。允许超出屏幕范围
height	float		1.0	素材放置到作品中的高度，取值大于 0。允许超出屏幕范围

温馨提示

• ComposeTimelineVideoItem.{xpos,ypos,width,height}表示素材经过imageOperations 一系列操作之后得到的结果放置到作品中的位置，允许超出作品画面范围，超出部分在屏幕外自然不可见。
• ComposeTimlineImageOperation.crop.{xpos,ypos,width,height}表示对输入画面进行裁剪之后所保留的区域，裁剪区域不能超出输入画面范围。

ComposeTimelineVideoTrack

字段	类型	必要性	说明
videoItems	ComposeTimelineVideoItem[]	是	素材结点列表（视频文件或图片）

EffectBeastCompanionInput

与兽为伍 特效特定输入参数

参数	类型	描述
beast	string	伴侣类型，非必填，默认：auto，包括： auto：随机一种 bear：熊首男友 tiger：虎首男友 elk：鹿首男友 snake：蛇首男友 lion：狮首男友 wolf：狼首男友

EffectExoticPrincessInput

异域公主 特效特定输入参数

参数	类型	描述
area	string	伴侣类型，非必填，默认：auto，包括： auto：随机一种 denmark：丹麦公主 uk：英国公主 africa：非洲公主 china：中国公主 mexico：墨西哥公主 switzerland：瑞士公主 russia：俄罗斯公主 italy：意大利公主 korea：韩国公主 thailand：泰国公主 india：印度公主 japan：日本公主

EffectHairSwapInput

AI 换发特效特定输入参数

参数	类型	描述
hairColor	string	头发颜色，非必填，默认：Original Hair Color，包括： Original Hair Color：原发色 Raspberry Purple：树莓紫 Milk Tea Goldr：奶茶金 Dirty Orange：脏橘色 Sweet Cherry Pink：甜樱粉 Linen Brown：亚麻棕 Hatsune Color：初音色

EffectVideoPTaskInput

特效视频 P 任务输入参数

参数	类型	描述
effect	string	特效类型，包括： we_are_venom: 我们是毒液 warmth_of_jesus: 温暖耶稣 hug_your_love: 拥抱爱人 muscle_surge: 肌肉激增 the_tigers_touch: 虎之触 kiss_kiss: 亲亲 leggy_run: 长腿奔跑 alive_art: 活灵活现的艺术 squish_it: 挤压它 hulk: 绿巨人 black_myth_wukong: 黑神话悟空 sailor_moon: 美少女战士 sheep_curls: 羊毛卷 long_hair_magic: 长发魔法 crazy_cat_woman: 疯狂猫女 wonder_woman: 神奇女侠 jokers_rebirth: 小丑重生 batman: 蝙蝠侠 colorful_venom: 多彩毒液 iron_man: 钢铁侠 chinese_new_year_dress: 春节服装 chinese_god_of_wealth: 财神 hot_harley_quinn: 火辣哈莉奎因 who_is_venom: 谁是毒液 get_a_venom_buddy: 获得毒液伙伴 wicked_shots: 邪恶镜头 lego_blast: 乐高爆炸 monster_invades: 怪物入侵 anything_robot：万物皆可变形金刚 baby_face：秒变娃娃脸 holy_wings：长出天使翅膀 red_carpet_time：万物皆可走红毯 kungfu_club：不打不相识 360_microwave：360°旋转微波炉 jellycat_everything：万物皆可毛绒玩具 kiss_me_ai：AI 发对象咯 gender_swap_tool：性别转换器 night_night：随地大小睡 huge_cutie：巨大的小可爱 carnival_queen：狂欢节女王 money_tornado：金钱风暴 subject_3_fever：科目三复兴 lets_dance：一起摇摆 suit_swagger：西装诱惑 sakura_flood：樱花乌托邦 retro_anime_pop：复古漫画热潮 emergency_beat：紧急热舞 mega_dive：超级跳水秀 mint_in_box：玩具收藏家 ghibli_live：日式动漫风 ghibli_magic：吉卜力魔法 vroom_step：摩托舞者 jiggle_jiggle：jiggle jiggle 跳舞 born_to_barbie：天生芭比 cry_me_a_river：泪流成河 clay_fool：黏土憨憨
image	ImageToVideoImageItem	图片信息
prompt	string	提示词
negativePrompt	string	负面提示词，非比填
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频分辨率，支持： 360p 540p 720p 1080p
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk
seed	integer	随机种子，非必填

EffectVideoRequest

特效视频任务输入参数

参数	类型	描述
model	string	模型名称，包括： V P
modelVTaskInput	EffectVideoVTaskInput	特效任务 V 特定输入参数，非必填
modelPTaskInput	EffectVideoPTaskInput	特效任务 P 特定输入参数 , 非必填

EffectVideoVTaskInput

特效视频 V 任务输入参数

参数	类型	描述
effect	string	特效类型，包括： hug： 拥抱 kiss： 亲吻 christmas_santa_transformation： 变身为圣诞老人 christmas_santa_gift_delivery： 圣诞老人来送礼 christmas_toast_celebration： 圣诞节举杯庆祝 christmas_santa_hug： 圣诞老人来拥抱 expansion_deformation： 膨胀 bomb_effect_deformation： 爆炸 melt_deformation： 融化 sweet_smile_live_photo： 甜美微笑 wind_live_photo： 风动 camera_motion_live_photo： 镜头动 walk_live_photo： 走路 terror_emotion： 恐惧 smile_emotion： 微笑 laugh_emotion： 狂笑 surprise_emotion： 惊讶 old_photo_animation： 老照片动起来 hair_swap_wool_curls： 换羊毛卷发型 hair_swap_twin_tails： 换双马尾发型 hair_swap_long_hair： 换长发 interaction_heart_gesture： 比心 interaction_give_rose： 送玫瑰花 lunar_newyear_2025_fireworks： 2025 新年烟花 lunar_newyear_dual_toast： 双人举杯 lunar_newyear_red_envelope_rain： 红包雨 youth_rewind_memory： 童年回忆 dynasty_dress_swap： 古风换装 love_pose_family_heart： 全家福比心 wish_sender_heart_with_god_of_wealth： 和财神比心 wish_sender_coin_rain： 财神发金币 dreamy_wedding： 梦幻婚礼 romantic_lift： 浪漫公主抱 sweet_proposal： 甜蜜求婚 couple_flower_presentation： 情侣送花 couple_hug： 情侣拥抱 couple_kiss： 情侣接吻 couple_wave： 情侣挥手 cupid_arrow： 丘比特之箭 pet_lovers： 萌宠恋人 captain_america： 变身美队 hulk： 绿巨人 cap_walk： 美队同行 hulk_dive： 浩克俯冲 balloon_flyaway： 变成气球飞走了 cartoon_doll： 变身 Q 版玩偶 flying： 飞行 paperman： 纸片人特效 pinch： 2.0 捏捏 sakura_season： 樱花飘落 muscling： 变身肌肉男 french_kiss： 法式热吻 bloom_magic： 万物生花 golden_epoch： 流金岁月 slice_therapy： 解压切切 beast_companion： 与兽为伍 oscar_gala： 金像盛典 fashion_stride： 时尚 T 台 star_carpet： 星光红毯 flame_carpet： 烈焰红毯 frost_carpet： 风雪红毯 exotic_princess： 异域公主 bloom_doorobear： 万物生萌芽熊 live_memory： 老照片动起来 orbit： 镜头环绕 zoom_in： 镜头推进 ai_outfit： 虚拟试衣 mecha_x： 万物变身机器人 gender_swap： 性别转换 nap_me： 随地大小睡 sexy_me： 变身比基尼/肌肉男 ghibli： 吉卜力风 style_me： 西装暴徒 bodyshake： 转身热舞 spin360： 360 度转转转 spin180： 180 度转身 minecraft： 我的世界风 smooth_shift： 丝滑转场 box_me： 部落盒子 tap_me： 胶带写真 paper_fall： 瘫软在地 claw_me： 抓娃娃 saber_warrior： 星战光剑 rain_kiss： 雨中热吻 orbit_dolly： 环绕推进 orbit_dolly_fast： 快速环绕推进 couple_walk： 一起走走 sweet_dreams： 好梦相伴 flower_receive： 收花时刻 love_drop： 爱从天降 pet2human： 宠物变真人 clayshot： 粘土风拍立得 manga_meme： 漫画表情包 auto_spin： 旋转 dragonboat_shot：龙舟拍立得 graduation： 毕业盛典 soul_depart： 灵魂出窍 cheek_kiss： 亲吻脸颊 punch_hit： 吃我一拳 watermelon_hit： 吃我一瓜 pixel_me： 像素风 fishermen： 变身美人鱼 simpsons_comic： 辛普森漫画风 fairy_me： 小精灵变身 shake_it_down： 深蹲扭扭 split_stance_pet： 萌宠一字马 happy_birthday： 生日派对 irasutoya： 日式漫画风-irasutoya american_comic： 美式漫画风 carry_me： 爱的背背 zongzi_drop： 天降巨粽 walk_forward： 稳步向前
images	ImageToVideoImageItem[]	图片信息
hairSwapInput	EffectHairSwapInput	AI 换发特效特定输入参数，非必填
beastCompanionInput	EffectBeastCompanionInput	与兽为伍 特效特定输入参数，非必填
exoticPrincessInput	EffectExoticPrincessInput	异域公主 特效特定输入参数，非必填
aspectRatio	string	比例，非必填，默认 9:16，部分特效支持 9:16 16:9 1:1

ExtendVideoKTaskInput

视频延长 K 任务输入参数

参数	类型	描述
mediaId	string	媒资 id（仅支持 K10 模型，且时长不能超过 3 分钟）
prompt	string	提示词

HighlightUnderstandTaskInfo

精彩集锦视频理解任务信息

名称	类型	说明
projectId	string	集锦项目 ID
projectName	string	集锦项目名称
errMsg	string	错误信息

ImageToVideoDynamicMask

动态笔刷配置列表 可配置多组（最多 6 组），每组包含“涂抹区域 mask”与“运动轨迹 trajectories”序列

参数	类型	描述
mask	ImageToVideoHeadtailImages	动态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片）
trajectories	ImageToVideoTrajectory[]	运动轨迹坐标序列 生成 5s 的视频，轨迹长度不超过 77，即坐标个数取值范围：[2, 77] 轨迹坐标系，以图片左下角为坐标原点

ImageToVideoHeadtailImages

首尾帧图片信息

参数	类型	描述
headImage	ImageToVideoImageItem	首帧图片信息
tailImage	ImageToVideoImageItem	尾帧图片信息

ImageToVideoImageItem

图片信息

参数	类型	描述
imageUrl	string	图片链接

ImageToVideoK10TaskInput

图生视频 K10 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro
staticMask	ImageToVideoImageItem	静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片） 图片长宽比必须与输入图片相同，否则任务失败 staticMask 和 dynamicMasks.mask 这两张图片的分辨率必须一致，否则任务失败
dynamicMasks	ImageToVideoDynamicMask[]	动态笔刷配置列表，非必填，默认 std，支持： std pro

ImageToVideoK15TaskInput

图生视频 K15 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro
staticMask	ImageToVideoImageItem	静态笔刷涂抹区域（用户通过运动笔刷涂抹的 mask 图片） 图片长宽比必须与输入图片相同，否则任务失败 staticMask 和 dynamicMasks.mask 这两张图片的分辨率必须一致，否则任务失败
dynamicMasks	ImageToVideoDynamicMask[]	动态笔刷配置列表，非必填，默认 std，支持： std pro
cameraControl	VideoGenerateCameraControl[]	动态笔刷配置列表，非必填，默认 std，支持： std pro

ImageToVideoK16TaskInput

图生视频 K16 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro

ImageToVideoK20TaskInput

图生视频 K20 任务输入参数

参数	类型	描述
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10

ImageToVideoP35TaskInput

图生视频 P35 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
image	ImageToVideoImageItem	图片信息
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
prompt	string	提示词
negativePrompt	string	负面提示词，非必填
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频分辨率，支持： 360p 540p 720p 1080p
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk （首尾生不支持配置）
seed	integer	随机种子，非必填

ImageToVideoP40TaskInput

图生视频 P40 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
image	ImageToVideoImageItem	图片信息
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
prompt	string	提示词
negativePrompt	string	负面提示词，非必填
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频分辨率，支持： 360p 540p 720p 1080p
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk （首尾生不支持配置）
seed	integer	随机种子，非必填

ImageToVideoP45TaskInput

图生视频 P45 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
image	ImageToVideoImageItem	图片信息
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
prompt	string	提示词
negativePrompt	string	负面提示词，非必填
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频分辨率，支持： 360p 540p 720p 1080p
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk （首尾生不支持配置）
seed	integer	随机种子，非必填

ImageToVideoRequest

图生视频任务输入参数

参数	类型	描述
model	string	模型名称，包括： V15 V20 VQ1 P35 P40 P45 K16 K20
modelV15TaskInput	ImageToVideoV15TaskInput	V15 模型的特定输入参数
modelV20TaskInput	ImageToVideoV20TaskInput	V20 模型的特定输入参数
modelVQ1TaskInput	ImageToVideoVQ1TaskInput	VQ1 模型的特定输入参数
modelP35TaskInput	ImageToVideoP35TaskInput	P35 模型的特定输入参数
modelP40TaskInput	ImageToVideoP40TaskInput	P40 模型的特定输入参数
modelP45TaskInput	ImageToVideoP45TaskInput	P45 模型的特定输入参数
modelK16TaskInput	ImageToVideoK16TaskInput	K16 模型的特定输入参数
modelK20TaskInput	ImageToVideoK20TaskInput	K20 模型的特定输入参数

ImageToVideoTrajectory

运动轨迹坐标序列

• 生成 5s 的视频，轨迹长度不超过 77，即坐标个数取值范围：[2, 77]
• 轨迹坐标系，以图片左下角为坐标原点
• 坐标点个数越多轨迹刻画越准确，如只有 2 个轨迹点则为这两点连接的直线
• 轨迹方向以传入顺序为指向，以最先传入的坐标为轨迹起点，依次链接后续坐标形成运动轨迹

参数	类型	描述
x	integer	轨迹点横坐标（在像素二维坐标系下，以输入图片 image 左下为原点的像素坐标）
y	integer	轨迹点纵坐标（在像素二维坐标系下，以输入图片 image 左下为原点的像素坐标）

ImageToVideoV15TaskInput

图生视频 V15 任务输入参数，传参 characterImages，headtailImages，image 有且仅需有一个

参数	类型	描述
characterImages	ImageToVideoImageItem[]	参考图片信息， 参考生必填
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	生成的提示文本
duration	integer	视频时长，单位 s，支持： 4 8
resolution	string	分辨率，支持： 360p 720p 1080p 注意：8s: 仅可选 720p
seed	integer	随机种子，非必填
aspectRatio	string	比例，非必填，默认 16:9 , 支持： 16:9 9:16 1:1
movementAmplitude	string	运动幅度，非必填，默认 auto, 支持： auto small medium large

ImageToVideoV20TaskInput

图生视频 V20 任务输入参数，传参 characterImages，headtailImages，image 有且仅需有一个

参数	类型	描述
characterImages	ImageToVideoImageItem[]	参考图片信息， 参考生必填
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	生成的提示文本
duration	integer	视频时长，单位 s，支持： 4 8
resolution	string	分辨率，支持： 360p 720p 1080p 注意：8s: 仅可选 720p
seed	integer	随机种子，非必填
aspectRatio	string	比例，非必填，默认 16:9 , 支持： 16:9 9:16 1:1
movementAmplitude	string	运动幅度，非必填，默认 auto, 支持： auto small medium large

ImageToVideoVQ1TaskInput

图生视频 VQ1 任务输入参数，传参 headtailImages，image 有且仅需有一个

参数	类型	描述
headtailImages	ImageToVideoHeadtailImages	首尾帧图片信息， 首尾生必填
image	ImageToVideoImageItem	图片信息， 图生必填
prompt	string	生成的提示文本
duration	integer	视频时长，单位 s，支持： 5
resolution	string	分辨率，支持： 1080p
seed	integer	随机种子，非必填
aspectRatio	string	比例，非必填，默认 16:9 , 支持： 16:9 9:16 1:1
movementAmplitude	string	运动幅度，非必填，默认 auto, 支持： auto small medium large

MediaAnalysisCompleteEvent

媒资 AI 分析完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
beginProcessTime	string	任务开始时间
analysisTaskInfo	MediaAnalysisTaskInfo	拉取任务信息

MediaAnalysisOutputInfo

媒资 AI 分析结果信息

名称	类型	说明
id	string	AI 分析模板 ID
results	MediaAnalysisOutputTypeResult[]	分析场景列表

MediaAnalysisOutputTypeEnum

媒资 AI 分析结果的场景类型枚举

分析场景	描述
figure	人脸
keyword	关键字
scenario	场景
entity	实体
logo	logo
knowledge_graph	知识图谱

MediaAnalysisOutputTypeResult

媒资 AI 分析结果场景列表。AI 分析结果一般有多个场景分类，这是一个场景结果的数据结构

名称	类型	说明
type	string(MediaAnalysisOutputTypeEnum)	分析场景，枚举
result	MediaAnalysisOutputTypeResultItem[]	分析结果项

MediaAnalysisOutputTypeResultItem

媒资 AI 分析结果分类中的某一个类型的结果。

名称	类型	说明
attribute	string	分析结果标签
source	string	标签来源

MediaAnalysisTaskInfo

媒资 AI 分析任务信息

名称	类型	说明
mediaId	string	媒资 ID
errMsg	string	错误信息
analysisInput	MediaAnalysisTaskInput	分析任务输入参数
analysisOutput	MediaAnalysisOutputInfo	分析任务输出参数

MediaAnalysisTaskInput

媒资 AI 分析任务输入参数

名称	类型	说明
presetId	string	AI 分析模板 ID

MediaAudioCodec

媒资音频编码信息

名称	类型	说明
codec	string	音频编码规格
channels	int	音频文件的声道信息
sampleRateInHz	int	音频文件的采样率，单位：Hz
bitRateInBps	int	音频文件的码率，单位：bps

MediaBasicInfo

媒资基本信息

名称	类型	说明
mediaId	string	媒资 ID
name	string	媒资名称
description	string	媒资描述
mediaType	string	媒资类型，video/image/audio
banStatus	string	媒资封禁状态， NORMAL：未封禁 BAN：已封禁
createTime	string	创建时间
categoryId	string	媒资分类 ID
tags	string[]	媒资标签列表
source	MediaSource	媒资源信息
sourceMetadata	MediaSourceMetadata	媒资源文件元信息

MediaBlackBorderArea

媒资视频黑边信息

名称	类型	说明
x	int	去黑边后的视频左偏移位置，单位：像素
y	int	去黑边后的视频上偏移位置，单位：像素
width	int	去黑边后的视频宽度，单位：像素
height	int	去黑白后的视频高度，单位：像素

MediaBlackBorderDetectOutputInfo

媒资视频黑边检测输出信息

名称	类型	说明
borderArea	MediaBlackBorderArea	去黑边区域信息
meta	MediaBlackBorderVideoMetaInfo	视频信息

MediaBlackBorderDetectTaskInfo

媒资视频黑边检测任务信息

名称	类型	说明
mediaId	string	媒资 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
errMsg	string	错误信息
blackBorderOutput	MediaBlackBorderDetectOutputInfo	黑边检测输出信息

MediaBlackBorderDetectTaskInput

媒资视频黑边检测任务的输入参数

名称	类型	说明
presetId	string	转码模板 ID，使用去黑边时必填

MediaBlackBorderVideoMetaInfo

黑边视频信息

名称	类型	说明
width	int	视频宽度，单位：像素
height	int	视频高度，单位：像素
rotate	int	视频旋转角度，单位：度

MediaDetail

媒资详细信息，继承自 MediaBasicInfo，还包含以下参数

名称	类型	说明
transcodeOutputs	MediaTranscodeOutputInfo[]	转码输出信息
thumbnailOutputs	MediaThumbnailOutputInfo[]	抽帧输出信息
subtitleOutputs	MediaSubtitleOutputInfo[]	字幕输出信息
analysisOutputs	MediaAnalysisOutputInfo[]	AI 分析输出信息
regulationOutputs	MediaRegulationOutputInfo[]	AI 审核输出信息

MediaDwmDetectTaskInfo

视频数字水印提取任务信息

名称	类型	说明
mediaId	string	媒资 ID
transcodeOutputId	string	转码输出 ID，即转码模板 ID，用于指定媒资的某个转码输出视频
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
errMsg	string	错误信息
digitalWmAlgVersion	int	数字水印算法版本，支持 1、2
detectedText	string	提取的文字信息，当 status 为 SUCCESS 时返回

MediaFetchCompleteEvent

媒资拉取完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
fetchTaskInfo	MediaFetchTaskInfo	拉取任务信息

MediaFetchTaskInfo

拉取任务信息

名称	类型	说明
errMsg	string	错误信息
url	string	拉取任务源文件地址。与拉取任务 bucket/key 二选一
bucket	string	拉取任务源文件 bucket
key	string	拉取任务源文件 key
coverUrl	string	拉取任务源文件封面图地址
highlightProjectId	string	拉取任务生成的媒资，需要导入的集锦项目 ID
mediaBasicInfo	MediaBasicInfo	媒资基本信息
presetTaskId	string	任务类型为模板处理的任务 ID。若拉取上传时指定了媒资后续模版处理操作，当该模板处理时会生成一个新任务
workflowTaskId	string	任务类型为工作流处理的任务 ID。若拉取上传时指定了媒资后续工作流处理操作，当该工作流处理时会生成一个新任务

MediaPresetTaskInfo

媒资模板处理任务信息

名称	类型	说明
mediaId	string	媒资 ID
transcodeTasks	MediaTranscodeTaskInfo[]	转码任务信息列表，当 presetIds 中包含转码模板时返回
thumbnailTasks	MediaThumbnailTaskInfo[]	抽帧任务信息列表，当 presetIds 中包含抽帧模板时返回

MediaPresetTaskInput

媒资进行模板处理任务的输入参数

名称	类型	说明
presetIds	string[]	模版 ID 列表，支持转码、抽帧模板，使用模板处理时必填
watermarkIds	string[]	明水印模版 ID 列表，当 presetIds 是转码模板时，watermarkIds 会在每一个转码处理中生效，使用模版处理时选填
digitalWatermark	MediaTranscodeDigitalWatermark	数字水印嵌入信息，使用模版处理时选填

MediaRegulationCompleteEvent

媒资 AI 审核完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
beginProcessTime	string	任务开始转码时间
regulationTaskInfo	MediaRegulationTaskInfo	AI 审核任务信息

MediaRegulationOutputInfo

AI 审核结果信息

名称	类型	说明
id	string	AI 审核模板 ID
label	string	AI 审核整体结果， NORMAL：正常 REVIEW：疑似违规 REJECT：确认违规
results	MediaRegulationOutputTypeResult[]	审核类型结果列表

MediaRegulationOutputSubTypeEnum

审核结果中的 subType 表示”审核项”。每种审核类型下细分了不同审核项

审核场景	审核类型	审核项	审核项描述
涉黄审核	sexual_porn	behavior, sm, products, children, art	性行为及露点及招嫖，SM, 性用品及性玩具，儿童，艺术品色情
涉黄审核	sexual_sexy	male, female	男性衣着暴露，女性衣着暴露
涉黄审核	sexual_intimacy	intimacy	亲密行为
涉黄审核	sexual_vulgar	vulgar	低俗行为
涉黄审核	sexual_special	pregnant	孕肚裸露
暴恐审核	terrorist_group	terrorist_group	恐怖组织
暴恐审核	terrorist	terrorist	暴恐人物
暴恐审核	terror_event	blood, corpse, murder, explosion, riot, weapon, police, traffic	血腥，尸体，绑架及杀人，爆炸火灾，暴乱，军事武器，警察部队，车祸
涉政审核	politician	politician_positive, politician_negative, bad_artist	涉政正面人物，涉政负面人物，劣迹艺人
涉政审核	political_event	political_event_positive, political_event_negative	涉政正面事件，涉政负面事件
涉政审核	political_group	political_group_positive, political_group_negative	涉政正面组织，涉政负面组织
广告审核	ad_brand	brand	品牌标识
广告审核	ad_marketing	qrcode, contact, website, commercial, watermark	二维码，联系方式，网址，软文推广，水印
广告审核	ad_brand_negative	brand_negative_comment	品牌负面评论
违禁审核	bad_behavior	smoke, drink, bad_behavior_gamble, drug	吸烟，喝酒，赌博，毒品
违禁审核	illegal_gamble	gamble	赌博
违禁审核	illegal_forgery	forgery	假冒伪劣及造假盗窃
违禁审核	illegal_trade	trade	非法交易
违禁审核	illegal_privacy	privacy	非法获取私人信息
质量审核	disgust	disgust_image	恶心图
官方文本黑库	official_text_black_lib	baidu_illegal_textlib	违禁词库
官方图片黑库	image_black_lib	default_image_black_lib	百度云风控

MediaRegulationOutputTypeEnum

审核结果中的 type 表示”审核类型”。每类审核场景下包含着多种审核类型，不同审核类型支持的审核物料也不一样

审核场景	审核类型	描述
涉黄审核	sexual_porn	色情审核
涉黄审核	sexual_sexy	性感审核
涉黄审核	sexual_intimacy	亲密行为审核
涉黄审核	sexual_vulgar	低俗行为
涉黄审核	sexual_special	特殊行为
暴恐审核	terrorist_group	暴恐组织审核
暴恐审核	terrorist	暴恐人物审核
暴恐审核	terror_event	暴力事件审核
涉政审核	politician	涉政人物审核
涉政审核	political_event	涉政事件审核
涉政审核	political_group	涉政组织审核
广告审核	ad_brand	品牌广告审核
广告审核	ad_marketing	欺诈及营销广告审核
广告审核	ad_brand_negative	品牌负面评论审核
违禁审核	bad_behavior	不良行为审核
违禁审核	illegal_gamble	赌博审核
违禁审核	illegal_forgery	假冒伪劣及造假盗窃审核
违禁审核	illegal_trade	非法交易审核
违禁审核	illegal_privacy	非法获取私人信息审核
质量审核	disgust	恶心

MediaRegulationOutputTypeResult

AI 审核类型结果

名称	类型	说明
type	string(MediaRegulationOutputTypeEnum)	审核类型
items	MediaRegulationOutputTypeResultItem[]	审核类型结果列表

MediaRegulationOutputTypeResultItem

AI 审核类型结果项

名称	类型	说明
subType	string(MediaRegulationOutputSubTypeEnum)	审核项
timeInSeconds	int	物料在视频中的秒数
startTimeInSeconds	int	物料在视频中的起始秒数，和 endTimeInSeconds 同时存在
endTimeInSeconds	int	物料在视频中的结束秒数，和 startTimeInSeconds 同时存在
confidence	double	审核结果项的置信度，0~100 的浮点数
label	string	审核结果项标记
extra	string	额外信息，如有；例如政治敏感人物识别出来的人名
evidence	MediaRegulationOutputTypeResultItemEvidence[]	审核项证据列表

MediaRegulationOutputTypeResultItemEvidence

AI 审核类型结果项证据

名称	类型	说明
location	MediaRegulationOutputTypeResultItemEvidenceLocation	证据位置信息

MediaRegulationOutputTypeResultItemEvidenceLocation

AI 审核类型结果项证据位置信息

名称	类型	说明
leftOffsetInPixel	int	左偏移
topOffsetInPixel	int	上偏移
widthInPixel	int	宽度
heightInPixel	int	高度

MediaRegulationTaskInfo

AI 审核任务信息

名称	类型	说明
mediaId	string	媒资 ID
errMsg	string	错误信息
regulationInput	MediaRegulationTaskInput	AI 审核任务输入信息
regulationOutput	MediaRegulationOutputInfo	AI 审核任务输出信息

MediaRegulationTaskInput

AI 审核任务输入信息

名称	类型	说明
presetId	string	审核模板 ID

MediaSource

媒资源信息

名称	类型	说明
sourceType	string	媒资来源，支持： UPLOAD：上传 COMPOSE：云剪辑 FETCH：拉取 GENERATE：视频生成
sourceUrl	string	媒资源文件播放地址
coverUrl	string	媒资封面图地址

MediaSourceMetadata

媒资源文件元信息

名称	类型	说明
etag	string	文件 ETag，可用于校验文件是否被修改过
fileSizeInByte	int	文件大小，单位：字节
type	string	文件类型， video：视频或图片 audio：音频
container	string	音视频文件的容器类型
durationInSecond	int	音视频文件时长，单位：秒
durationInMillisecond	int	音视频文件时长，单位：毫秒
video	MediaVideoCodec	视频元信息
audio	MediaAudioCodec	音频元信息
blackBorderArea	MediaBlackBorderArea	视频黑边信息

MediaSubtitleOcrRegion

字幕任务的 ocr 识别区域

名称	类型	说明
ocrRegionX	int	字幕区域左上角 x 坐标，相对于视频左上角的偏移量，单位：像素
ocrRegionY	int	字幕区域左上角 y 坐标，相对于视频左上角的偏移量，单位：像素
ocrRegionWidth	int	字幕区域宽度，单位：像素
ocrRegionHeight	int	字幕区域高度，单位：像素

MediaSubtitleOutputInfo

字幕任务输出信息

名称	类型	说明
id	string	字幕任务 ID（工作流节点 ID）
urls	string[]	字幕文件播放地址列表
formats	string[]	字幕文件格式列表，与 urls 顺序对应，类型支持： srt json

MediaSubtitleTaskInfo

字幕任务信息

名称	类型	说明
mediaId	string	媒资 ID
status	string	任务状态，包括 READY RUNNING SUCCESS FAILED
errMsg	string	任务失败时的错误信息
subtitleInput	MediaSubtitleTaskInput	字幕任务输入信息
subtitleOutput	MediaSubtitleOutputInfo	字幕任务输出信息

MediaSubtitleTaskInput

字幕任务输入信息

名称	类型	说明
startTimeInSecond	int	提取字幕开始时间
durationTimeInSecond	int	提取字幕时长
formats	string[]	字幕格式，支持： srt json
subtitleType	string	提取字幕类型，支持： asr：音频提取字幕 ocr：图像识别提取字幕
ocrRegion	MediaSubtitleOcrRegion	文字识别区域，仅当字幕类型为 AUTO 时有效

MediaTaskBasicInfo

任务基本信息

名称	类型	说明
taskId	string	任务 ID
mediaId	string	媒资 ID
type	string	任务类型，包括 WORKFLOW：工作流处理任务 PRESET：模板处理任务 COMPOSE：视频云剪辑任务 FETCH：媒资拉取任务 HIGHLIGHT_UNDERSTAND：精彩集锦视频理解任务 DWM_DETECT：数字水印提取任务 VIDEO_GENERATE：视频生成任务
status	string	任务状态，包括 READY RUNNING SUCCESS FAILED FINISHED 其中 FINISHED 包含 SUCCESS 和 FAILED 两种可能，工作流和模版处理任务的终态均为 FINISHED
createTime	string	任务创建时间
finishTime	string	任务完成时间

MediaTaskDetail

任务详细信息

名称	类型	说明
taskId	string	任务 ID
type	string	任务类型，包括 WORKFLOW：工作流处理任务 PRESET：模板处理任务 COMPOSE：视频云剪辑任务 FETCH：媒资拉取任务 HIGHLIGHT_UNDERSTAND：精彩集锦视频理解任务 DWM_DETECT：数字水印提取任务 VIDEO_GENERATE：视频生成
status	string	任务状态，包括 READY RUNNING SUCCESS FAILED FINISHED 其中 FINISHED 包含 SUCCESS 和 FAILED 两种可能，工作流和模版处理任务的终态均为 FINISHED
createTime	string	任务创建时间
finishTime	string	任务完成时间
mediaWorkflowTaskInfo	MediaWorkflowTaskInfo	工作流任务信息，仅当 type 为 WORKFLOW 时有效
mediaPresetTaskInfo	MediaPresetTaskInfo	模板任务信息，仅当 type 为 PRESET 时有效
composeTaskInfo	ComposeTaskInfo	视频云剪辑任务信息，仅当 type 为 COMPOSE 时有效
mediaFetchTaskInfo	MediaFetchTaskInfo	媒资拉取任务信息，仅当 type 为 FETCH 时有效
highlightUnderstandTaskInfo	HighlightUnderstandTaskInfo	精彩集锦视频理解任务信息，仅当 type 为 HIGHLIGHT_UNDERSTAND 时有效
mediaDwmDetectTaskInfo	MediaDwmDetectTaskInfo	数字水印提取任务信息，仅当 type 为 DWM_DETECT 时有效
videoGenerateTaskInfo	VideoGenerateTaskInfo	视频生成任务信息，仅当 type 为 VIDEO_GENERATE 时有效

MediaThumbnailCompleteEvent

媒资截图完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
beginProcessTime	string	任务开始转码时间
thumbnailTaskInfo	MediaThumbnailTaskInfo	抽帧任务信息

MediaThumbnailOutputInfo

抽帧任务结果信息

名称	类型	说明
id	string	抽帧模板 ID
urls	string[]	抽帧结果播放地址列表

MediaThumbnailTaskInfo

抽帧任务信息

名称	类型	说明
mediaId	string	媒资 ID
errMsg	string	错误信息
thumbnailInput	MediaThumbnailTaskInput	抽帧任务输入信息
thumbnailOutput	MediaThumbnailOutputInfo	抽帧任务输出信息

MediaThumbnailTaskInput

抽帧任务输入信息

名称	类型	说明
presetId	string	抽帧模板 ID

MediaTranscodeCompleteEvent

媒资转码完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
beginProcessTime	string	任务开始转码时间
transcodeTaskInfo	MediaTranscodeTaskInfo	转码任务信息

MediaTranscodeDigitalWatermark

转码嵌入数字水印的参数

名称	类型	说明
digitalWmTextContent	string	需嵌入的文字内容，长度<=100 字符
digitalWmAlgVersion	int	算法版本号，支持 1、2
digitalWmStrength	float	数字水印嵌入强度，对同一算法，强度越高则抗攻击能力越强，隐蔽性越差。范围 0 ～ 1，默认值 0.5

MediaTranscodeOutputAudioCodec

转码结果音频编码信息

名称	类型	说明
channels	int	音频文件的声道信息
sampleRateInHz	int	音频文件的采样率，单位：Hz

MediaTranscodeOutputInfo

转码结果信息

名称	类型	说明
id	string	转码模板 ID
url	string	转码结果播放地址
meta	MediaTranscodeOutputMeta	转码结果元信息
watermarkIds	string[]	明水印 ID 列表
digitalWatermark	MediaTranscodeDigitalWatermark	数字水印信息

MediaTranscodeOutputMeta

转码结果元信息

名称	类型	说明
video	MediaTranscodeOutputVideoCodec	转码结果视频编码信息
audio	MediaTranscodeOutputAudioCodec	转码结果音频编码信息

MediaTranscodeOutputVideoCodec

转码结果视频编码信息

名称	类型	说明
durationInSeconds	int	音视频文件时长，单位：秒
durationInMilliSeconds	int	音视频文件时长，单位：毫秒
sizeInKiloByte	double	音视频文件大小，单位：KB
widthInPixel	int	视频宽度
heightInPixel	int	视频高度
frameRate	int	视频媒体的帧率
gopAlign	bool	是否开启 gop 对齐
mp4MoovSize	int	mp4 文件 moov 块大小，单位：Byte

MediaTranscodeTaskInfo

转码任务信息

名称	类型	说明
mediaId	string	媒资 ID
errMsg	string	错误信息
transcodeInput	MediaTranscodeTaskInput	转码任务输入信息
transcodeOutput	MediaTranscodeOutputInfo	转码任务输出信息

MediaTranscodeTaskInput

转码任务输入信息

名称	类型	说明
presetId	string	转码模板 ID
watermarkIds	string[]	明水印 ID 列表

MediaUploadCompleteEvent

媒资上传完成回调事件内容，结构与 MediaBasicInfo 一致

MediaVideoCodec

媒资视频编码信息

名称	类型	说明
codec	string	视频文件的编码规格
heightInPixel	int	视频高度
widthInPixel	int	视频宽度
bitRateInBps	int	视频媒体的码率
frameRate	int	视频媒体的帧率
rotate	int	旋转角度（部分视频包含该参数）
dar	string	视频显示宽高比，如 "16:9" （部分视频包含该参数）

MediaWorkflowAnalysisNodeTaskInfo

工作流视频分析节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
analysisTaskInfo	MediaAnalysisTaskInfo	视频分析任务信息

MediaWorkflowBlackBorderDetectNodeTaskInfo

工作流黑边检测节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
blackBorderDetectTaskInfo	MediaBlackBorderDetectTaskInfo	黑边检测任务信息

MediaWorkflowPublishNodeTaskInfo

工作流发布节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
errMsg	string	错误信息

MediaWorkflowRegulationNodeTaskInfo

工作流视频审核节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
regulationTaskInfo	MediaRegulationTaskInfo	视频审核任务信息

MediaWorkflowStartNodeTaskInfo

工作流开始节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
errMsg	string	错误信息

MediaWorkflowSubtitleNodeTaskInfo

工作流字幕提取节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
subtitleTaskInfo	MediaSubtitleTaskInfo	字幕任务信息

MediaWorkflowTaskInfo

工作流任务信息

名称	类型	说明
mediaId	string	媒资 ID
workflowId	string	工作流 ID
startNodeTaskInfo	MediaWorkflowStartNodeTaskInfo	开始节点任务信息
transcodeNodeTaskInfos	MediaWorkflowTranscodeNodeTaskInfo[]	转码节点任务信息
thumbnailNodeTaskInfos	MediaWorkflowThumbnailNodeTaskInfo[]	截图节点任务信息
blackBorderDetectNodeTaskInfos	MediaWorkflowBlackBorderDetectNodeTaskInfo[]	黑边检测节点任务信息
subtitleNodeTaskInfos	MediaWorkflowSubtitleNodeTaskInfo[]	字幕提取节点任务信息
analysisNodeTaskInfos	MediaWorkflowAnalysisNodeTaskInfo[]	分析节点任务信息
regulationNodeTaskInfos	MediaWorkflowRegulationNodeTaskInfo[]	审核节点任务信息
publishNodeTaskInfo	MediaWorkflowPublishNodeTaskInfo	发布节点任务信息

MediaWorkflowTaskInput

媒资进行工作流处理任务的输入参数

名称	类型	说明
workflowId	string	工作流 id

MediaWorkflowThumbnailNodeTaskInfo

工作流截图节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
thumbnailTaskInfos	MediaThumbnailTaskInfo	截图任务信息

MediaWorkflowTranscodeNodeTaskInfo

工作流转码节点信息

名称	类型	说明
nodeId	string	节点 ID
nodeName	string	节点名称
transcodeTaskInfo	MediaTranscodeTaskInfo	转码任务信息

TextToVideoK10TaskInput

文生视频 K10 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro
aspectRatio	string	比例，非必填，默认 16:9，支持 9:16 16:9 1:1
cameraControl	VideoGenerateCameraControl	控制摄像机运动的协议，非必填

TextToVideoK16TaskInput

文生视频 K16 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro
aspectRatio	string	比例，非必填，默认 16:9，支持 9:16 16:9 1:1

TextToVideoK20TaskInput

文生视频 K20 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
cfgScale	float	自由度，非必填，默认 0.5，取值范围：[0, 1]，值越大，模型自由度越小，与用户输入的提示词相关性越强
duration	int	视频时长，单位 s，支持： 5 10
motionMode	string	生成模式，非必填，默认 std，支持： std pro
aspectRatio	string	比例，非必填，默认 16:9，支持 9:16 16:9 1:1

TextToVideoP35TaskInput

文生视频 P35 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频质量，支持： 360p 540p 720p 1080p
aspectRatio	string	比例，支持： 16:9 9:16 1:1 4:3 3:4
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk
seed	integer	随机种子，非必填

TextToVideoP40TaskInput

文生视频 P40 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频质量，支持： 360p 540p 720p 1080p
aspectRatio	string	比例，支持： 16:9 9:16 1:1 4:3 3:4
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk
seed	integer	随机种子，非必填

TextToVideoP45TaskInput

文生视频 P45 任务输入参数

参数	类型	描述
prompt	string	提示词
negativePrompt	string	负面提示词
duration	int	视频时长，单位 s，支持： 5 8
resolution	string	视频质量，支持： 360p 540p 720p 1080p
aspectRatio	string	比例，支持： 16:9 9:16 1:1 4:3 3:4
motionMode	string	生成模式，非必填，默认 normal，支持： normal fast (normal, fast, --fast only available when duration=5; --resolution=1080p does not support fast)
style	string	风格，非必填，支持： anime 3d_animation clay comic cyberpunk
seed	integer	随机种子，非必填

TextToVideoRequest

文生视频任务输入参数

参数	类型	描述
model	string	模型名称，包括： V15 VQ1 P35 P40 P45 K16 K20
modelV15TaskInput	TextToVideoV15TaskInput	V15 模型的特定输入参数
modelVQ1TaskInput	TextToVideoVQ1TaskInput	VQ1 模型的特定输入参数
modelP35TaskInput	TextToVideoP35TaskInput	P35 模型的特定输入参数
modelP40TaskInput	TextToVideoP40TaskInput	P40 模型的特定输入参数
modelP45TaskInput	TextToVideoP45TaskInput	P45 模型的特定输入参数
modelK16TaskInput	TextToVideoK16TaskInput	K16 模型的特定输入参数
modelK20TaskInput	TextToVideoK20TaskInput	K20 模型的特定输入参数

TextToVideoV15TaskInput

文生视频 V15 任务输入参数

参数	类型	描述
prompt	string	生成的提示文本
duration	integer	视频时长，单位 s，支持： 4 8
resolution	string	分辨率，支持： 360p 720p 1080p
style	string	风格，非必填，默认 general，支持： general anime
movementAmplitude	string	运动幅度，非必填，默认 auto, 支持： auto small medium large
seed	integer	随机种子，非必填
aspectRatio	string	比例，非必填，默认 16:9 , 支持： 16:9 9:16 1:1

TextToVideoVQ1TaskInput

文生视频 VQ1 任务输入参数

参数	类型	描述
prompt	string	生成的提示文本
duration	integer	视频时长，单位 s，支持： 5
resolution	string	分辨率，支持： 1080p
style	string	风格，非必填，默认 general，支持： general anime
movementAmplitude	string	运动幅度，非必填，默认 auto, 支持： auto small medium large
seed	integer	随机种子，非必填
aspectRatio	string	比例，非必填，默认 16:9 , 支持： 16:9 9:16 1:1

VideoExtendRequest

视频延长任务输入参数

参数	类型	是否必需	描述
model	string	是	模型名称，支持： K
modelKTaskInput	[ExtendVideoKTaskInput](VOD/API 参考/数据结构。md#extendVideoKTaskInput)	否	K 模型的特定输入参数

VideoGenerateCameraControl

控制摄像机运动的协议（如未指定，模型将根据输入的文本/图片进行智能匹配）

参数	类型	描述
type	string	预定义的运镜类型 枚举值："simple", "down_back", "forward_up", "right_turn_forward", "left_turn_forward" simple：简单运镜，此类型下可在"config"中六选一进行运镜 down_back：镜头下压并后退右下移拉远，此类型下 config 参数无需填写 forward_up：镜头前进并上仰右推进上移，此类型下 config 参数无需填写 right_turn_forward：先右旋转后前进右 右旋推进，此类型下 config 参数无需填写 left_turn_forward：先左旋并前进右 左旋推进，此类型下 config 参数无需填写
config	VideoGenerateCameraControlConfig	图片信息， 图生必填

VideoGenerateCameraControlConfig

包含六个字段，用于指定摄像机在不同方向上的运动或变化

• 当运镜类型指定 simple 时必填，指定其他类型时不填
• 以下参数 6 选 1，即指定一个即可

参数	类型	描述
horizontal	float	水平运镜，控制摄像机在水平方向上的移动量（沿 x 轴平移） 取值范围：[-10, 10]，负值表示向左平移，正值表示向右平移
vertical	float	垂直运镜，控制摄像机在垂直方向上的移动量（沿 y 轴平移） 取值范围：[-10, 10]，负值表示向下平移，正值表示向上平移
pan	float	水平摇镜，控制摄像机在水平面上的旋转量（绕 y 轴旋转） 取值范围：[-10, 10]，负值表示绕 y 轴向左旋转，正值表示绕 y 轴向右旋转
tilt	float	垂直摇镜，控制摄像机在垂直面上的旋转量（沿 x 轴旋转） 取值范围：[-10, 10]，负值表示绕 x 轴向下旋转，正值表示绕 x 轴向上旋转
roll	float	旋转运镜，控制摄像机的滚动量（绕 z 轴旋转） 取值范围：[-10, 10]，负值表示绕 z 轴逆时针旋转，正值表示绕 z 轴顺时针旋转
zoom	float	变焦，控制摄像机的焦距变化，影响视野的远近 取值范围：[-10, 10]，负值表示焦距变长、视野范围变小，正值表示焦距变短、视野范围变大

VideoGenerateCompleteEvent

视频生成完成回调事件内容

名称	类型	说明
taskId	string	任务 ID
status	string	运行状态，包括 READY RUNNING SUCCESS FAILED
createTime	string	任务创建时间
finishTime	string	任务完成时间
videoGenerateCompleteEvent	VideoGenerateTaskInfo	视频生成任务输入参数

VideoGenerateTaskInfo

视频生成任务信息

名称	类型	说明
errMsg	string	错误信息
videoGenerateTaskInput	VideoGenerateTaskInput	视频生成任务输入参数
videoGenerateTaskOutput	VideoGenerateTaskOutput	视频生成任务输出参数

VideoGenerateTaskInput

视频生成任务输入参数

名称	类型	说明
type	string	任务请求类型，包括： 参考生视频 文生视频 图生视频 视频延长 拥抱 亲吻 圣诞特效 变形特效 实况照片 情绪特效 复活老照片 AI 换发 双人互动 春节特效 童年回忆 古风换装 全家福比心 财神特效 梦幻婚礼 浪漫公主抱 甜蜜求婚 情侣降临 丘比特之箭 萌宠恋人 变身美队 绿巨人 美队同行 浩克俯冲 我们是毒液 温暖耶稣 拥抱爱人 肌肉激增 虎之触 亲亲 长腿奔跑 活灵活现的艺术 挤压它 绿巨人 黑神话悟空 美少女战士 羊毛卷 长发魔法 疯狂猫女 神奇女侠 小丑重生 蝙蝠侠 多彩毒液 钢铁侠 春节服装 财神 火辣哈莉奎因 谁是毒液 获得毒液伙伴 邪恶镜头 乐高爆炸 怪物入侵 巫师帽子 僵尸模式 僵尸手
imageToVideoRequest	ImageToVideoRequest	图生视频任务输入参数
textToVideoRequest	TextToVideoRequest	文生视频任务输入参数
effectVideoRequest	EffectVideoRequest	特效视频任务输入参数
videoExtendRequest	VideoExtendRequest	视频延长任务输入参数

VideoGenerateTaskOutput

视频生成任务输出参数

参数	类型	描述
mediaBasicInfos	MediaBasicInfo[]	生成媒资基本信息列表