Zum Inhalt springen
UlazAI

UlazAI Entwicklerdokumentation

Sora 2 API: Videogenerierung, Preise und Zugang

Preise Armaturenbrett Bildstudio

Sora 2 API: Videogenerierung, Preise und Zugang

Generieren Sie Sora 2-Videos über UlazAI mit klaren Endpunkten, Kreditpreisen, prompt-Regeln, Statusabfrage und CDN-Ausgabeverarbeitung.

Überprüfen Sie vor der Generierung den aktuellen Preis des Sora-Modells und alle aktiven Kontoangebote.

✨ Sora 2-Funktionen

✅ Text-zu-Video Generation

✅ Bild-zu-Video Animation

✅ Daueroptionen angezeigt durch die aktuelle Route API

✅ Ausgabeeinstellungen siehe aktuelle Dokumentation API

✅ Unterstützte Seitenverhältnisse hängen von der gewählten Route ab

✅ Asynchrone Verarbeitung mit Statusabfrage

✅ Automatische R2-Speicherung mit CDN

✅ E-Mail-Benachrichtigungen wenn es fertig ist

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

Video aus Text generieren

Erstellen Sie mit Sora 2 ein 10-Sekunden-Video aus einem Text-Prompt.

Anforderungstext

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

Parameter

prompt * (Zeichenfolge)

Textbeschreibung des zu generierenden Videos. Maximal 5000 Zeichen. Seien Sie beschreibend, um die besten Ergebnisse zu erzielen.

aspect_ratio (Zeichenfolge)

Video-Seitenverhältnis. Optionen: landscape (16:9), portrait (9:16), square (1:1). Standard: landscape

Qualität (Zeichenfolge)

Qualitätsvoreinstellung. Optionen: standard, high. Hohe Qualität benötigt mehr Bearbeitungszeit. Standard: standard

prompt_directory_optin (Boolescher Wert) 💰 -10 CREDITS

Teilen Sie Ihr Video in unserem öffentlichen Prompt-Verzeichnis und erhalten Sie es 10 Credits Rabatt! Standard: true

Erfolgsantwort (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-Beispiel

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/

Video aus Bild generieren

Animieren Sie mit Sora 2 ein statisches Bild in ein 10-Sekunden-Video.

Anforderungstext

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

Parameter

image_url * (Zeichenfolge)

URL des zu animierenden Quellbilds. Muss öffentlich zugänglich sein. Unterstützte Formate: JPG, PNG, WebP.

prompt * (Zeichenfolge)

Beschreibung, wie das Bild animiert wird. Maximal 5000 Zeichen.

aspect_ratio (Zeichenfolge)

Für optimale Ergebnisse muss das Seitenverhältnis des Quellbilds übereinstimmen.

Qualität (Zeichenfolge)

Qualitätsvoreinstellung. Standard: standard

prompt_directory_optin (Boolescher Wert) 💰 -10 CREDITS

Teilen Sie Ihr Video in unserem öffentlichen Prompt-Verzeichnis und erhalten Sie es 10 Credits Rabatt! Standard: true

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

Überprüfen Sie den Generierungsstatus

Erhalten Sie den aktuellen Status und das Ergebnis einer Sora-Videogenerierungsaufgabe.

Antwortzustände

Verarbeitung

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

Erfolg

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

Fehlgeschlagen

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

cURL-Beispiel

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

🔑 Sora 2 API Zugang: offiziell vs. UlazAI

Sora 2 API Zugriff hängt vom Anbieter, der Organisationsüberprüfung und der Kontostufe ab. Überprüfen Sie vor der Integration den aktuellen Zugang und die Preise.

Offizielles OpenAI API

  • Einladungs-/Organisationsüberprüfungs-Gated
  • Wird pro Sekunde Video abgerechnet
  • Sie verwalten Ihren eigenen OpenAI-Schlüssel und Ihre Kontingente

Sora 2 auf UlazAI

  • Rufen Sie es jetzt mit einem UlazAI API-Schlüssel an – keine separate Einladung
  • Der Preis wird in geteilten Credits berechnet und bei fehlgeschlagenen Aufträgen erstattet
  • Derselbe Schlüssel ruft auch Veo 3, Seedance und Kling auf – vergleichen Sie Kosten und Latenz von einer Waage

Möchten Sie Sora 2 zunächst mit den Alternativen abwägen? Siehe die Leitfaden für KI-Videomodelle 2026.

💰 Sora 2 Preise

Text-zu-Video

Überprüfen Sie die aktuellen Preise für API

für die ausgewählte Dauer und das ausgewählte Modell

• Überprüfen Sie die aktuellen Ausgangseinstellungen

• Überprüfen Sie die unterstützten Seitenverhältnisse

• Die Bearbeitungszeit variiert je nach Warteschlange

Bild-zu-Video

Überprüfen Sie die aktuellen Preise für API

für Bild-zu-Video

• Laden Sie ein unterstütztes Bild hoch, das Sie verwenden können

• Benutzerdefinierte Bewegung prompts

• Die Bearbeitungszeit variiert je nach Warteschlange

Berechnen Sie Ihren Batch anhand der aktuellen Modellkosten und der erwarteten Wiederholungsrate.

📚 Empfehlungen

Prompt Richtlinien

  • Machen Sie genaue Angaben zu Kamerabewegungen (Schwenken, Zoomen, Neigen).
  • Beschreiben Sie Licht und Atmosphäre
  • Beziehen Sie Charakteraktionen und -ausdrücke ein
  • Geben Sie den Zeitpunkt für Schlüsselmomente an
  • Vermeiden Sie urheberrechtlich geschützte Charaktere oder Marken

Bild-zu-Video-Tipps

  • Verwenden Sie hochwertige Quellbilder (mindestens 1024 Pixel)
  • Passen Sie das Seitenverhältnis an, um ein Zuschneiden zu vermeiden
  • Beschreiben Sie realistische Bewegungen für die Szene
  • Berücksichtigen Sie Physik und natürliche Bewegung

Webhook-Integration

  • Videos werden automatisch in R2 mit CDN-Lieferung gespeichert
  • E-Mail-Benachrichtigungen werden gesendet, wenn die Generierung abgeschlossen ist
  • Fragen Sie den Statusendpunkt alle 30 Sekunden nach Aktualisierungen ab
  • Bei fehlgeschlagenen Generationen werden Credits automatisch zurückerstattet

⚠️ Fehlercodes

400 Ungültige Anforderungsparameter oder prompt zu lang
401 Ungültiger oder fehlender API-Schlüssel
402 Unzureichende Credits
422 Verstoß gegen die Inhaltsrichtlinien
429 Ratenlimit überschritten (maximal 10 gleichzeitig)
500 Serverfehler – Credits werden zurückerstattet

💻 Codebeispiele

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

🚀 Bereit zum Start?

Konto erstellen Credits kaufen Probieren Sie das Webinterface aus

Überprüfen Sie Ihr Konto auf aktuelle Kreditangebote.