创建视频生成任务
所有视频生成方式共用此接口。只需填写 model 和文字描述,再按需要增加图片、视频、音频、首尾帧或平台素材 ID;未使用的参数不要提交。
/api/v3/contents/generations/tasks当前 API Key 可用的视频模型 ID。
内容类型:text、image_url、video_url 或 audio_url。推荐使用官方 content 数组。
提示词内容。也兼容顶层 prompt;二者任选一种即可。
素材用途:first_frame、last_frame、reference_image、reference_video 或 reference_audio。选择 first_frame 或 last_frame 即进入首尾帧模式。
首帧图片。原生首尾帧模式只能提交文字、首帧和可选尾帧,禁止同时提交普通参考图片、参考视频、参考音频或素材库 asset_id。如果需要全模态生视频,可改用普通多模态参考,并在提示词中指定某张参考图片作为首帧或尾帧。
尾帧图片,必须与首帧一起用于原生首尾帧过渡。该模式同样禁止普通参考图片、参考视频、参考音频和素材库素材;需要组合这些素材时,应通过提示词指定参考图片作为首帧或尾帧。
支持公网 HTTPS 图片 URL 或 asset://素材ID。添加多条即可使用多图;通过 role 区分首帧、尾帧或普通参考图。素材 ID 必须属于当前团队,并能在本次命中的渠道使用。
支持公网 HTTPS 视频 URL 或 asset://素材ID,用于动作、运镜或画面节奏参考。
支持公网 HTTPS 音频 URL 或 asset://素材ID,仅具备音频参考能力的模型和渠道会生效。
平台快捷写法,可混排公网图片 URL 与同一上游渠道的 asset_id。官方接入优先使用 content。
顶层提示词兼容字段;与 content[].text 二选一。
输出分辨率,例如 480p、720p、1080p 或 4k。
输出画幅,例如 16:9、9:16 或 1:1。
视频时长,单位秒;优先使用 duration。
是否生成同步音轨,仅支持具备该能力的模型。
是否在任务结果中返回生成视频的末帧。
水印和固定镜头开关,以模型能力为准。
随机种子,用于尽可能复现生成结果。
渠道扩展参数;只有明确需要时再传。
平台返回的资源或任务标识。
实际请求或执行任务的模型。
当前任务状态。
任务创建时间。