mingyan
StarVideos O3 - 创建任务
使用 StarVideos O3 创建视频生成任务，支持文生视频、图片参考、首尾帧、视频参考以及图视频混合参考
StarVideos O3 创建视频任务
使用
starvideos_o3 创建视频生成任务。该接口支持文生视频、单图/多图参考、首尾帧、视频参考、图片 + 视频、多图 + 视频等能力。认证
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelbodystring必填模型名称，固定为
starvideos_o3。promptbodystring必填视频生成提示词，描述画面内容、动作、镜头和风格。
示例：
"赛博朋克城市夜景，镜头慢慢推进"durationbodyinteger视频时长，单位为秒。适用于文生视频、图片参考和首尾帧模式。
- 默认值：
3 - 支持范围：
3-15 - 视频参考、图片 + 视频、多图 + 视频场景下，生成时长以参考视频素材为准
ratiobodystring输出画面比例。适用于文生视频、图片参考和首尾帧模式。
- 默认值：
9:16 - 可选值：
1:1、9:16、16:9 - 视频参考、图片 + 视频、多图 + 视频场景下，画面比例以参考视频素材为准
referenceImagesbodyarray图片参考 URL 数组，O3 图片输入主字段。
使用规则：
- 纯图片参考：最多
7张 - 搭配
referenceVideos：最多4张 - 首尾帧模式不使用该字段，请使用
first_image+last_image
示例：
["https://example.com/image1.jpg", "https://example.com/image2.jpg"]first_imagebodystring首帧图片 URL，仅首尾帧模式使用，必须搭配
last_image。last_imagebodystring尾帧图片 URL，仅首尾帧模式使用，必须搭配
first_image。referenceVideosbodyarray视频参考 URL 数组，最多
1 个视频，参考视频时长需在 3-10 秒内。搭配视频参考时，生成时长和画面比例以参考视频素材为准。
示例：
["https://example.com/source.mp4"]能力模式
文生视频
仅传
model、prompt，可选传 duration 和 ratio。图片参考
使用
referenceImages 提供 1-7 张图片参考。首尾帧
使用
first_image 和 last_image 精确控制开始与结束画面。视频参考
使用
referenceVideos 提供 1 个参考视频，参考视频时长需在 3-10 秒内。图片 + 视频
同时传
referenceImages 与 referenceVideos，图片最多 4 张。多图 + 视频
用多张图片与参考视频共同约束主体、风格和运动。
参数约束
关键约束：
model仅支持starvideos_o3duration支持3-15秒，默认3ratio支持1:1、9:16、16:9，默认9:16referenceImages纯图片模式最多7张，搭配视频时最多4张referenceVideos最多1个视频，参考视频时长需在3-10秒内first_image与last_image必须成对传入first_image/last_image不能与referenceImages、referenceVideos混用
字段说明：
starvideos_o3 图片输入统一使用 referenceImages，首尾帧输入统一使用 first_image + last_image。响应参数
idstring视频生成任务的唯一标识符，用于后续查询任务状态。
objectstring对象类型，固定为
video。createdinteger任务创建时间戳。
modelstring使用的模型名称。
statusstring任务状态：
queued- 排队中processing- 处理中completed- 已完成failed- 失败
errorstring错误信息。当任务状态为
failed 时返回。