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

# Sora 2 视频生成 API

> Sora 2 API 接入教程：OpenAI 官方视频生成模型，支持文生视频和图生视频。无水印，1080P 高清，$0.15/次。

**基础 URL:** `https://api.yelinai.com/v1/chat/completions`
**API 版本:** `v1`
**服务状态:** 运行中 | **无水印** | **无需邀请码**

**追求极致稳定？** 如果当前方案无法满足稳定性需求，可以使用 [Sora 官转方案](/api-capabilities/sora2/official-forward)（OpenAI 官方 API 透明转发，99.99% 可用性）。

## 前置要求

1

获取 API Key

登录 [YeLIn AI 控制台](https://api.yelinai.com) 获取 API 密钥

2

配置计费模式

编辑令牌设置，选择以下任一计费模式（两者价格相同）：

* **按量优先**（推荐）：优先使用余额计费，余额不足时自动切换。适合大多数用户
* **按次计费**：每次调用直接扣费。适合预算控制严格的场景

两种模式**价格完全相同**，都是 \$0.15/次（10秒或15秒），仅扣费方式不同。

<Note>
  请在 **Console** 查看对应界面截图。
</Note>

如果未设置计费模式，API调用会失败。必须先完成此配置！

## 重大更新

**发布时间：** 2025年10月1日
OpenAI 突然发布 Sora 2 新版本（The New Sora），本站第一时间接入官网 API（官逆，在官方并没有推出正式版之前）。

**最新更新**

* **01/04** 新增 [角色创建 API](/api-capabilities/sora2/character)，支持从视频中提取角色并在后续视频中复用（\$0.01/次）
* **10/20** 15秒模型大降价！从0.25降至0.25降至0.25降至0.15/次，所有模型统一定价；新增原始错误日志功能
* **10/18** 新增支持生成带 Sora 原生水印的视频（默认无水印）
* **10/16** 恢复15秒模型（sora\_video2-15s 和 sora\_video2-landscape-15s）
* **10/10** 新增 sora-2-pro 高清模型，支持 HD 1080P 和 15秒时长（仅支持异步API）
* **10/07** 新增 Python 示例代码；官方 sora-2 和 sora-2-pro 模型已上，但价格高昂、限速
* **10/01** 接入 Sora 2 官逆 API，支持文生视频和图生视频

## Sora 2 核心突破

## 音视频同步

首次实现音视频同步生成

## 物理真实性

物理真实性大幅提升

## 长视频支持

支持 10-16 秒连贯叙事视频

## 无水印输出

生成视频无水印（官网有水印）

## 客串功能

支持真人录制片段融入 AI 场景

## 混音功能

支持社区二次创作

## 核心特性

## 文生视频

纯文字描述生成视频

## 图生视频

支持参考图片（最多 1 张）

## 角色创建

从视频提取角色，通过 @username 复用

## 异步调用

更稳定的任务队列方式（推荐生产环境）

## 多规格支持

横屏、竖屏两种方向选择

## 按次计费

仅按生成次数收费

## 工作流程

1

配置 API Key

在 YeLIn AI 控制台获取 API 密钥，设置为**按量优先**或**按次计费**模式

2

发送请求

调用 `/v1/chat/completions` 端点，指定模型和提示词

3

实时进度

通过流式输出查看任务队列和生成进度

4

获取视频

生成完成后获取视频链接（有效期 1 天）

5

下载保存

立即下载视频到本地保存

\*\*重大价格调整（10/20）\*\*🎉 **15秒模型大降价！** 从 0.25/次降至0.25/次 降至 0.25/次降至0.15/次现在所有基础模型统一定价 0.15/次，无论是10秒还是15秒，横屏还是竖屏，享受同样优惠价格！高清模型sora−2−pro（0.15/次，无论是10秒还是15秒，横屏还是竖屏，享受同样优惠价格！高清模型 sora-2-pro（0.15/次，无论是10秒还是15秒，横屏还是竖屏，享受同样优惠价格！高清模型sora−2−pro（0.8/次）仅支持[异步API](/api-capabilities/sora2/async-api)调用。

## 支持的模型

| 模型                          | 分辨率       | 时长  | 价格       | 稳定性            |
| --------------------------- | --------- | --- | -------- | -------------- |
| `sora_video2`               | 704×1280  | 10秒 | \$0.15/次 | ⭐⭐⭐⭐⭐ 极高       |
| `sora_video2-landscape`     | 1280×704  | 10秒 | \$0.15/次 | ⭐⭐⭐⭐⭐ 极高       |
| `sora_video2-15s`           | 704×1280  | 15秒 | \$0.15/次 | ⭐⭐⭐⭐⭐ 极高       |
| `sora_video2-landscape-15s` | 1280×704  | 15秒 | \$0.15/次 | ⭐⭐⭐⭐⭐ 极高       |
| `sora-2-pro`                | 1024×1792 | 15秒 | \$0.8/次  | ⭐⭐⭐ 一般（仅异步API） |

## 视频规格

* **时长：** 10秒 或 15秒（通过模型名选择）
* **清晰度：** 720P
* **方向：** 竖屏或横屏（通过模型名选择）
* **水印：** 无水印
* **音频：** 支持音视频同步

## 调用方式选择

**推荐使用异步 API**，特别是在生产环境或需要批量生成视频时，稳定性更有保障。

| 特性       | 同步 API                 | 异步 API（推荐）   |
| -------- | ---------------------- | ------------ |
| **端点**   | `/v1/chat/completions` | `/v1/videos` |
| **稳定性**  | 依赖长连接                  | ⭐⭐⭐⭐⭐ 更稳定    |
| **适用场景** | 快速测试、实时反馈              | 生产环境、批量生成    |

## 开始使用

## 同步调用

快速开始、流式输出（适合测试）

## 异步调用

任务队列、更稳定（推荐生产环境）

## 角色创建

从视频提取角色，@username 复用

## 模型定价

了解详细的模型对比和价格

## 代码示例

查看多语言示例代码

## 常见问题

解决使用中的常见问题

## 重要提示

**视频存储时效仅 1 天！**生成的视频存储在国内 CDN，方便国内用户访问。请在生成后**立即下载保存到本地**。

两个模型稳定性都极高，可以根据视频展示场景选择横屏或竖屏模式。
