Skip to content

UlazAI developer docs

Sora 2 API: video generation, pricing and access

Sora 2 API: video generation, pricing and access

Generate Sora 2 videos through UlazAI with clear endpoints, credit pricing, prompt rules, status polling and CDN output handling.

Check the current Sora model price and any active account offer before generation.

✨ Sora 2 Features

Text-to-video generation

Image-to-video animation

Duration options shown by the current API route

Output settings shown in the current API documentation

Supported aspect ratios depend on the selected route

Asynchronous processing with status polling

Automatic R2 storage with CDN

Email notifications when complete

POST /api/v1/sora/generate/text-to-video/

Generate Video from Text

Create a 10-second video from a text prompt using Sora 2.

Request Body

{
  "prompt": "A serene mountain landscape at sunrise with birds flying",
  "aspect_ratio": "landscape",  // Options: "landscape", "portrait", "square"
  "quality": "standard"          // Options: "standard", "high"
}

Parameters

prompt * (string)

Text description of the video to generate. Max 5000 characters. Be descriptive for best results.

aspect_ratio (string)

Video aspect ratio. Options: landscape (16:9), portrait (9:16), square (1:1). Default: landscape

quality (string)

Quality preset. Options: standard, high. High quality uses more processing time. Default: standard

prompt_directory_optin (boolean) 💰 -10 CREDITS

Share your video to our public Prompt Directory and get 10 credits discount! Default: true

Success Response (201)

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "processing",
    "estimated_completion": "varies by queue",
    "credits_charged": 80,
    "credits_remaining": 920,
    "webhook_url": "https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/",
    "message": "Sora 2 video generation started successfully"
  }
}

cURL Example

curl -X POST https://ulazai.com/api/v1/sora/generate/text-to-video/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape at sunrise with birds flying across the sky",
    "aspect_ratio": "landscape",
    "quality": "standard"
  }'
POST /api/v1/sora/generate/image-to-video/

Generate Video from Image

Animate a static image into a 10-second video using Sora 2.

Request Body

{
  "image_url": "https://example.com/your-image.jpg",
  "prompt": "Camera slowly zooms in as the character turns and smiles",
  "aspect_ratio": "landscape",
  "quality": "standard"
}

Parameters

image_url * (string)

URL of the source image to animate. Must be publicly accessible. Supported formats: JPG, PNG, WebP.

prompt * (string)

Description of how to animate the image. Max 5000 characters.

aspect_ratio (string)

Must match the source image aspect ratio for best results.

quality (string)

Quality preset. Default: standard

prompt_directory_optin (boolean) 💰 -10 CREDITS

Share your video to our public Prompt Directory and get 10 credits discount! Default: true

GET /api/v1/sora/status/{task_id}/

Check Generation Status

Get the current status and result of a Sora video generation task.

Response States

Processing

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "processing",
    "progress": 45,
    "estimated_completion": "varies by queue"
  }
}

Success

{
  "success": true,
  "data": {
    "task_id": "sra_2_1234567890abcdef",
    "status": "success",
    "video_url": "https://cdn.ulazai.com/sora/videos/sra_2_1234567890abcdef.mp4",
    "thumbnail_url": "https://cdn.ulazai.com/sora/thumbnails/sra_2_1234567890abcdef.jpg",
    "duration": 10,
    "resolution": "1920x1080",
    "file_size": "15.2 MB",
    "created_at": "2025-01-03T10:15:30Z"
  }
}

Failed

{
  "success": false,
  "error": "Video generation failed",
  "error_details": "Content policy violation detected in prompt",
  "credits_refunded": 80
}

cURL Example

curl -X GET https://ulazai.com/api/v1/sora/status/sra_2_1234567890abcdef/ \
  -H "Authorization: Token YOUR_API_KEY"

🔑 Sora 2 API access: official vs UlazAI

Sora 2 API access depends on the provider, organization verification and account tier. Verify current access and pricing before integration.

Official OpenAI API

  • Invite / organization-verification gated
  • Billed per second of video
  • You manage your own OpenAI key and quotas

Sora 2 on UlazAI

  • Call it now with one UlazAI API key - no separate invite
  • Priced in shared credits, refunded on failed jobs
  • Same key also calls Veo 3, Seedance and Kling - compare cost and latency from one balance

Want to weigh Sora 2 against the alternatives first? See the 2026 AI video models guide.

💰 Sora 2 Pricing

Text-to-Video

Check current API pricing

for the selected duration and model

• Check current output settings

• Check supported aspect ratios

• Processing time varies by queue

Image-to-Video

Check current API pricing

for image-to-video

• Upload a supported image you may use

• Custom motion prompts

• Processing time varies by queue

Calculate your batch from the current model cost and expected retry rate.

📚 Best Practices

Prompt Guidelines

  • Be specific about camera movements (pan, zoom, tilt)
  • Describe lighting and atmosphere
  • Include character actions and expressions
  • Specify timing for key moments
  • Avoid copyrighted characters or brands

Image-to-Video Tips

  • Use high-quality source images (min 1024px)
  • Match aspect ratio to avoid cropping
  • Describe realistic motion for the scene
  • Consider physics and natural movement

Webhook Integration

  • Videos are automatically stored in R2 with CDN delivery
  • Email notifications sent when generation completes
  • Poll the status endpoint every 30 seconds for updates
  • Failed generations automatically refund credits

⚠️ Error Codes

400 Invalid request parameters or prompt too long
401 Invalid or missing API key
402 Insufficient credits
422 Content policy violation
429 Rate limit exceeded (max 10 concurrent)
500 Server error - credits will be refunded

💻 Code Examples

Python

import requests
import time

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://ulazai.com/api/v1"

# Generate video
response = requests.post(
    f"{BASE_URL}/sora/generate/text-to-video/",
    headers={"Authorization": f"Token {API_KEY}"},
    json={
        "prompt": "A beautiful sunset over the ocean with waves",
        "aspect_ratio": "landscape",
        "quality": "standard"
    }
)

if response.status_code == 201:
    task_id = response.json()["data"]["task_id"]

    # Poll for status
    while True:
        status_response = requests.get(
            f"{BASE_URL}/sora/status/{task_id}/",
            headers={"Authorization": f"Token {API_KEY}"}
        )

        status_data = status_response.json()["data"]

        if status_data["status"] == "success":
            print(f"Video ready: {status_data['video_url']}")
            break
        elif status_data["status"] == "failed":
            print("Generation failed")
            break

        time.sleep(30)  # Wait 30 seconds before next check

JavaScript (Node.js)

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://ulazai.com/api/v1';

async function generateSoraVideo() {
    try {
        // Generate video
        const response = await axios.post(
            `${BASE_URL}/sora/generate/text-to-video/`,
            {
                prompt: 'A beautiful sunset over the ocean with waves',
                aspect_ratio: 'landscape',
                quality: 'standard'
            },
            {
                headers: { 'Authorization': `Token ${API_KEY}` }
            }
        );

        const taskId = response.data.data.task_id;
        console.log(`Generation started: ${taskId}`);

        // Poll for status
        const checkStatus = async () => {
            const statusResponse = await axios.get(
                `${BASE_URL}/sora/status/${taskId}/`,
                { headers: { 'Authorization': `Token ${API_KEY}` } }
            );

            const status = statusResponse.data.data.status;

            if (status === 'success') {
                console.log(`Video ready: ${statusResponse.data.data.video_url}`);
            } else if (status === 'failed') {
                console.log('Generation failed');
            } else {
                setTimeout(checkStatus, 30000); // Check again in 30 seconds
            }
        };

        setTimeout(checkStatus, 30000);

    } catch (error) {
        console.error('Error:', error.response?.data || error.message);
    }
}

generateSoraVideo();

🚀 Ready to Start?

Check your account for current credit offers.

Integrate Sora through the documented UlazAI video flow

Use the current Sora route and request fields shown here, then store the job identifier returned by the API. Do not treat unofficial API examples or old model names as the contract for a live integration.

Poll the status endpoint until a terminal result and surface failures to the user. Confirm model availability and credit estimate before submitting each job.

Music Studio Songs, instrumentals and your own lyrics.