> ## 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 Video Generation API (Outdated Legacy Route)

> Legacy legacy route Sora 2 route documentation for historical troubleshooting only; use Sora Official API Forwarding for current video generation.

<Warning>
  This is legacy Sora2 route documentation and is now outdated. Use [Sora Official API Forwarding](/en/api-capabilities/sora2/official-forward) for the currently available video route.
</Warning>

<Info>
  **Base URL:** `https://api2.laozhang.ai/v1/chat/completions`
  **API Version:** `v1`
  **Service Status:** Legacy route outdated | **Use Official API Forwarding first**
</Info>

<Tip>
  **Current route:** Use [Sora Official API Forwarding](/en/api-capabilities/sora2/official-forward) for Sora2 video generation.
</Tip>

## Prerequisites

<Steps>
  <Step title="Get API Key">
    Log in to [laozhang.ai console](https://api2.laozhang.ai) to obtain your API key
  </Step>

  <Step title="Configure Billing Mode">
    Edit token settings and choose one of the following billing modes (same price for both):

    * **Volume Priority** (Recommended): Uses balance billing first, automatically switches when balance is insufficient. Suitable for most users
    * **Pay-per-call**: Direct deduction for each call. Suitable for strict budget control scenarios

    <Note>
      Both modes have **exactly the same price** at \$0.15/call (10s or 15s), only the billing method differs.
    </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="Token Settings" width="1280" height="537" data-path="images/sora2-token-setting.png" />

    <Warning>
      If billing mode is not configured, API calls will fail. You must complete this configuration first!
    </Warning>
  </Step>
</Steps>

## Major Updates

**Release Date:** October 1, 2025

OpenAI suddenly released Sora 2 new version (The New Sora), and we integrated official website API immediately (legacy route, before OpenAI released official API).

<Note>
  **Latest Updates**

  * **01/04** New [Character Creation API](/en/api-capabilities/sora2/character), extract characters from videos and reuse via @username (\$0.01/call)
  * **10/20** Massive price drop for 15s models! From \$0.25 to \$0.15/call, all models unified pricing; Added raw error log feature
  * **10/18** Added support for generating videos with Sora native watermark (default is no watermark)
  * **10/16** Restored 15-second models (sora\_video2-15s and sora\_video2-landscape-15s)
  * **10/10** Added sora-2-pro HD model, supports HD 1080P and 15-second duration (Async API only)
  * **10/07** Added Python example code; official sora-2 and sora-2-pro models launched but with high pricing and rate limits
  * **10/01** Integrated Sora 2 legacy route API, supports text-to-video and image-to-video
</Note>

## Sora 2 Core Breakthroughs

<CardGroup cols={2}>
  <Card title="Audio-Video Sync" icon="music">
    First-time synchronized audio-video generation
  </Card>

  <Card title="Physical Realism" icon="atom">
    Dramatically improved physical realism
  </Card>

  <Card title="Long Video Support" icon="film">
    Supports 10-16 second coherent narrative videos
  </Card>

  <Card title="No Watermark Output" icon="droplet-off">
    Generated videos have no watermark (official website has watermarks)
  </Card>

  <Card title="Cameo Feature" icon="user-plus">
    Supports integrating real-person recorded clips into AI scenes
  </Card>

  <Card title="Remix Feature" icon="audio-waveform">
    Supports community remixing
  </Card>
</CardGroup>

## Core Features

<CardGroup cols={2}>
  <Card title="Text-to-Video" icon="type">
    Generate videos from pure text descriptions
  </Card>

  <Card title="Image-to-Video" icon="image">
    Supports reference images (up to 1 image)
  </Card>

  <Card title="Character Creation" icon="user-plus" href="/en/api-capabilities/sora2/character">
    Extract characters from videos, reuse via @username
  </Card>

  <Card title="Async API" icon="refresh-cw">
    More stable task queue approach (recommended for production)
  </Card>

  <Card title="Multi-Spec Support" icon="grid-2x2">
    Horizontal and vertical orientation options
  </Card>

  <Card title="Pay-per-Use" icon="badge-dollar-sign">
    Charged only by generation count
  </Card>
</CardGroup>

## Workflow

<Steps>
  <Step title="Configure API Key">
    Get API key from laozhang.ai console, set to **pay-as-you-go** or **pay-per-use** mode
  </Step>

  <Step title="Send Request">
    Call `/v1/chat/completions` endpoint, specify model and prompt
  </Step>

  <Step title="Real-time Progress">
    View task queue and generation progress through streaming output
  </Step>

  <Step title="Get Video">
    Obtain video link after generation completes (valid for 1 day)
  </Step>

  <Step title="Download & Save">
    Download video to local storage immediately
  </Step>
</Steps>

<Note>
  **Price Update (10/20)**

  🎉 **15-second models price drop!** From \$0.25 to \$0.15/call

  All base models now unified at \$0.15/call, regardless of duration or orientation! HD model sora-2-pro (\$0.8/call) is available via [Async API](/en/api-capabilities/sora2/async-api) only.
</Note>

## Supported Models

| Model                       | Resolution | Duration | Price        | Stability                 |
| --------------------------- | ---------- | -------- | ------------ | ------------------------- |
| `sora_video2`               | 704×1280   | 10s      | \$0.15/video | ⭐⭐⭐⭐⭐ Extremely High      |
| `sora_video2-landscape`     | 1280×704   | 10s      | \$0.15/video | ⭐⭐⭐⭐⭐ Extremely High      |
| `sora_video2-15s`           | 704×1280   | 15s      | \$0.15/video | ⭐⭐⭐⭐⭐ Extremely High      |
| `sora_video2-landscape-15s` | 1280×704   | 15s      | \$0.15/video | ⭐⭐⭐⭐⭐ Extremely High      |
| `sora-2-pro`                | 1024×1792  | 15s      | \$0.8/video  | ⭐⭐⭐ Fair (Async API only) |

## Video Specifications

<Info>
  * **Duration:** 10 seconds or 15 seconds (selected via model name)
  * **Quality:** 720P / HD
  * **Orientation:** Vertical or horizontal (selected via model name)
  * **Watermark:** No watermark
  * **Audio:** Supports audio-video synchronization
</Info>

## API Method Selection

<Tip>
  **Recommended to use Async API**, especially in production environments or when batch generating videos, for better stability.
</Tip>

| Feature       | Sync API                          | Async API (Recommended)                  |
| ------------- | --------------------------------- | ---------------------------------------- |
| **Endpoint**  | `/v1/chat/completions`            | `/v1/videos`                             |
| **Stability** | Depends on long connection        | ⭐⭐⭐⭐⭐ More Stable                        |
| **Use Cases** | Quick testing, real-time feedback | Production environment, batch generation |

## Getting Started

<CardGroup cols={2}>
  <Card title="Sync API" icon="bolt" href="/en/api-capabilities/sora2/quick-start">
    Quick start with streaming output (for testing)
  </Card>

  <Card title="Async API" icon="refresh-cw" href="/en/api-capabilities/sora2/async-api">
    Task queue, more stable (recommended for production)
  </Card>

  <Card title="Character Creation" icon="user-plus" href="/en/api-capabilities/sora2/character">
    Extract characters, reuse via @username
  </Card>

  <Card title="Model Pricing" icon="tag" href="/en/api-capabilities/sora2/models-pricing">
    Learn detailed model comparison and pricing
  </Card>

  <Card title="Code Examples" icon="code" href="/en/api-capabilities/sora2/examples">
    View multi-language example code
  </Card>

  <Card title="FAQ" icon="circle-question-mark" href="/en/api-capabilities/sora2/troubleshooting">
    Solve common issues
  </Card>
</CardGroup>

## Important Notes

<Warning>
  **Video storage valid for only 1 day!**

  Generated videos are returned through temporary CDN links with short retention. Please **download and save to local storage immediately** after generation.
</Warning>

<Tip>
  Both models have extremely high stability. Choose horizontal or vertical mode based on your video display scenario.
</Tip>