Sora2故事板视频

OpenAPI Specification

文生视频接口的故事板用法：在提示词中按分镜格式（Shot 序号、duration、Scene）逐镜描述，即可启用故事板生成。

请求方式：POST

接口地址

text

https://api.allyang.cn/v2/videos/generations

请求头

Content-Type（必填）：请求体类型，按本页标注填写。（示例：application/json）
Authorization（可选）：鉴权头，使用控制台创建的令牌，格式为 Bearer + 令牌。（示例：Bearer {{YOUR_API_KEY}}）

请求参数（application/json）

prompt（string，必填）
model（string，必填）
- 可选值：sora-2、sora-2-pro。
- sora-2-pro：支持高清与 15 秒。
aspect_ratio（string，可选）：输出画面的宽高比。
- 可选值：16:9、9:16。
hd（boolean，可选）：是否输出高清版本，缺省 false；开启后画面更清晰但耗时更长，仅 sora-2-pro 支持。
duration（string，可选）：视频时长（秒）；取值 25 仅 sora-2-pro 支持。
- 可选值：10、15、25。
- 25：25 秒仅 sora-2-pro 支持；取 25 时高清参数不生效。
notify_hook（string，可选）：任务完成后的回调地址，示例占位 https://your-callback.example/callback（真实回调参数以接入时约定为准）。
watermark（boolean，可选）：缺省 false。
private（boolean，可选）：是否隐藏视频：true 时不对外发布且不可二次编辑（remix），缺省 false。

请求示例

json

{
  "prompt": "Shot 1:\nduration: 7.5sec\nScene: 飞机起飞\n\nShot 2:\nduration: 7.5sec\nScene: 飞机降落",
  "model": "sora-2",
  "aspect_ratio": "16:9",
  "hd": false,
  "duration": "10"
}

返回：HTTP 200 表示成功，响应体字段待补（以实测为准）。

使用提示：分镜时长之和会影响成片长度与耗时，上限以实测为准；提示词结构需保持分镜标记完整。