# Sora2文生视频

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

视频大概耗时
10s 预计生成时间 1-3 分钟
15s +2分钟
hd +8分钟

关于审查，官方审查会涉及至少3个阶段/方向：
1、提交的图片中是否涉及真人（非常像真人的也不行）
2、提示词内容是否违规（暴力、色情、版权、活着的名人）
3、生成结果审查是否合格（这也是大家经常看到的生成了90%多后失败的原因）

常见错误:
Inpaint image must match the requested width and height
使用官转分组时，图片分辨率需要与官方参数一致，例如 720x1280

## 请求参数

### 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"
:
"make animate"
,
"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": "make animate",
    "model": "sora-2",
    "aspect_ratio": "16:9",
    "hd": false,
    "duration": "10"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

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