Skip to content
EN

Sora2故事板视频

方法: POST路径: /v2/videos/generations

提示词按照以下格式传即可自动启用故事板 Shot 1:\nduration: 7.5sec\nScene: 飞机起飞\n\nShot 2:\nduration: 7.5sec\nScene: 飞机降落

请求参数

Header 参数

text
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
prompt
string
必需
model
enum<string>
必需
枚举值:
sora-2
sora-2-pro
支持hd、15s
aspect_ratio
enum<string>
输出比例
可选
枚举值:
16:9
横屏
9:16
竖屏
hd
boolean
可选
是否生成高清,默认false;高清会导致生成速度更慢; 仅 sora-2-pro 支持
duration
enum<string>
可选
视频时长;仅 sora-2-pro 支持25s
枚举值:
10
15
25
仅 sora-2-pro 支持25s;当25时,HD不起作用
notify_hook
string
可选
https://xxxx.com/callback
watermark
boolean
默认 false
可选
private
boolean
可选
是否隐藏视频,true-视频不会发布,同时视频无法进行 remix(二次编辑), 默认为 false
示例
{
"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"
}

请求示例代码

Shell

bash
curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

text
object

示例

json
{
    "task_id": "f0aa213c-c09e-4e19-a0e5-c698fe48acf1"
}