UlazAI API Dokumentation
Vollständige API-Referenz
Vollständige Dokumentation aller UlazAI API Endpunkte, Authentifizierungsmethoden und Fehlerbehandlung.
📋 Inhaltsverzeichnis
🔐 Authentifizierung
UlazAI unterstützt zwei Authentifizierungsmethoden: Token-Authentifizierung Und API Schlüsselauthentifizierung.
/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
}
}
/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
}
}
/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
/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
/api/v1/generate/history/
Authentifizierung erforderlich
Holen Sie sich Ihre Generationengeschichte
Abfrageparameter
?limit=20&offset=0&type=image
🎬 Videogenerierung
/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 →
/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 →
/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 →
/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 →
/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 →
/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
/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
/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
/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"
}
/api/profile/
Authentifizierung erforderlich
Benutzerprofileinstellungen aktualisieren
Anforderungstext
{
"enable_watermark": true,
"watermark_text": "MyBrand.com"
}
💳 Zahlungen und Gutschriften
/Zahlungen/api/Credits/
Authentifizierung erforderlich
Aktuellen Guthabenstand abrufen
Antwort (200 OK)
{
"credits_balance": 92,
"total_spent": "25.00",
"total_credits_purchased": 2400
}
/zahlungen/api/transaktionen/
Authentifizierung erforderlich
Transaktionsverlauf abrufen
❌ Fehlerbehandlung
Standard-Fehlerantwortformat
{
"success": false,
"error": "Error message here",
"details": {
"field_name": "Specific field error"
}
}
Ungültige Anforderungsparameter
Die Anfrage ist fehlerhaft oder es fehlen erforderliche Felder
Fehlende oder ungültige Authentifizierung
Kein gültiges Authentifizierungstoken oder API-Schlüssel angegeben
Unzureichende Credits
Nicht genügend Credits, um den angeforderten Vorgang abzuschließen
Zugriff verweigert
Sie haben keine Berechtigung, auf diese Ressource zuzugreifen
Ressource nicht gefunden
Die angeforderte Ressource existiert nicht
Ratenlimit überschritten
Zu viele Anfragen in kurzer Zeit. Bitte fahren Sie langsamer
Serverfehler
Bei uns ist etwas schief gelaufen. Bitte versuchen Sie es erneut
🚦 Ratenbeschränkungen
📝 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