Skip to main content
Archived page: the Sora 2 video API has been retired. LaoZhang API stopped serving Sora 2 on July 1, 2026, and OpenAI removed the Videos API, sora-2, and sora-2-pro from its API on September 24, 2026. This page keeps the legacy route documentation for existing integrations, and its examples no longer work.For video generation, use Wan 2.7 or Seedance 2.0. To migrate, see Sora 2 API retired: move to Wan or Seedance.
Control via model name, not parameters.
  • Portrait: sora_video2
  • Landscape: sora_video2-landscape
Example:
See Models and Pricing page for details.
By default, watermarking followed the model output; a watermark option was added on 10/18
  • Default: Watermarking followed what the model returned
  • With watermark: Add ?watermark=true to the URL to get videos with the native Sora watermark
Default endpoint:
Watermarked endpoint:
Restriction reasons:
  1. Real face reference images will be rejected - Real person photo uploads not supported
  2. Only authorized real persons supported - Use via @ID method
Available authorized real persons:
  • @sama - OpenAI CEO Sam Altman
Correct example:
Incorrect example:
Normal generation time:
  • Queue: Depends on peak hours
  • Generation: 2-3 minutes
  • Total: 2.5-4 minutes
Optimization suggestions:
  1. Set reasonable timeout: Recommend 5 minutes (300 seconds)
  1. Use streaming output: View progress in real-time
  1. Avoid peak hours: Choose times with fewer users
Reason: OpenAI official load too highSolutions:
  1. Wait a few minutes and retry
  2. Add retry logic
Required setting:Token needs to be set to Usage first (按量优先) or Per-call (按次计费) billing.Configuration steps:
  1. Log in to laozhang.ai console
  2. Enter API management
  3. Edit token settings
  4. Select “Usage first” or “Per-call”
Token setting example
If billing mode is not set correctly, calls will fail.
Use streaming output:
Progress information example:
Increase timeout:
Recommended timeout:
  • Minimum: 5 minutes (300 seconds)
  • Recommended: 10 minutes (600 seconds)
Image-to-video supports:
  1. URL images
  1. Base64 encoding
Supported formats:
  • PNG
  • JPEG/JPG
  • WebP
  • GIF (first frame will be used)
Limitations:
  • Maximum 1 image
  • Recommended resolution not exceeding 2048×2048
Optimization suggestions:
  1. Use a stable network - Keep the connection stable while downloading
  2. Streaming download - Avoid loading all into memory at once
  1. Resume support - Use download tools that support resume
Billing Method: Per-callHow charges were determined:
  • The console order and billing records are authoritative for every charge
  • Content safety rejections, timeouts, cancellations, and other abnormal states follow the console records
  • If an order status looks wrong, contact support for a review
Historical prices (after the 10/20 update):
  • 10s/15s videos (portrait/landscape): $0.15/call (unified pricing; 15-second models were $0.25/call before)
  • HD video (sora-2-pro): $0.8/call (Async API only)
About Content Violation Charges (Sync API only):If prompts or images violate OpenAI content policy, Sync API returns success (HTTP 200) with error message, charges still apply. Reasons:
  • Request successfully submitted to OpenAI platform
  • Platform resources consumed for content review
For the Async API, whether a failed task (status = "failed") was charged follows the console records.Recommendations:
  1. Test prompts and images on sora.chatgpt.com first
  2. Batch generate via API after confirmation
  3. Or use the Async API (billing for failed tasks follows the console records)
  4. Avoid real person photos, copyrighted content
Log in to laozhang.ai console and open the billing or call logs page. Actual charges are based on the model, request result, and current console pricing.Payment methods: Use the currently available methods shown in the console.

Client Usage

Configuration steps:
  1. Add laozhang.ai API configuration in Cherry Studio
  2. Enable video feature
    • Find sora_video2 in model settings
    • Turn on video generation switch
  3. Use
    • Text-to-video: Enter prompt directly
    • Image-to-video: Upload image + prompt
The legacy route worked with these clients:
  • Cherry Studio
  • ChatBox
  • OpenWebUI
  • ChatGPT Next Web
Other clients compatible with the OpenAI API can be configured the same way:
  • API endpoint: https://api.laozhang.ai/v1
  • Model: Select sora_video2 series

Technical Support

Contact methods:
  1. Email: hi@laozhang.ai
  2. Telegram: https://t.me/laozhang_cn
  3. Documentation: https://docs.laozhang.ai
When submitting issues, please provide:
  • Error message screenshots
  • Request parameters (hide API Key)
  • Problem occurrence time
  • Model name used
Update records:
  • 10/07 Added Python example code
  • 10/01 Launched Sora 2 model, supports text-to-video and image-to-video
View complete updates: Overview page

Best Practice Recommendations

Prompt Recommendations

  • ✓ Describe specific scenes and actions
  • ✓ Include details like lighting, atmosphere, emotions
  • ✓ Use authorized real person IDs (e.g., @sama)
  • ✗ Avoid describing real human faces
  • ✗ Avoid overly brief descriptions

Model Selection Recommendations

  • Portrait video: sora_video2 (mobile short videos, social media)
  • Landscape video: sora_video2-landscape (widescreen display, computer playback)

Error Handling Recommendations

  • Set reasonable timeout (recommend 5 minutes)
  • Add retry logic (maximum 2-3 times)
  • Use streaming output to monitor progress
  • Record error logs

Cost Optimization Recommendations

  • Control concurrency when batch generating
  • Billing for failed tasks follows the console records
  • Download videos promptly (storage validity 1 day)

Quick Start

View example code and usage methods

Model Pricing

Learn detailed model comparison and pricing

Usage Examples

View application examples for various scenarios

API Reference

View complete API documentation