mingyan
Sora - 创建任务
使用 Sora 模型创建视频生成任务，支持 4、8、12 秒时长和多种分辨率
Sora 创建视频任务
使用 Sora 的先进 AI 模型创建高质量视频生成任务，当前支持
4、8、12 秒时长选项。认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelbodystring必填模型名称，可选值：
openAiSora2Plus- 支持 4、8、12 秒openAiSora2Pro- 支持 4、8、12 秒
promptbodystring必填视频生成提示词，描述所需的视频内容
示例：
"A cat dancing in the rain, cinematic style"sizebodystring视频尺寸，默认为
720x1280可选值：
720x1280- 竖屏1280x720- 横屏
与
aspect_ratio 二选一使用aspect_ratiobodystring视频宽高比
可选值：
16:9- 横屏9:16- 竖屏
与
size 二选一使用durationbodyinteger视频时长（秒），支持
4、8、12与
seconds 二选一使用secondsbodyinteger视频时长（秒），支持
4、8、12与
duration 二选一使用input_referencebodyarray参考图片数组，用于指导视频生成，最多支持 1 张图片
重要说明：
- 请不要传入真实人像图，大概率会失败
- 如果使用
openAiSora2-xxx系列模型，图片格式需要和 ratio 保持一致 - 仅支持 1280×720 (16:9 横屏) 和 720×1280 (9:16 竖屏)
与
image_urls 二选一使用image_urlsbodyarray参考图片URL数组，用于指导视频生成
重要说明：
- 请不要传入真实人像图，大概率会失败
- 如果使用
openAiSora2-xxx系列模型，图片格式需要和 ratio 保持一致 - 仅支持 1280×720 (16:9 横屏) 和 720×1280 (9:16 竖屏)
与
input_reference 二选一使用响应参数
idstring视频生成任务的唯一标识符，用于后续查询任务状态
objectstring对象类型，固定为
video.generationcreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中
errorstring错误信息，当 status 为
failed 时返回模型特性
openAiSora2Plus
OpenAI Sora2 Plus 版，支持 4、8、12 秒，增强版模型
openAiSora2Pro
OpenAI Sora2 Pro 版，支持 4、8、12 秒，适合更高质量生成
参数选择规则
参数互斥规则：
- 尺寸参数：
size和aspect_ratio二选一 - 时长参数：
duration和seconds二选一 - 参考图片：
input_reference和image_urls二选一
视频时长支持
| 模型 | 支持时长 |
|---|---|
| openAiSora2Plus | 4 秒、8 秒、12 秒 |
| openAiSora2Pro | 4 秒、8 秒、12 秒 |
最佳实践：
- 视频生成为异步处理，需要通过返回的
id查询任务状态和结果 - 在提示词中明确描述所需的视觉效果和风格
- 参考图片可以指导整体风格，最多支持 1 张
- 选择合适的宽高比以匹配你的使用场景
提示词建议：
- 包含具体的场景描述
- 添加风格关键词（如 "cinematic", "artistic", "realistic"）
- 描述动作和运动方式
- 指定光照和色彩偏好