Skip to main content

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.
Official API Forwarding refers to the solution that directly calls OpenAI’s official Sora API and transparently forwards it to users. Unlike the now-outdated “legacy route” solution, the Official API Forwarding plan offers higher stability and more precise instruction following.
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

How to choose?
  • New integrations: Choose Official API Forwarding
  • Legacy docs: Use only for historical troubleshooting; do not start new projects on the old route

Supported Models and Pricing

sora-2 (Standard Model)

sora-2-pro (HD Model)

Prices above include our service fee.

How to Get Started

Token Creation Rules

1

Create Token

Log in to laozhang.ai console, create a new token, and choose the billing mode and group according to the table above.
2

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.
The Sora Official API Forwarding plan does not support the default group, legacy route groups, or pay-per-call tokens. Do not select the default group, the legacy group used by gpt-image-2-vip, or other legacy route groups.
3

Call API to Generate Video

Follow the complete examples below to call the API.

API Reference

Basic Information

API Endpoints

Request Parameters

Supported Resolutions (size parameter)

sora-2:
  • 720x1280 (Portrait, default)
  • 1280x720 (Landscape)
sora-2-pro:
  • 720x1280 (Portrait)
  • 1280x720 (Landscape)
  • 1024x1792 (Portrait HD)
  • 1792x1024 (Landscape HD)

Complete Examples

Text-to-Video (cURL)

Step 1: Create Video Generation Task
Response Example:

Image-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.
Image Requirements
  • Image resolution must match the size parameter (e.g., if size=1280x720, image must be 1280×720 pixels)
  • Supported formats: JPEG, PNG, WebP
  • Images containing real human faces are not supported (will be rejected by content moderation)
Step 2: Poll Task Status
Response Example (In Progress):
Response Example (Completed):
Step 3: Download Video

Python Example

Task Status Reference

Polling RecommendationVideo generation typically takes 2-5 minutes. We recommend polling status every 15-20 seconds to avoid excessive requests.

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

Key Limitations
  1. Async only: Official API Forwarding does not support sync API, all requests are asynchronous
  2. Usage-based billing only: Must select “Pay-as-you-go” billing mode; pay-per-call tokens are not supported
  3. Only two official-compatible groups are supported: Select Sora2Official or GPTImage2 Enterprise when creating tokens
  4. Image limitation: Image-to-video does not support images containing real human faces

FAQ

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.
OpenAI’s official Sora API itself only provides async calling method, so Official API Forwarding also only supports async calls.
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.
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.