UlazAI API Dokumentation

Vollständige API-Referenz

Vollständige Dokumentation aller UlazAI API Endpunkte, Authentifizierungsmethoden und Fehlerbehandlung.

🔐 Authentifizierung

UlazAI unterstützt zwei Authentifizierungsmethoden: Token-Authentifizierung Und API Schlüsselauthentifizierung.

POST /api/register/

Erstellen Sie ein neues Benutzerkonto

Anforderungstext

{
  "username": "johndoe",
  "email": "[email protected]",
  "password": "secure_password123"
}

Antwort (201 erstellt)

{
  "token": "your-auth-token-here",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 0
  }
}
POST /api/login/

Melden Sie sich mit Benutzername und Passwort an, um ein Authentifizierungstoken zu erhalten

Anforderungstext

{
  "username": "johndoe",
  "password": "secure_password123"
}

Antwort (200 OK)

{
  "token": "your-auth-token-here",
  "user": {
    "id": 1,
    "username": "johndoe",
    "email": "[email protected]",
    "credits_balance": 100
  }
}
POST /api/api-Tasten/ Authentifizierung erforderlich

Erstellen Sie einen neuen API-Schlüssel zur Authentifizierung

Anforderungsheader

Authorization: Token your-auth-token-here

Anforderungstext

{
  "name": "Production API Key"
}

Antwort (201 erstellt)

{
  "id": "uuid-here",
  "name": "Production API Key",
  "key": "ulazai_live_abc123...", // Only shown once!
  "key_preview": "ulazai_li...",
  "created_at": "2025-01-15T10:00:00Z"
}

⚠️ Wichtig: Der vollständige API-Schlüssel wird beim Erstellen nur einmal angezeigt. Bewahren Sie es sicher auf!

Authentifizierung verwenden

Token-Authentifizierung

Authorization: Token your-auth-token-here

API Schlüsselauthentifizierung

Authorization: Bearer ulazai_live_abc123...

🎨 Bilderzeugung

POST /api/v1/generate/ Authentifizierung erforderlich

Generieren Sie ein neues Bild aus einer Textaufforderung

Anforderungstext

{
  "prompt": "A beautiful sunset over mountains with a lake in foreground",
  "size": "3:2"  // Options: "1:1", "3:2", "2:3"
}

Antwort (201 erstellt)

{
  "success": true,
  "data": {
    "generation_id": "uuid-here",
    "status": "processing",
    "credits_used": 8,
    "credits_remaining": 92,
    "message": "Image generation started successfully"
  }
}

Kreditkosten

Alle Bildgrößen kosten 8 Credits pro Generation

GET /api/v1/generate/history/ Authentifizierung erforderlich

Holen Sie sich Ihre Generationengeschichte

Abfrageparameter

?limit=20&offset=0&type=image

🎬 Videogenerierung

POST /api/v1/generate/video/ Authentifizierung erforderlich

Erstellen Sie ein neues Video aus Text oder Bild

Anforderungstext

{
  "prompt": "A cat playing in a garden",
  "video_model": "veo3_fast",  // Options: "veo3_fast", "veo3"
  "aspect_ratio": "16:9",      // Options: "16:9", "9:16"
  "watermark_text": "MyBrand", // Optional, max 50 chars
  "source_image_urls": [],     // Optional, for image-to-video
  "prompt_directory_optin": true  // 💰 Get 10 credits discount! (default: true)
}

💰 Sparen Sie 10 Credits: Satz prompt_directory_optin: true um Ihr Video in unserem öffentlichen Prompt-Verzeichnis zu teilen und 10 Credits Rabatt auf jede Generation zu erhalten!

Kreditkosten

veo3_fast (16:9): 130 Credits

veo3_fast (9:16): 150 Credits

veo3 (alle Verhältnisse): 300 Credits

🎬 Google Veo 3.1 API NEU

NEU: Google Veo 3.1 mit Frame-Kontrolle, Wasserzeichen und 99 % Erfolgsrate. Vollständige Dokumentation anzeigen →

POST /veo31/api/generate/ Authentifizierung erforderlich

Erzeugen Sie 8-Sekunden-Videos mit Google Veo 3.1 – Mit Steuerung für das erste und letzte Bild

Anforderungstext

{
  "prompt": "A golden retriever running through flowers at sunset",
  "model": "veo3_fast",           // "veo3_fast" or "veo3"
  "aspectRatio": "16:9",          // "16:9", "9:16", "Auto"
  "imageUrls": [],                // Optional: 1-2 frame images
  "watermark": "MyBrand",         // Optional: max 50 chars
  "enableFallback": false,        // +200 credits for 99% success
  "enableTranslation": true       // Auto-translate to English
}

Kreditkosten

Veo 3.1 Schnell: 100 Credits (Generation 30–45)

Veo 3.1 Qualität: 250 Credits (45-60 s, bessere Qualität)

Fallback-Modus: +200 Credits (optional, 99 % Erfolg)

Antwort (201 erstellt)

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123",
    "status": "processing",
    "model": "veo3_fast",
    "credits_charged": 100,
    "estimated_time": "30-45 seconds"
  }
}

Überprüfen Sie den Status

GET /veo31/api/status/{task_id}/

Antwort:
{
  "success": true,
  "data": {
    "status": "completed",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "resolution": "1080p",
    "duration": 8
  }
}

📖 Vollständige Dokumentation: Sehen Veo 3.1 API Dokumente für detaillierte Beispiele, Rahmensteuerung und weitere Funktionen.

🎬 Kling 3.0 API NEU

🆕 Kling 3.0: Preise pro Sekunde, natives Audio, Multi-Shot-Eingabeaufforderung und Start-/Endbildsteuerung. Vollständige Dokumentation anzeigen →

POST /kling30/api/generate/ Authentifizierung erforderlich

Erstellen Sie 3–15 Sekunden lange Clips im Text-zu-Video- oder Bild-zu-Video-Modus.

Anforderungstext

{
  "prompt": "A dramatic low-angle hero reveal with rain and neon reflections",
  "generationMode": "text_to_video",
  "durationSeconds": 8,
  "qualityMode": "pro",
  "sound": true,
  "multiShots": true,
  "aspectRatio": "16:9",
  "prompt_directory_optin": true
}

Kreditkosten

Standard ohne Audio: 20 Credits / Sekunde

Standardmäßig mit Audio: 30 Credits / Sekunde

Pro Nicht-Audio: 27 Credits / Sekunde

Profi mit Audio: 40 Credits / Sekunde

📖 Vollständige Dokumentation: Sehen Kling 3.0 API Dokumente für Anfragefelder, Statusformat und Beispiele.

🎬 Kling 2.6 API BESTER PREIS

💰 Günstigste Option: Ab nur 55 Credits für 5-Sekunden-Videos mit nativer Audiounterstützung. Vollständige Dokumentation anzeigen →

POST /kling26/api/generate/ Authentifizierung erforderlich

Erstellen Sie 5–10 Sekunden lange Videos mit optionalem nativem Audio

Anforderungstext

{
  "prompt": "A dog running through a field at sunset",
  "generationMode": "text_to_video",  // or "image_to_video"
  "duration": "5",                     // "5" or "10" seconds
  "aspectRatio": "16:9",               // "16:9", "9:16", "1:1"
  "sound": false,                      // Native audio (doubles cost)
  "imageUrls": [],                     // Required for image_to_video
  "prompt_directory_optin": true       // 💰 Get 10 credits discount!
}

💰 Sparen Sie 10 Credits: Satz prompt_directory_optin: true um Ihr Video in unserem öffentlichen Prompt-Verzeichnis zu teilen und einen Rabatt von 10 Credits zu erhalten!

Kreditkosten

5s ohne Ton: 55 Credits

10s ohne Ton: 110 Credits

5s mit Audio: 110 Credits

10s mit Audio: 220 Credits

📖 Vollständige Dokumentation: Sehen Kling 2.6 API Dokumente für detaillierte Beispiele und Parameter.

🎬 Sora 2 API OPENAI

🚀 OpenAI Sora 2: Premium-10-Sekunden-Videos mit 1080p und unglaublicher Qualität. Vollständige Dokumentation anzeigen →

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

Generieren Sie 10-sekündige 1080p-Videos mit OpenAI Sora 2

Anforderungstext

{
  "prompt": "A serene mountain landscape at sunrise with birds flying",
  "aspect_ratio": "landscape",  // "landscape", "portrait", "square"
  "quality": "standard",        // "standard" or "high"
  "prompt_directory_optin": true  // 💰 Get 10 credits discount!
}

💰 Sparen Sie 10 Credits: Satz prompt_directory_optin: true um Ihr Video in unserem öffentlichen Prompt-Verzeichnis zu teilen und einen Rabatt von 10 Credits zu erhalten!

Kreditkosten

Text-zu-Video: 80 Credits pro Video

Bild-zu-Video: 80 Credits pro Video

📖 Vollständige Dokumentation: Sehen Sora 2 API Dokumente für detaillierte Beispiele, Bild-zu-Video und mehr.

🎬 Seedance 1.5 Pro API AUDIO-VIDEO

🎬 Seedance 1.5 Pro: Kinoreife Audio-Video-Generierung mit 4–12 Sekunden langen Clips, 480p/720p-Auflösung und optionalem nativem Audio. Vollständige Dokumentation anzeigen →

POST /seedance/generieren/ Authentifizierung erforderlich

Generieren Sie Seedance 1.5 Pro-Videos mit optionalen Eingabebildern und Audio.

Anforderungstext

{
  "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "prompt_directory_optin": true
}

💰 Verzeichnisrabatt: 10 Credits Rabatt für höherstufige Optionen (28+ Credits), wenn prompt_directory_optin: true.

Kreditkosten

480p: 8/14 (4s), 14/28 (8s), 19/38 (12s) Credits

720p: 14/28 (4s), 28/56 (8s), 42/84 (12s) Credits

• Audiokosten werden in jedem Paar als höherer Wert angezeigt

📖 Vollständige Dokumentation: Sehen Seedance 1.5 Pro API Dokumente für vollständige Parameter und Beispiele.

🎬 Wan 2.6 API T2V/I2V/V2V

🎬 Wan 2.6: Alibabas filmisches Multi-Shot-Videomodell mit T2V-, I2V- und V2V-Modi, nativem Audio und bis zu 15 Sekunden langen Videos. Probieren Sie Wan 2.6 Playground → aus

POST /wan26/generate/ Authentifizierung erforderlich

Erzeugen Sie Videos mit Wan 2.6 – unterstützt die Modi Text-zu-Video, Bild-zu-Video und Video-zu-Video

Anforderungstext

{
  "prompt": "A cinematic shot of a woman walking through Tokyo at night",
  "mode": "text-to-video",  // or "image-to-video", "video-to-video"
  "duration": "5",          // "5", "10", or "15" seconds
  "resolution": "1080p",    // "720p" or "1080p"
  "image_url": "...",       // Required for image-to-video
  "video_url": "..."        // Required for video-to-video
}

Kreditkosten

720p: 70 (5 Sek.) / 140 (10 Sek.) / 210 (15 Sek.) Credits

1080p: 105 (5 Sek.) / 210 (10 Sek.) / 315 (15 Sek.) Credits

📖 Probieren Sie es jetzt aus: Besuchen Sie die Wan 2.6 Spielplatz Ausführliche Beispiele, I2V-, V2V-Modi und mehr.

📊 Statusprüfung

GET /api/v1/generate/{generation_id}/ Authentifizierung erforderlich

Überprüfen Sie den Status einer beliebigen Generation (Bild oder Video).

Antwort (200 OK)

{
  "id": "uuid-here",
  "generation_type": "video",
  "status": "completed",
  "prompt": "A cat playing in a garden",
  "video_url": "https://cdn.ulazai.com/videos/...",
  "video_model": "veo3_fast",
  "credits_used": 130,
  "created_at": "2025-01-15T10:00:00Z",
  "completed_at": "2025-01-15T10:01:30Z"
}

👤 Benutzerverwaltung

GET /api/profile/ Authentifizierung erforderlich

Erhalten Sie aktuelle Benutzerprofilinformationen

Antwort (200 OK)

{
  "id": 1,
  "username": "johndoe",
  "email": "[email protected]",
  "credits_balance": 92,
  "total_images_generated": 12,
  "enable_watermark": true,
  "watermark_text": "MyBrand",
  "created_at": "2025-01-10T08:00:00Z"
}
SETZEN /api/profile/ Authentifizierung erforderlich

Benutzerprofileinstellungen aktualisieren

Anforderungstext

{
  "enable_watermark": true,
  "watermark_text": "MyBrand.com"
}

💳 Zahlungen und Gutschriften

GET /Zahlungen/api/Credits/ Authentifizierung erforderlich

Aktuellen Guthabenstand abrufen

Antwort (200 OK)

{
  "credits_balance": 92,
  "total_spent": "25.00",
  "total_credits_purchased": 2400
}
GET /zahlungen/api/transaktionen/ Authentifizierung erforderlich

Transaktionsverlauf abrufen

❌ Fehlerbehandlung

Standard-Fehlerantwortformat

{
  "success": false,
  "error": "Error message here",
  "details": {
    "field_name": "Specific field error"
  }
}
400 Ungültige Anfrage Ungültige Anforderungsparameter

Die Anfrage ist fehlerhaft oder es fehlen erforderliche Felder

401 Nicht autorisiert Fehlende oder ungültige Authentifizierung

Kein gültiges Authentifizierungstoken oder API-Schlüssel angegeben

402 Zahlung erforderlich Unzureichende Credits

Nicht genügend Credits, um den angeforderten Vorgang abzuschließen

403 Verboten Zugriff verweigert

Sie haben keine Berechtigung, auf diese Ressource zuzugreifen

404 Nicht gefunden Ressource nicht gefunden

Die angeforderte Ressource existiert nicht

429 Zu viele Anfragen Ratenlimit überschritten

Zu viele Anfragen in kurzer Zeit. Bitte fahren Sie langsamer

500 Interner Serverfehler Serverfehler

Bei uns ist etwas schief gelaufen. Bitte versuchen Sie es erneut

🚦 Ratenbeschränkungen

Authentifizierte Benutzer 100 Anfragen/Minute
Demo-Benutzer 10 Anfragen/Stunde
Gleichzeitige Generationen 5 pro Benutzer

📝 Vollständiges Beispiel

Python-Beispiel

import requests
import time

# Konfiguration
API_KEY = "ulazai_live_your_api_key_here"
BASE_URL = "https://ulazai.com"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Erstelle ein Video
video_data = {
    "prompt": "A beautiful sunset timelapse over the ocean",
    "video_model": "veo3_fast",
    "aspect_ratio": "16:9",
    "watermark_text": "MyBrand"
}

response = requests.post(f"{BASE_URL}/api/v1/generate/video/", 
                        json=video_data, headers=headers)

if response.status_code == 201:
    Ergebnis = Antwort.json()
    generation_id = result["data"]["generation_id"]
    print(f"Videogenerierung gestartet: {generation_id}")
    
    # Statusumfrage
    while True:
        status_response = requests.get(
            f"{BASE_URL}/api/v1/generate/{generation_id}/", 
            Header=Header
        )
        status_data = status_response.json()
        
        if status_data["status"] == "abgeschlossen":
            print(f"Video bereit: {status_data['video_url']}")
            break
        elif status_data["status"] == "fehlgeschlagen":
            print(f"Generierung fehlgeschlagen: {status_data.get('error_message')}")
            break
        
        print(f"Status: {status_data['status']}...")
        time.sleep(10) # Warten Sie 10 Sekunden vor der nächsten Prüfung
sonst:
    print(f"Fehler: {response.json()}")

🤝 Brauchen Sie Hilfe?

• WhatsApp: Fragen Sie uns alles

• Dokumentation: docs.ulazai.com