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

# Sora 2 视频生成

> OpenAI Sora 2 视频生成 API - 支持文生视频、图生视频，声画同步

## 概述

Sora 2 是 OpenAI 于 2025 年 10 月 1 日发布的新版本革命性视频生成模型，实现了业界首个音视频同步生成功能，物理真实性大幅提升，支持长达 15 秒的连贯叙事视频。

<Info>
  **API易第一时间接入 Sora 2 官方 API**，无需邀请码即可使用，价格仅 \$0.15/次起，支持文生视频和图生视频两种模式。
</Info>

## 核心特性

<CardGroup cols={2}>
  <Card title="音视频同步" icon="audio-waveform">
    首次实现音视频同步生成
  </Card>

  <Card title="物理真实性" icon="box">
    物理真实性大幅提升
  </Card>

  <Card title="长视频支持" icon="clock">
    支持最长 15 秒连贯叙事
  </Card>

  <Card title="无水印输出" icon="sparkles">
    生成视频无水印（官网有水印）
  </Card>
</CardGroup>

## 模型定价

| 模型名                         | 描述        | 分辨率                     | 价格       | 稳定性    |
| --------------------------- | --------- | ----------------------- | -------- | ------ |
| `sora_video2`               | 默认竖屏版本    | 720 × 1280              | \$0.12/次 | 高      |
| `sora_video2-landscape`     | 横屏版本      | 1280 × 720              | \$0.12/次 | 高      |
| `sora_video2-15s`           | 竖屏15s 视频  | 720 × 1280              | \$0.12/次 | 高      |
| `sora_video2-landscape-15s` | 横屏 15s 视频 | 1280 × 720              | \$0.12/次 | 高      |
| `sora-2-pro`                | Pro账号版本   | 1024 × 1792,1792 × 1024 | \$0.8/次  | 正常可用了！ |

<Note>
  * 推荐异步调用，各种错误而不计费；
  * 若同步调用，则支持流式输出查看进度；
  * 视频存储时效为 1 天，请及时转存或下载；
  * sora 2 普通版本的分辨率输出其实为 704 px（而非 720 px），是官方的实际表现；
</Note>

## 调用方式

### 端点地址

```
https://api.apiyi.com/v1/chat/completions
```

### 文生视频

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.apiyi.com/v1/chat/completions" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "sora_video2",
      "stream": true,
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "@sama 在西湖边唱歌：生日快乐"
            }
          ]
        }
      ]
    }'
  ```

  ```python Python theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="YOUR_API_KEY",
      base_url="https://api.apiyi.com/v1"
  )

  response = client.chat.completions.create(
      model="sora_video2",
      stream=True,
      messages=[
          {
              "role": "user",
              "content": [
                  {
                      "type": "text",
                      "text": "@sama 在西湖边唱歌：生日快乐"
                  }
              ]
          }
      ]
  )

  for chunk in response:
      if chunk.choices[0].delta.content:
          print(chunk.choices[0].delta.content, end='')
  ```
</CodeGroup>

### 图生视频

支持上传 1 张图片作为参考，生成视频。支持 URL 和 Base64 两种方式上传。

<CodeGroup>
  ```bash cURL (URL) theme={null}
  curl -X POST "https://api.apiyi.com/v1/chat/completions" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "sora_video2",
      "stream": true,
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "type": "text",
              "text": "让这个场景动起来，添加生动的细节"
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.com/image.jpg"
              }
            }
          ]
        }
      ]
    }'
  ```

  ```python Python (Base64) theme={null}
  import base64
  from openai import OpenAI

  client = OpenAI(
      api_key="YOUR_API_KEY",
      base_url="https://api.apiyi.com/v1"
  )

  # 读取并编码图片
  with open("image.jpg", "rb") as f:
      image_data = base64.b64encode(f.read()).decode('utf-8')
      image_url = f"data:image/jpeg;base64,{image_data}"

  response = client.chat.completions.create(
      model="sora_video2",
      stream=True,
      messages=[
          {
              "role": "user",
              "content": [
                  {
                      "type": "text",
                      "text": "让这个场景动起来，添加生动的细节"
                  },
                  {
                      "type": "image_url",
                      "image_url": {
                          "url": image_url
                      }
                  }
              ]
          }
      ]
  )

  for chunk in response:
      if chunk.choices[0].delta.content:
          print(chunk.choices[0].delta.content, end='')
  ```
</CodeGroup>

## 响应格式

### 流式输出

当 `stream: true` 时，API 返回 SSE 格式的进度更新：

```
data: {"choices":[{"delta":{"content":"> ⌛️ 任务正在队列中，请耐心等待...\n\n"}}]}

data: {"choices":[{"delta":{"content":"> 🏃 进度：36.0%\n\n"}}]}

data: {"choices":[{"delta":{"content":"> 🏃 进度：44.7%\n\n"}}]}

data: {"choices":[{"delta":{"content":"> ✅ 视频生成成功，[点击这里](https://example.com/video.mp4) 查看视频~~~\n\n"}}]}

data: [DONE]
```

### 生成时间

* 排队等待：视高峰期而定
* 视频生成：约 2-3 分钟（10秒视频）
* 总耗时：通常 2.5-4 分钟

<Warning>
  请将请求超时时间设置为至少 5 分钟，避免提前断开连接。
</Warning>

## 使用场景

### 1. AI 对话客户端

在 Cherry Studio、ChatBox 等支持 OpenAI API 的客户端中使用：

1. 配置 API易 的 Base URL 和 API Key
2. 选择 `sora_video2` 模型
3. 开启视频生成功能
4. 输入提示词或上传图片生成视频

详细配置方法请参考：[Cherry Studio 配置指南](/scenarios/chat/cherry-studio)

### 2. 代码集成

直接在您的应用中集成 Sora 2 API：

* 支持标准 OpenAI SDK
* 兼容 `/v1/chat/completions` 端点
* 完整的流式输出支持
* 详细的进度反馈

## 常见问题

<AccordionGroup>
  <Accordion title="如何控制视频的横竖屏？">
    通过选择不同的模型名称：

    * `sora_video2` 或 `sora_video2-portrait`：竖屏（704×1280）
    * `sora_video2-landscape`：横屏（1280×704）
  </Accordion>

  <Accordion title="生成的视频有水印吗？">
    API易生成的视频无水印，而官网 sora.com 生成的视频带有 Sora 水印。
  </Accordion>

  <Accordion title="内容违规会扣费吗？">
    如果提示词或图片违反内容政策（如真实人脸、版权素材），请求会返回错误但仍会计费，因为服务器已处理该请求，OpenAI 返回的错误内容（并没有产出视频）。建议调整内容：包括提示词或更换参考图片。建议在 Sora.com 官网测试风控边界，内容没问题后再通过 API 大量跑。也欢迎和本站工作人员交流。
  </Accordion>

  <Accordion title="视频生成失败怎么办？">
    如果收到 "We're under heavy load" 错误，说明官方服务器负载过高，重试即可，此情况不会扣费。
  </Accordion>

  <Accordion title="视频可以保存多久？">
    视频在 CDN 上保存 1 天，请在生成后立即下载到本地。
  </Accordion>
</AccordionGroup>

## 进阶功能

### 高清视频生成

使用 Pro 版本模型：

```json theme={null}
{
  "model": "sora-2-pro",
  "messages": [...]
}
```

* 分辨率：1024 × 1792
* 支持 15 秒输出
* 价格：\$0.20/次

## 技术支持

如有问题，请访问：

* 📖 [使用场景文档](/scenarios)
* 💬 [常见问题 FAQ](/faq/model-selection-guide)
* 🔧 [API 基础手册](/api-manual)