Introduction
New Sora2 video integrations currently use Official API Forwarding only. Token creation matches the official API forwarding
gpt-image-2 setup: select only Sora2Official or GPTImage2 Enterprise, and use usage-based billing. The old Sync API, old Async queue, legacy route models, and Character Creation docs are marked outdated for historical troubleshooting only.What is Official API Forwarding?Official API Forwarding is a transparent forwarding service for OpenAI’s official API. Your requests are directly forwarded to OpenAI’s official servers, with service quality and stability aligned with OpenAI official.
Plan Comparison
| Aspect | Official API Forwarding (Current) | Legacy Route (Outdated) |
|---|---|---|
| Stability | Official API forwarding with higher stability | Depends on legacy route integration and is no longer the current route |
| Instruction Following | Precise reproduction | Average |
| Image Quality | Stable, no blur | Occasional blur |
| Duration Options | 4/8/12 seconds | 10/15 seconds |
| Image-to-Video | Supported | Supported |
| API Method | Async only | Sync + Async |
| Pricing | Per-second billing | Per-call billing |
Supported Models and Pricing
sora-2 (Standard Model)
| Resolution | Per Second | 4 sec | 8 sec | 12 sec |
|---|---|---|---|---|
| 720×1280 (Portrait) | $0.1 | $0.4 | $0.8 | $1.2 |
| 1280×720 (Landscape) | $0.1 | $0.4 | $0.8 | $1.2 |
sora-2-pro (HD Model)
| Resolution | Per Second | 4 sec | 8 sec | 12 sec |
|---|---|---|---|---|
| 720×1280 (Portrait) | $0.3 | $1.2 | $2.4 | $3.6 |
| 1280×720 (Landscape) | $0.3 | $1.2 | $2.4 | $3.6 |
| 1024×1792 (Portrait HD) | $0.5 | $2.0 | $4.0 | $6.0 |
| 1792×1024 (Landscape HD) | $0.5 | $2.0 | $4.0 | $6.0 |
Prices above include our service fee.
How to Get Started
Token Creation Rules
| Setting | What to choose | Notes |
|---|---|---|
| Console entry | Token Management → create a new token | Create a dedicated token for Sora Official API Forwarding; do not reuse a legacy Sora2 legacy-route token |
| Billing mode | Pay-as-you-go (select “Quantity priority” if that is the console label) | Same as official API forwarding gpt-image-2; usage is deducted by actual official-forward consumption, not pay-per-call tokens |
| Supported group 1 | Sora2Official | Mixed AZ + official-key forwarding API; use this for normal Sora Official API Forwarding integrations |
| Supported group 2 | GPTImage2 Enterprise | Pure official-key API for production calls that need stronger official-route consistency and stability |
| Do not select | Default group, the legacy group used by gpt-image-2-vip, or legacy Sora2 legacy sync/async groups | These groups are not the current Sora2 video official-forward route |
| Request model name | sora-2 or sora-2-pro | The token group decides route and billing; the video request still passes the Sora model name in the model field |
Create Token
Log in to laozhang.ai console, create a new token, and choose the billing mode and group according to the table above.
Configure Billing Mode
The token billing mode must be “Pay-as-you-go”. If the console dropdown shows “Quantity priority”, select “Quantity priority”. Actual consumption is deducted by official-forward usage.
API Reference
Basic Information
| Configuration | Value |
|---|---|
| Base URL | https://api.laozhang.ai |
| Authentication | Authorization: Bearer YOUR_API_KEY |
| Request Format | multipart/form-data |
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/v1/videos | POST | Create video generation task |
/v1/videos/{id} | GET | Query task status |
/v1/videos/{id}/content | GET | Download generated video |
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model name: sora-2 or sora-2-pro |
prompt | string | Yes | Video description text |
size | string | No | Resolution, e.g. 1280x720 (default 720x1280) |
seconds | string | No | Video duration: 4, 8, or 12 (default 4) |
input_reference | file | No | Reference image file (for image-to-video) |
Supported Resolutions (size parameter)
sora-2:720x1280(Portrait, default)1280x720(Landscape)
720x1280(Portrait)1280x720(Landscape)1024x1792(Portrait HD)1792x1024(Landscape HD)
Complete Examples
Text-to-Video (cURL)
Step 1: Create Video Generation TaskImage-to-Video (cURL)
Image-to-Video allows you to provide a reference image as the first frame of the video. The AI will generate a dynamic video based on this image.
Python Example
Task Status Reference
| Status | Description |
|---|---|
queued | Task queued, waiting to be processed |
in_progress | Video is being generated |
completed | Generation complete, ready for download |
failed | Generation failed |
Developer Documentation
The Official API Forwarding plan is fully compatible with OpenAI’s official API format. For more parameters and advanced usage, please refer to:OpenAI Sora Official Guide
Complete video generation guide
OpenAI Videos API
API reference documentation
Sora 2 Model Docs
sora-2 model details
Sora 2 Pro Model Docs
sora-2-pro model details
Important Notes
FAQ
What's the difference between Official API Forwarding and legacy route?
What's the difference between Official API Forwarding and legacy route?
Official API Forwarding directly calls OpenAI’s official API through transparent forwarding. The legacy route was historical and is no longer the current Sora2 video integration route.
Why doesn't Official API Forwarding support sync API?
Why doesn't Official API Forwarding support sync API?
OpenAI’s official Sora API itself only provides async calling method, so Official API Forwarding also only supports async calls.
Why are duration options different?
Why are duration options different?
Official API Forwarding supports OpenAI’s official 4/8/12 second duration options; legacy route supports the official website interface’s 10/15 second durations.
What are the requirements for image-to-video?
What are the requirements for image-to-video?
Image resolution must match the target video’s size parameter. For example, if size=1280x720, the image must be 1280×720 pixels. Supported formats: JPEG, PNG, WebP. Images containing real human faces are not supported.