UlazAI API Dokumentation

Google Veo 3.1 Videogenerierung API

Erstellen Sie filmische KI-Videos mit dem neuesten Veo 3.1-Modell von Google – mit Frame-Steuerung, Wasserzeichen und einer Erfolgsquote von 99% s.

✨ NEU: Veo 3.1 Schnell (100 Credits) und Qualität (250 Credits) jetzt mit First- und Last-Frame-Steuerung verfügbar!

✨ Veo 3.1 Funktionen

✅ Zwei Qualitätsmodi - Schnell (30–45 Sek.) und Qualität (45–60 Sek.)

✅ Rahmenkontrolle - Stellen Sie das erste und letzte Einzelbild ein

✅ Text-zu-Video Und Bild-zu-Video

✅ 8-Sekunden-Videos mit nativem Audio

✅ Unterstützung für Wasserzeichen - Markentext hinzufügen

✅ 99 % Erfolgsquote mit Fallback-Modus

✅ Automatische Übersetzung ins Englische

✅ Mehrere Seitenverhältnisse (16:9, 9:16, Auto)

💰 Preise

⚡ Veo 3.1 Schnell

100 Credits

~0,92 $ pro Video

30-45 zweite Generation

💎 Veo 3.1 Qualität

250 Credits

~2,31 $ pro Video

45-60 zweite Generation

🛡️ Fallback-Modus

+200 Credits

Optionales Add-on

99 % Erfolgsgarantie

POST /veo31/api/generate/

Veo 3.1 Video generieren

Erstellen Sie ein 8-Sekunden-Video mit Google Veo 3.1 unter Verwendung von Textansagen und optionalen Bildrahmen.

Anforderungstext

{
  "prompt": "A golden retriever running through a field of flowers at sunset",
  "model": "veo3_fast",           // Options: "veo3_fast", "veo3"
  "aspectRatio": "16:9",          // Options: "16:9", "9:16", "Auto"
  "imageUrls": [],                // Optional: Array of 1-2 image URLs
  "seeds": 42069,                 // Optional: 10000-99999 for reproducible results
  "watermark": "UlazAI",          // Optional: Max 50 characters
  "enableFallback": false,        // Optional: +200 credits for 99% success
  "enableTranslation": true       // Optional: Auto-translate to English
}

Parameter

prompt * (Zeichenfolge)

Textbeschreibung des zu generierenden Videos. Maximal 5000 Zeichen. Beschreiben Sie Aktionen, Kamerabewegungen und Atmosphäre.

Modell * (Zeichenfolge)

Zu verwendendes Modell: veo3_fast (100 Credits, 30-45 s) oder veo3 (250 Credits, 45–60 Sekunden, bessere Qualität)

Aspektverhältnis (Zeichenfolge)

Video-Seitenverhältnis: 16:9 (Landschaft), 9:16 (Porträt), Auto (automatisch). Standard: 16:9

imageUrls (Array)

Optionales Array von 1–2 Bild-URLs zur Frame-Steuerung:
• 1 Bild: Das Video dreht sich um dieses Bild
• 2 Bilder: Videoübergänge vom ersten zum letzten Bild
Maximal 10 MB pro Bild, nur JPG/PNG

Samen (ganze Zahl)

Optionales Seed für reproduzierbare Ergebnisse. Bereich: 10000-99999

Wasserzeichen (Zeichenfolge)

Optionaler Wasserzeichentext zum Überlagern des Videos. Maximal 50 Zeichen. Ideal zum Branding.

enableFallback (Boolescher Wert)

Aktivieren Sie den Fallback-Modus (+200 Credits). Verwendet automatisch ein Sicherungsmodell, wenn Inhaltsrichtlinien ausgelöst werden. 99 % Erfolgsquote. Standard: false

enableTranslation (Boolescher Wert)

Übersetzen Sie die Eingabeaufforderung automatisch ins Englische, um optimale Ergebnisse zu erzielen. Unterstützt alle Sprachen. Standard: true

Erfolgsantwort (201)

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "processing",
    "model": "veo3_fast",
    "credits_charged": 100,
    "credits_remaining": 900,
    "estimated_time": "30-45 seconds",
    "message": "Veo 3.1 video generation started successfully"
  }
}

Fehlerreaktion (400)

{
  "success": false,
  "error": "Insufficient credits. Required: 100, Available: 50"
}

cURL-Beispiel – Text-zu-Video

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A golden retriever running through a field of flowers at sunset, slow motion, cinematic lighting",
    "model": "veo3_fast",
    "aspectRatio": "16:9",
    "watermark": "MyBrand",
    "enableTranslation": true
  }'

cURL-Beispiel – Bild-zu-Video mit Frame-Steuerung

curl -X POST https://ulazai.com/veo31/api/generate/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The character slowly turns their head and smiles at the camera",
    "model": "veo3",
    "aspectRatio": "16:9",
    "imageUrls": ["https://your-domain.com/start-frame.jpg"],
    "seeds": 42069,
    "enableFallback": true
  }'

Python-Beispiel

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://ulazai.com"

# Video generieren
response = requests.post(
    f"{BASE_URL}/veo31/api/generate/",
    headers={
        "Authorization": f"Token {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A serene mountain lake at sunrise with mist rising from the water",
        "model": "veo3_fast",
        "aspectRatio": "16:9",
        "watermark": "MyBrand"
    }
)

Daten = Antwort.json()
if data["success"]:
    task_id = data["data"]["task_id"]
    print(f"Aufgabe erstellt: {task_id}")
    
    # Umfrage zum Abschluss
    while True:
        status_response = requests.get(
            f"{BASE_URL}/veo31/api/status/{task_id}/",
            headers={"Authorization": f"Token {API_KEY}"}
        )
        
        status_data = status_response.json()
        if status_data["data"]["status"] == "completed":
            video_url = status_data["data"]["video_url"]
            print(f"Video bereit: {video_url}")
            break
        elif status_data["data"]["status"] == "failed":
            print(f"Generierung fehlgeschlagen: {status_data['data']['error_message']}")
            break
        
        time.sleep(5) # Alle 5 Sekunden abfragen
sonst:
    print(f"Fehler: {data['error']}")
GET /veo31/api/status/<task_id>/

Überprüfen Sie den Generierungsstatus

Überprüfen Sie den Status einer Veo 3.1-Videogenerierungsaufgabe.

Antwort – Verarbeitung

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "processing",
    "model": "veo3_fast",
    "prompt": "A golden retriever running through flowers",
    "credits_charged": 100
  }
}

Antwort – Abgeschlossen

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "completed",
    "video_url": "https://cdn.ulazai.com/videos/veo31_abc123.mp4",
    "thumbnail_url": "https://cdn.ulazai.com/videos/veo31_abc123_thumb.jpg",
    "resolution": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9",
    "fallback_used": false,
    "credits_charged": 100
  }
}

Antwort – Fehlgeschlagen

{
  "success": true,
  "data": {
    "task_id": "veo31_abc123def456",
    "status": "failed",
    "error_message": "Content policy violation. Enable fallback mode to retry.",
    "credits_refunded": 100
  }
}

cURL-Beispiel

curl -X GET https://ulazai.com/veo31/api/status/veo31_abc123def456/ \
  -H "Authorization: Token YOUR_API_KEY"
POST /veo31/api/upload-frame/

Rahmenbild hochladen

Laden Sie ein Bild zur Bildsteuerung hoch (erstes oder letztes Bild). Gibt eine URL zur Verwendung im Generierungsendpunkt zurück.

Anfrage (mehrteilig/Formulardaten)

Content-Type: multipart/form-data

Bild: (Binärdateidaten)

Parameter

Bild * (Datei)

Bilddatei zum Hochladen. Maximal 10 MB. Unterstützte Formate: JPG, PNG. Empfohlene Auflösung: 1920x1080 oder höher.

Erfolgsantwort (200)

{
  "success": true,
  "url": "https://cdn.ulazai.com/uploads/frame_abc123.jpg",
  "message": "Image uploaded successfully"
}

cURL-Beispiel

curl -X POST https://ulazai.com/veo31/api/upload-frame/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "image=@/path/to/your/image.jpg"

Statuscodes

200 OK - Anfrage erfolgreich

201 erstellt - Generierungsaufgabe erfolgreich erstellt

400 Ungültige Anfrage - Ungültige Parameter oder unzureichende Credits

401 Nicht autorisiert - Fehlender oder ungültiger API-Schlüssel

404 Nicht gefunden - Aufgaben-ID nicht gefunden

413 Nutzlast zu groß - Das Bild überschreitet die 10-MB-Grenze

429 Zu viele Anfragen - Ratenlimit überschritten

500 Interner Serverfehler - Serverfehler, wenden Sie sich an den Support

Aufgabenstatuswerte

ausstehend – Aufgabe erstellt, wartet auf Start

Verarbeitung - Video wird generiert

vollendet - Videogenerierung erfolgreich, video_url verfügbar

fehlgeschlagen - Generierung fehlgeschlagen, Credits werden automatisch zurückerstattet

💡 Best Practices

Verwenden Sie beschreibende Eingabeaufforderungen

Geben Sie Details zu Aktionen, Kamerabewegungen, Beleuchtung und Atmosphäre an. Beispiel: "Nahaufnahme fallender Wassertropfen in Zeitlupe, Hintergrundbeleuchtung durch goldenen Sonnenuntergang, geringe Schärfentiefe"

Aktivieren Sie Fallback für wichtige Inhalte

Wenn das Video kritisch ist und Sie sich Ausfälle nicht leisten können, aktivieren Sie den Fallback-Modus (+200 Credits) für eine Erfolgsquote von 99% s.

Für die Konsistenz Samen verwenden

Wenn Sie ähnliche Videos neu generieren müssen, verwenden Sie denselben Startwert (10.000–99.999), um konsistentere Ergebnisse zu erzielen.

Rahmensteuerung für das Branding

Laden Sie 1 Bild hoch, um Ihr Video darum herum zu zentrieren, oder 2 Bilder, um einen reibungslosen Übergang zu schaffen. Perfekt für konsistente Charakter- oder Produktvideos.

Status effizient abfragen

Abfrage alle 5 Sekunden im Schnellmodus, 10 Sekunden im Qualitätsmodus. Führen Sie nicht häufiger Umfragen durch, um Ratenbegrenzungen zu vermeiden.

📝 Beispielaufforderungen

✅ Gute Aufforderung

"Ein majestätischer Adler schwebt im Morgengrauen über schneebedeckten Bergen, goldenes Licht beleuchtet seine Flügel, Kamerafahrt in Zeitlupe von unten, filmische Komposition"

✅ Gute Aufforderung

"Nahaufnahme eines Baristas, der Latte Art einschenkt, Dampf steigt aus der Tasse, warme Cafébeleuchtung, geringe Schärfentiefe, Makroobjektivperspektive"

❌ Schlechte Eingabeaufforderung

"Adler fliegt"

Zu vage – es fehlen Details zu Einstellung, Bewegung und Kamerawinkel

Brauchen Sie Hilfe?

Haben Sie Probleme mit den Veo 3.1 API? Wir sind hier, um zu helfen!

Kontaktieren Sie den Support Alle Dokumente anzeigen