Ugrás a tartalomra

UlazAI fejlesztői dokumentumok

Sora 2 API: videó generálás, árazás és hozzáférés

Sora 2 API: videó generálás, árazás és hozzáférés

Generáljon Sora 2 videókat a UlazAI segítségével egyértelmű végpontokkal, hitelárakkal, prompt szabályokkal, állapotlekérdezéssel és CDN kimenet kezeléssel.

Generálás előtt ellenőrizze az aktuális Sora modell árát és az aktív fiók ajánlatait.

✨ Sora 2 jellemzők

✅ Szövegből videóba generáció

✅ Képről videóra animáció

✅ Időtartam opciók az aktuális API útvonal mutatja

✅ Kimeneti beállítások az aktuális API dokumentációban látható

✅ Támogatott képarányok a kiválasztott útvonaltól függ

✅ Aszinkron feldolgozás állapotlekérdezéssel

✅ Automatikus R2 tároló CDN-nel

✅ E-mail értesítések ha kész

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

Videó létrehozása szövegből

Hozzon létre egy 10 másodperces videót szöveges promptból a Sora 2 használatával.

Kérelem szerve

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

Paraméterek

prompt * (karakterlánc)

A generálandó videó szöveges leírása. Max 5000 karakter. A legjobb eredmény érdekében legyen leíró jellegű.

aspect_ratio (karakterlánc)

Videó képaránya. Opciók: landscape (16:9), portrait (9:16), square (1:1). Alapértelmezett: landscape

minőség (karakterlánc)

Minőségi előre beállított. Opciók: standard, high. A jó minőség több feldolgozási időt igényel. Alapértelmezett: standard

prompt_directory_optin (boolean) 💰 -10 KREDIT

Oszd meg videódat nyilvános Prompt címtárunkban, és szerezd be 10 kredit kedvezmény! Alapértelmezett: true

Sikerreakció (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 példa

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/

Videó létrehozása a képből

Animálj statikus képet 10 másodperces videóvá a Sora 2 használatával.

Kérelem szerve

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

Paraméterek

image_url * (karakterlánc)

Az animálni kívánt forráskép URL-je. Nyilvánosan hozzáférhetőnek kell lennie. Támogatott formátumok: JPG, PNG, WebP.

prompt * (karakterlánc)

A kép animálásának leírása. Max 5000 karakter.

aspect_ratio (karakterlánc)

A legjobb eredmény érdekében meg kell egyeznie a forrás képarányával.

minőség (karakterlánc)

Minőségi előre beállított. Alapértelmezett: standard

prompt_directory_optin (boolean) 💰 -10 KREDIT

Oszd meg videódat nyilvános Prompt címtárunkban, és szerezd be 10 kredit kedvezmény! Alapértelmezett: true

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

Ellenőrizze a Generációs állapotot

Szerezze meg a Sora videógenerálási feladat aktuális állapotát és eredményét.

Válaszállapotok

Feldolgozás

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

Siker

{
  "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"
  }
}

Sikertelen

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

cURL példa

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

🔑 Sora 2 API hozzáférés: hivatalos vs UlazAI

Sora 2 API hozzáférés a szolgáltatótól, a szervezet ellenőrzésétől és a fiókszinttől függ. Az integráció előtt ellenőrizze az aktuális hozzáférést és az árakat.

Hivatalos OpenAI API

  • Meghívás / szervezet-ellenőrzés zárva
  • Videó másodpercenként számlázva
  • Ön kezelheti saját OpenAI kulcsát és kvótáját

Sora 2 a UlazAI-n

  • Hívja most egyetlen UlazAI API kulccsal – külön meghívó nélkül
  • Ára megosztott kreditben, visszatérítés a sikertelen munkák esetén
  • Ugyanez a kulcs hívja a Veo 3, a Seedance és a Kling billentyűket is – hasonlítsa össze a költségeket és a késleltetést egyetlen egyenlegről

Szeretné először mérlegelni a Sora 2-t az alternatívákkal szemben? Lásd a 2026-os AI videómodellek útmutatója.

💰 Sora 2 árak

Szövegből videóba

Ellenőrizze a jelenlegi API árat

a kiválasztott időtartamra és modellre

• Ellenőrizze az aktuális kimeneti beállításokat

• Ellenőrizze a támogatott képarányokat

• A feldolgozási idő soronként változik

Képről videóra

Ellenőrizze a jelenlegi API árat

képről videóra

• Töltsön fel egy támogatott képet, amelyet használhat

• Egyedi mozgás prompts

• A feldolgozási idő soronként változik

Számítsa ki a tételt a modell aktuális költségéből és a várható újrapróbálkozási arányból.

📚 A legjobb gyakorlatok

Prompt Irányelvek

  • Legyen határozott a kamera mozgásával kapcsolatban (pásztázás, zoom, döntés)
  • Ismertesse a világítást és a légkört
  • Tartalmazza a karakter cselekvéseit és kifejezéseit
  • Adja meg a kulcsfontosságú pillanatok időzítését
  • Kerülje a szerzői joggal védett karaktereket vagy márkákat

Kép-videó tippek

  • Kiváló minőségű forrásképek használata (min 1024 képpont)
  • Egyezzen meg a képarányt a kivágás elkerülése érdekében
  • Írja le a jelenet valósághű mozgását
  • Vegye figyelembe a fizikát és a természetes mozgást

Webhook integráció

  • A videók automatikusan R2-ben tárolódnak CDN-kézbesítéssel
  • A generálás befejezésekor e-mail értesítést küldünk
  • Frissítésekért 30 másodpercenként kérje le az állapotvégpontot
  • A sikertelen generációk automatikusan visszatérítik a jóváírásokat

⚠️ Hibakódok

400 Érvénytelen kérési paraméterek vagy túl hosszú a prompt
401 Érvénytelen vagy hiányzó API kulcs
402 Elégtelen kredit
422 Tartalmi irányelvek megsértése
429 Túllépte a sebességkorlátot (maximum 10 egyidejűleg)
500 Szerverhiba – a jóváírásokat visszatérítjük

💻 Kódpéldák

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();

🚀 Kezdésre készen állsz?

Ellenőrizze fiókjában az aktuális hitelajánlatokat.