> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora-2

Sora 2 是 OpenAI 最新发布的功能强大的视频模型，是 OpenAI 在生成式媒体领域的最新突破，它是一款顶尖的视频模型，能够根据自然语言或图像生成细节丰富、动态且带有音频的视频片段。基于多年来对多模态扩散技术的研究，并利用多样化的视觉数据进行训练，这使得它在文本生成视频时，能深刻理解三维空间、物体运动和场景的连贯性。

Sora 2 能快速生成高质量的结果，非常适合快速迭代、概念构思和粗略剪辑。对于社交媒体内容、原型以及那些更注重周转时间而非极致精度的场景， Sora 2 通常绰绰有余。

Sora 2 Pro 在 Sora 2 基础上支持 1080P 高清视频，渲染时间更长，运行成本也更高，但它能生成更精致、更稳定的结果。它最适合用于高分辨率电影片段、营销素材以及任何对视觉精度要求极高的场景。

### 模型参数

* 模型ID：`sora-2`（Sora 2）/`sora-2-pro`（Sora 2 Pro）
* 模型价格：你可以在[模型广场](https://geekai.co/models?platform=openai\&type=video)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations)
* API认证：[获取 API KEY](https://docs.geekai.co/cn/docs/quick_start)

<Note>
  不支持视频公共 API 中的以下参数：

  * `negative_prompt`
  * `image_tail`
  * `with_audio`
  * `aspect_ratio`
  * `resolution`（请使用 `size` 参数代替）
  * `quality`
  * `fps`
  * `watermark`

  附：[Sora 2 官方 API 文档](https://platform.openai.com/docs/guides/video-generation)
</Note>

Sora 2 支持的 `size` 尺寸如下：

* `720x1280`
* `1280x720`
* `1024x1792`（仅 Sora 2 Pro 支持）
* `1792x1024`（仅 Sora 2 Pro 支持）

你可以通过 `image` 字段替代官方的 `input_reference` 字段来传入参考图像，`image` 字段支持传入图片 URL 或者 base64 编码的图片数据，目前仅支持单张参考图。

你可以通过 `duration` 字段替代官方的 `seconds` 字段来控制生成视频的时长，单位是秒，默认值是 `4`，取值范围是 `4`、`8`、`12`。

### 模型价格

Sora 2 和 Sora 2 Pro 生成视频秒数计费，并且不同尺寸价格不同，以下是 Sora 2 和 Sora 2 Pro 的价格表：

| 模型         | 尺寸（size）  | 价格（单位：元/秒） |
| ---------- | --------- | ---------- |
| Sora 2     | 720x1280  | 0.75       |
| Sora 2     | 1280x720  | 0.75       |
| Sora 2 Pro | 720x1280  | 2.25       |
| Sora 2 Pro | 1280x720  | 2.25       |
| Sora 2 Pro | 1024x1792 | 3.76       |
| Sora 2 Pro | 1792x1024 | 3.76       |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用速度优先渠道为例，折扣值是 `0.8`，那么生成 4 秒 Sora 2 视频价格是 `0.75 x 4 x 0.8 = 2.4` 元，如果生成同样尺寸的 Sora 2 Pro 视频价格是 `2.25 x 4 x 0.8 = 7.2` 元。其他参数依次类推。

### 内容限制

Sora API 会强制执行多项内容限制：

* 不生成成人内容，仅限适合 18 岁以下观众的内容（未来将提供可绕过此限制的设置）
* 受版权保护的角色和音乐都将被拒绝
* 无法生成真实人物，包括公众人物
* 目前，包含人脸的图像输入会被拒绝

请确保您的提示、参考图像和文字记录都符合这些规则，以避免生成失败。

### 文生视频

通过文字描述来生成对应视频：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"sora-2",
    "prompt":"广角跟踪镜头：一辆影青色的双门轿跑在沙漠公路上行驶，热浪扭曲清晰可见，头顶烈日高悬。",
    "duration": 8
}'
```

响应是一个 JSON 对象，包含生成视频的 URL：

```json theme={null}
{
    "model": "sora-2",
    "task_id": "9286dfbc-e210-4445-a8df-284a93bf34f0",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/10/14/0a95ad44b0febd4c2dd8fd3c43962009.mp4",
            "duration": 8
        }
    ]
}
```

### 图生视频

你可以通过上传参考图来引导视频生成，该图片将作为视频的第一帧。如果你希望输出视频能保留品牌资产、角色或特定环境的特定外观，此功能将非常有用。请注意，该图片必须与目标视频的分辨率和尺寸相匹配：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"sora-2-pro",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "size": "1280x720",
    "duration": 8
}'
```

### 异步任务

由于视频生成通常比较耗时，建议通过极客智坊提供的通用异步方式生成视频。

[视频 API](https://docs.geekai.co/cn/api/video/generations) 中的 `async` 参数用于控制是否异步生成视频，默认为 `false`，表示创建视频接口会同步等待视频生成完毕并返回。如果设置为 `true`，则会异步生成视频并返回任务ID，你可以使用该任务ID轮询视频生成状态。

**创建视频生成任务**

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model":"sora-2-pro",
    "prompt":"她转身一笑，然后缓缓走出画面",
    "image":"https://static.geekai.co/storage/2025/11/14/woman_skyline_original_720p.jpeg",
    "size": "1280x720",
    "duration": 8,
    "async": true
}'
```

响应中会包含任务ID：

```json theme={null}
{
    "model": "sora-2-pro",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "pending"
}
```

**查询视频生成结果**

你可以使用返回的任务 ID 来查询生成状态和获取视频结果：

```bash theme={null}
curl --location --request GET 'https://geekai.co/api/v1/videos/77e3772b-4e92-4fce-a24c-63907585689d' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' 
```

你可以根据视频生成任务状态 `task_status` 值判断视频是否已经生成完成，这个状态值包括四种情况：

* `pending`：任务已创建，等待处理
* `running`：任务正在处理
* `succeed`：任务成功完成，可以获取结果
* `failed`：任务失败，可能是由于内容违规或其他错误

如果任务还在运行中，返回结果如下：

```json theme={null}
{
    "model": "sora-2-pro",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "running"
}
```

轮询视频生成结果接口直到任务状态值为 `succeed`，你就可以获取到生成的视频 URL：

```json theme={null}
{
    "model": "sora-2-pro",
    "task_id": "77e3772b-4e92-4fce-a24c-63907585689d",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/10/14/6c6b8c475899a1c82bcd59a84e78ab46.mp4"
        }
    ]
}
```