Skip to main content

​
Overview

Sora 2 is OpenAI’s revolutionary video generation model released on October 1, 2025, achieving the industry’s first audio-video synchronized generation, significantly improved physical realism, and support for coherent narrative videos up to 15 seconds long.
APIYI was first to integrate official Sora 2 API, no invitation code needed, pricing from only $0.15/call, supporting both text-to-video and image-to-video modes.

​
Detailed Documentation [Feishu Version]

Complete Usage Guide

View Feishu documentation for more code examples, best practices, and pitfall guides with the most timely updates, click to view

​
Core Features

Audio-Video Sync

First-ever audio-video synchronized generation

Physical Realism

Significantly improved physical realism

Long Video Support

Supports up to 16 seconds of coherent narrative

Watermark-free Output

Generated videos have no watermark (official site has watermarks)

​
Model Pricing

Model NameDescriptionResolutionPriceStability
sora_video2Default portrait version704 × 1280$0.15/callHigh
sora_video2-landscapeLandscape version1280 × 704$0.15/callHigh
sora_video2-15sPortrait 15s video704 × 1280$0.25/callHigh
sora_video2-landscape-15sLandscape 15s video1280 × 704$0.25/callHigh
sora-2-pro-allPro account version1024 × 1792$0.40/callModerate
  • Supports streaming output to view progress
  • Video storage valid for 1 day, download promptly

​
Calling Methods

​
Endpoint Address

https://api.apiyi.com/v1/chat/completions

​
Text-to-Video

curl -X POST "https://api.apiyi.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "@sama singing by West Lake: Happy Birthday"
          }
        ]
      }
    ]
  }'

​
Image-to-Video

Supports uploading 1 reference image to generate video. Supports both URL and Base64 upload methods. 
curl -X POST "https://api.apiyi.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora_video2",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Bring this scene to life with vivid details"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'

​
Response Format

​
Streaming Output

When stream: true, API returns SSE format progress updates: 
data: {"choices":[{"delta":{"content":"> ⌛️ Task queued, please wait patiently...\n\n"}}]}

data: {"choices":[{"delta":{"content":"> 🏃 Progress: 36.0%\n\n"}}]}

data: {"choices":[{"delta":{"content":"> 🏃 Progress: 44.7%\n\n"}}]}

data: {"choices":[{"delta":{"content":"> ✅ Video generated successfully, [click here](https://example.com/video.mp4) to view video~~~\n\n"}}]}

data: [DONE]

​
Generation Time

  • Queue waiting: Depends on peak hours
  • Video generation: About 2-3 minutes (10-second video)
  • Total time: Usually 2.5-4 minutes
Set request timeout to at least 5 minutes to avoid premature disconnection.

​
Use Cases

​
1. AI Chat Clients

Use in OpenAI API-compatible clients like Cherry Studio, ChatBox:
  1. Configure APIYI Base URL and API Key
  2. Select sora_video2 model
  3. Enable video generation feature
  4. Input prompt or upload image to generate video
For detailed configuration: Cherry Studio Configuration Guide

​
2. Code Integration

Directly integrate Sora 2 API into your application:
  • Supports standard OpenAI SDK
  • Compatible with /v1/chat/completions endpoint
  • Full streaming output support
  • Detailed progress feedback

​
FAQ

By selecting different model names:
  • sora_video2 or sora_video2-portrait: Portrait (704×1280)
  • sora_video2-landscape: Landscape (1280×704)
Videos generated via APIYI have no watermark, while videos from the official sora.com site have Sora watermarks.
If prompts or images violate content policies (such as real faces, copyrighted materials), the request returns an error but is still charged because the server has processed the request and OpenAI returned error content (without producing a video). Recommended to adjust content: including prompts or replace reference images. Suggest testing content boundaries on Sora.com official site first, then run large batches via API after confirming content is acceptable. Also welcome to communicate with our staff.
If you receive a “We’re under heavy load” error, it means official servers are overloaded. Simply retry, and no charge will be incurred in this case.
Videos are stored on CDN for 1 day. Please download to local storage immediately after generation.

​
Advanced Features

​
HD Video Generation

Use Pro version model: 
{
  "model": "sora-2-pro-all",
  "messages": [...]
}
  • Resolution: 1024 × 1792
  • Supports 15-second output
  • Price: $0.20/call

​
Technical Support

For questions, visit: