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

# Sora 2 视频生成 API（旧线路已过时）

> Sora 2 旧线路文档，仅供历史排查参考；当前视频生成请使用 Sora 官方 API 转发方案。

<Warning>
  该页面属于 Sora2 旧线路文档，目前已过时，仅供历史排查参考。当前可用入口请使用 [Sora 官方 API 转发方案](/api-capabilities/sora2/official-forward)。
</Warning>

<Info>
  **基础 URL:** `https://api.laozhang.ai/v1/chat/completions`
  **API 版本:** `v1`
  **服务状态:** 旧线路已过时 | **请优先使用官方 API 转发**
</Info>

<Tip>
  **当前可用入口：** Sora2 视频目前请直接使用 [Sora 官方 API 转发方案](/api-capabilities/sora2/official-forward)。
</Tip>

## 前置要求

<Steps>
  <Step title="获取 API Key">
    登录 [laozhang.ai 控制台](https://api.laozhang.ai) 获取 API 密钥
  </Step>

  <Step title="配置计费模式">
    编辑令牌设置，选择以下任一计费模式（两者价格相同）：

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

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

    <img src="https://mintcdn.com/laozhangai-edd05f2c/_loZ0Jy0ZI__xJ9z/images/sora2-token-setting.png?fit=max&auto=format&n=_loZ0Jy0ZI__xJ9z&q=85&s=d54128f51509467d6b73d207bbe5c86f" alt="令牌设置" width="1280" height="537" data-path="images/sora2-token-setting.png" />

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

## 重大更新

**发布时间：** 2025年10月1日

OpenAI 突然发布 Sora 2 新版本（The New Sora），本站第一时间接入官网 API（旧线路，在官方并没有推出正式版之前）。

<Note>
  **最新更新**

  * **01/04** 新增 [角色创建 API](/api-capabilities/sora2/character)，支持从视频中提取角色并在后续视频中复用（\$0.01/次）
  * **10/20** 15秒模型大降价！从$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，支持文生视频和图生视频
</Note>

## Sora 2 核心突破

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

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

  <Card title="长视频支持" icon="film">
    支持 10-16 秒连贯叙事视频
  </Card>

  <Card title="水印策略以模型返回为准输出" icon="droplet-off">
    生成视频水印策略以模型返回为准（官网有水印）
  </Card>

  <Card title="客串功能" icon="user-plus">
    支持真人录制片段融入 AI 场景
  </Card>

  <Card title="混音功能" icon="audio-waveform">
    支持社区二次创作
  </Card>
</CardGroup>

## 核心特性

<CardGroup cols={2}>
  <Card title="文生视频" icon="type">
    纯文字描述生成视频
  </Card>

  <Card title="图生视频" icon="image">
    支持参考图片（最多 1 张）
  </Card>

  <Card title="角色创建" icon="user-plus" href="/api-capabilities/sora2/character">
    从视频提取角色，通过 @username 复用
  </Card>

  <Card title="异步调用" icon="refresh-cw">
    更稳定的任务队列方式（推荐生产环境）
  </Card>

  <Card title="多规格支持" icon="grid-2x2">
    横屏、竖屏两种方向选择
  </Card>

  <Card title="按次计费" icon="badge-dollar-sign">
    仅按生成次数收费
  </Card>
</CardGroup>

## 工作流程

<Steps>
  <Step title="配置 API Key">
    在 laozhang.ai 控制台获取 API 密钥，设置为**按量优先**或**按次计费**模式
  </Step>

  <Step title="发送请求">
    调用 `/v1/chat/completions` 端点，指定模型和提示词
  </Step>

  <Step title="实时进度">
    通过流式输出查看任务队列和生成进度
  </Step>

  <Step title="获取视频">
    生成完成后获取视频链接（有效期 1 天）
  </Step>

  <Step title="下载保存">
    立即下载视频到本地保存
  </Step>
</Steps>

<Note>
  **重大价格调整（10/20）**

  🎉 **15秒模型大降价！** 从 $0.25/次 降至 $0.15/次

  现在所有基础模型统一定价 $0.15/次，无论是10秒还是15秒，横屏还是竖屏，实际价格以控制台为准！高清模型 sora-2-pro（$0.8/次）仅支持[异步API](/api-capabilities/sora2/async-api)调用。
</Note>

## 支持的模型

| 模型                          | 分辨率       | 时长  | 价格       | 稳定性            |
| --------------------------- | --------- | --- | -------- | -------------- |
| `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） |

## 视频规格

<Info>
  * **时长：** 10秒 或 15秒（通过模型名选择）
  * **清晰度：** 720P
  * **方向：** 竖屏或横屏（通过模型名选择）
  * **水印：** 水印策略以模型返回为准
  * **音频：** 支持音视频同步
</Info>

## 调用方式选择

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

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

## 开始使用

<CardGroup cols={2}>
  <Card title="同步调用" icon="bolt" href="/api-capabilities/sora2/quick-start">
    快速开始、流式输出（适合测试）
  </Card>

  <Card title="异步调用" icon="refresh-cw" href="/api-capabilities/sora2/async-api">
    任务队列、更稳定（推荐生产环境）
  </Card>

  <Card title="角色创建" icon="user-plus" href="/api-capabilities/sora2/character">
    从视频提取角色，@username 复用
  </Card>

  <Card title="模型定价" icon="tag" href="/api-capabilities/sora2/models-pricing">
    了解详细的模型对比和价格
  </Card>

  <Card title="代码示例" icon="code" href="/api-capabilities/sora2/examples">
    查看多语言示例代码
  </Card>

  <Card title="常见问题" icon="circle-question-mark" href="/api-capabilities/sora2/troubleshooting">
    解决使用中的常见问题
  </Card>
</CardGroup>

## 重要提示

<Warning>
  **视频存储时效仅 1 天！**

  生成的视频通过临时 CDN 链接返回，链接有效期较短。请在生成后**立即下载保存到本地**。
</Warning>

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