Hopp til innholdet

UlazAI utviklerdokumenter

Sora 2 API: videogenerering, priser og tilgang

Sora 2 API: videogenerering, priser og tilgang

Generer Sora 2-videoer gjennom UlazAI med klare endepunkter, kredittprising, spørsmålsregler, statuspolling og CDN-utdatahåndtering.

Sjekk gjeldende Sora-modellpris og eventuelle aktive kontotilbud før generering.

✨ Sora 2-funksjoner

✅ Tekst-til-video generasjon

✅ Bilde-til-video animasjon

✅ Varighetsalternativer vist av gjeldende API-rute

✅ Utgangsinnstillinger vist i gjeldende API-dokumentasjon

✅ Støttet sideforhold avhenger av den valgte ruten

✅ Asynkron prosessering med statusmåling

✅ Automatisk R2-lagring med CDN

✅ E-postvarsler når ferdig

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

Generer video fra tekst

Lag en 10-sekunders video fra en tekstmelding ved å bruke Sora 2.

Forespørselsorgan

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

Parametere

prompt * (streng)

Tekstbeskrivelse av videoen som skal genereres. Maks 5000 tegn. Vær beskrivende for best resultat.

aspect_ratio (streng)

Videosideforhold. Alternativer: landscape (16:9), portrait (9:16), square (1:1). Standard: landscape

kvalitet (streng)

Forhåndsinnstilt kvalitet. Alternativer: standard, high. Høy kvalitet bruker mer behandlingstid. Standard: standard

prompt_directory_optin (boolsk) 💰 -10 KREDITTER

Del videoen din til vår offentlige promptkatalog og få 10 kreditter rabatt! Standard: true

Suksessrespons (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"
  }
}

Eksempel på cURL

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/

Generer video fra bilde

Animer et statisk bilde til en 10-sekunders video ved hjelp av Sora 2.

Forespørselsorgan

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

Parametere

image_url * (streng)

URL til kildebildet som skal animeres. Må være offentlig tilgjengelig. Støttede formater: JPG, PNG, WebP.

prompt * (streng)

Beskrivelse av hvordan du animerer bildet. Maks 5000 tegn.

aspect_ratio (streng)

Må samsvare med kildebildets sideforhold for best resultat.

kvalitet (streng)

Forhåndsinnstilt kvalitet. Standard: standard

prompt_directory_optin (boolsk) 💰 -10 KREDITTER

Del videoen din til vår offentlige promptkatalog og få 10 kreditter rabatt! Standard: true

FÅ /api/v1/sora/status/{task_id}/

Sjekk generasjonsstatus

Få den nåværende statusen og resultatet av en Sora-videogenereringsoppgave.

Responsstater

Behandling

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

Suksess

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

Mislyktes

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

Eksempel på cURL

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

🔑 Sora 2 API tilgang: offisiell vs UlazAI

Sora 2 API tilgang avhenger av leverandøren, organisasjonsbekreftelsen og kontonivået. Bekreft gjeldende tilgang og priser før integrering.

Offisiell OpenAI API

  • Invitasjon / organisasjonsbekreftelse lukket
  • Fakturert per sekund av video
  • Du administrerer din egen OpenAI-nøkkel og kvoter

Sora 2 på UlazAI

  • Ring det nå med én UlazAI API nøkkel - ingen separat invitasjon
  • Priset i delte kreditter, refundert ved mislykkede jobber
  • Samme nøkkel kaller også Veo 3, Seedance og Kling - sammenlign kostnad og ventetid fra én balanse

Vil du veie Sora 2 mot alternativene først? Se 2026 AI-videomodellveiledning.

💰 Sora 2 Priser

Tekst-til-video

Sjekk gjeldende API-priser

for valgt varighet og modell

• Sjekk gjeldende utgangsinnstillinger

• Sjekk støttede sideforhold

• Behandlingstiden varierer etter kø

Bilde-til-video

Sjekk gjeldende API-priser

for bilde-til-video

• Last opp et støttet bilde du kan bruke

• Tilpassede bevegelsesmeldinger

• Behandlingstiden varierer etter kø

Beregn batchen din fra gjeldende modellkostnad og forventet gjentatt forsøksfrekvens.

📚 Beste praksis

Spørre retningslinjer

  • Vær spesifikk om kamerabevegelser (panorering, zoom, tilt)
  • Beskriv lys og atmosfære
  • Inkluder karakterhandlinger og uttrykk
  • Angi timing for viktige øyeblikk
  • Unngå opphavsrettsbeskyttede tegn eller merker

Tips til bilde-til-video

  • Bruk kildebilder av høy kvalitet (minst 1024 piksler)
  • Match sideforhold for å unngå beskjæring
  • Beskriv realistisk bevegelse for scenen
  • Vurder fysikk og naturlig bevegelse

Webhook-integrasjon

  • Videoer lagres automatisk i R2 med CDN-levering
  • E-postvarsler sendes når genereringen er fullført
  • Poll statusendepunktet hvert 30. sekund for oppdateringer
  • Mislykkede generasjoner refunderer automatisk kreditter

⚠️ Feilkoder

400 Ugyldige forespørselsparametere eller for lang forespørsel
401 Ugyldig eller manglende API-nøkkel
402 Utilstrekkelig kreditter
422 Brudd på retningslinjene for innhold
429 Frekvensgrensen er overskredet (maks 10 samtidig)
500 Serverfeil - kreditter vil bli refundert

💻 Kodeeksempler

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

🚀 Klar til å starte?

Sjekk kontoen din for gjeldende kreditttilbud.