FAQ

​

Video Generation Related

• Portrait: sora_video2
• Landscape: sora_video2-landscape

# Portrait video
model = "sora_video2"

# Landscape video
model = "sora_video2-landscape"

1. Real face reference images will be rejected - Real person photo uploads not supported
2. Only authorized real persons supported - Use via @ID method

• @sama - OpenAI CEO Sam Altman

prompt = "@sama talking happily on the Great Wall"  # ✓ OK

# ✗ Not OK - Uploading real person photos will be rejected
# Uploaded a real person photo + prompt

• Queue: Depends on peak hours
• Generation: 2-3 minutes
• Total: 2.5-4 minutes

1. Set reasonable timeout: Recommend 5 minutes (300 seconds)

import httpx

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yelinai.com/v1",
    http_client=httpx.Client(timeout=300.0)
)

2. Use streaming output: View progress in real-time

response = client.chat.completions.create(
    model="sora_video2",
    messages=[...],
    stream=True  # Enable streaming output
)

3. Avoid peak hours: Choose times with fewer users

1. Wait a few minutes and retry
2. Add retry logic

import time

max_retries = 3
for i in range(max_retries):
    try:
        response = client.chat.completions.create(...)
        break
    except Exception as e:
        if "heavy load" in str(e) and i < max_retries - 1:
            print(f"Service busy, retrying in 30 seconds...")
            time.sleep(30)
        else:
            raise

​

API Calling Related

1. Log in to laozhang.ai console
2. Enter API management
3. Edit token settings
4. Select “token-priority” or “per-call billing”

stream = client.chat.completions.create(
    model="sora_video2",
    messages=[...],
    stream=True  # Enable streaming output
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end='', flush=True)

> ⌛️ Task is in queue, please wait patiently...

> 🏃 Progress: 36.0%

> 🏃 Progress: 68.5%

> ✅ Video generated successfully, [click here](https://xxx.mp4) to view video~~~

import httpx
import openai

# Set 5 minute timeout
client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.yelinai.com/v1",
    http_client=httpx.Client(timeout=300.0)
)

• Minimum: 5 minutes (300 seconds)
• Recommended: 10 minutes (600 seconds)

1. URL images

{
    "type": "image_url",
    "image_url": {
        "url": "https://example.com/image.png"
    }
}

2. Base64 encoding

{
    "type": "image_url",
    "image_url": {
        "url": "data:image/png;base64,iVBORw0KG..."
    }
}

• PNG
• JPEG/JPG
• WebP
• GIF (first frame will be used)

• Maximum 1 image
• Recommended resolution not exceeding 2048×2048

​

Video Download Related

import requests

def download_video(url, save_path):
    """Download video to local"""
    response = requests.get(url, stream=True)
    with open(save_path, 'wb') as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print(f"Saved: {save_path}")

# Download immediately after generation
video_url = extract_video_url(result)
download_video(video_url, "my_video.mp4")

import re

def extract_video_url(content):
    """Extract video link from response content"""
    match = re.search(r'https://[^\s\)]+\.mp4', content)
    return match.group(0) if match else None

# Usage example
response = client.chat.completions.create(...)
content = response.choices[0].message.content
video_url = extract_video_url(content)

https://sora.gptkey.asia/assets/sora/xxx.mp4

1. Use domestic network - Videos stored on domestic CDN, fast access from China
2. Streaming download - Avoid loading all into memory at once

import requests

response = requests.get(video_url, stream=True)
with open('video.mp4', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

3. Resume support - Use download tools that support resume

​

Billing Related

• ✓ Charged when video successfully generated
• ⚠️ Also charged for content violations - Request succeeded (HTTP 200), resources consumed
• ✗ Network errors, timeouts not charged

• ✓ Only charged when status = “completed”
• ✗ No charge for any failure:
  • Content violation (status = “failed”) → Not charged
  • Queue timeout → Not charged
  • Generation failure → Not charged

• 10s/15s videos (portrait/landscape): $0.15/call (unified pricing)
• HD video (sora-2-pro): $0.8/call (Async API only)

• Top-up $100, approximately ¥1.0/call (base models)

• Request successfully submitted to OpenAI platform
• Platform resources consumed for content review
• Async API doesn’t charge (status = “failed”)

1. Test prompts and images on sora.chatgpt.com first
2. Batch generate via API after confirmation
3. Or use Async API (no charge on failure)
4. Avoid real person photos, copyrighted content

1. Log in to laozhang.ai console
2. Go to top-up page
3. Single top-up of $100 or more

• 10-second video: approximately ¥1.0/call

• Alipay
• WeChat Pay

​

Client Usage

1. Add laozhang.ai API configuration in Cherry Studio
   • See: Cherry Studio Configuration Documentation
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

• Cherry Studio ✓ - Full support, recommended
• ChatBox ✓ - Supported
• OpenWebUI ✓ - Supported
• ChatGPT Next Web ✓ - Supported

• API endpoint: https://api.yelinai.com/v1
• Model: Select sora_video2 series

​

Technical Support

1. Email: threezhang.cn@gmail.com
2. WeChat: Kikivivikids
3. Telegram: https://t.me/laozhang_cn
4. Documentation: https://docs.laozhang.ai

• Error message screenshots
• Request parameters (hide API Key)
• Problem occurrence time
• Model name used

• 10/07 Added Python example code
• 10/01 Launched Sora 2 model, supports text-to-video and image-to-video

​

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)
• Both models have extremely high stability, choose with confidence

​

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

• Both models have extremely high stability, reducing retry costs
• Control concurrency when batch generating
• No charge for failures, retry with confidence
• Download videos promptly (storage validity 1 day)

​

Related Links

​

Quick Start

​

Model Pricing

​

Usage Examples

​

API Reference