Videogenerierung

Erstelle Videos mit Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse und MiniMax aus einem Prompt, einem Startbild (und optional einem Endbild) oder Referenzbildern, Videos und Audio. Videos brauchen ein paar Minuten: Starte die Generierung und prüfe später das Ergebnis.

Starten, Status prüfen, herunterladen

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

Alle Videomodelle funktionieren gleich: Ändere model, der Rest der Anfrage bleibt gleich. In den Modell-Guides erfährst du, wofür sich jedes Modell am besten eignet: Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu und PixVerse.

Parameter

Mit Bildern starten

Erstes und letztes Frame

Animiere ein Standbild: Das Video beginnt genau mit first_frame. Mit last_frame endet es bei diesem Bild – so bestimmst du Anfang und Ende der Aufnahme. MiniMax starts stattdessen aus Referenzbildern.

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

Referenzbilder

Gib bis zu 10 Bilder (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu und PixVerse take none) an und erwähne sie im Prompt der Reihe nach (@Image1, @Image2…): Die Personen, Produkte und Orte darauf erscheinen im Video.

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

Referenzvideos und Audio

Nutze Videos als Vorlage für das Aussehen und die Bewegungen einer Person, eine Kamerafahrt oder eine Szene. Audio dient als Vorlage für eine Stimme, Melodie oder Soundeffekte. Erwähne sie im Prompt der Reihe nach, wie Bilder: @Video1, @Audio1. Du kannst sie mit Referenzbildern kombinieren, aber nicht mit einem ersten Frame.

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

Das Modell verarbeitet jede Sekunde eines Referenzvideos. Diese Sekunden werden ebenfalls berechnet, zu einem Teil des Preises pro Sekunde: Ein 5 s langes Video mit einer 10 s langen Referenz kostet die 5 Sekunden des Videos plus 10 Referenzsekunden. Referenz-Audio kostet nichts extra. Jedes Videoobjekt zeigt die berechneten Referenzsekunden (reference_seconds).

Video bearbeiten und verlängern

Setze reference_mode auf edit, um ein Referenzvideo zu bearbeiten (eine Person oder ein Objekt austauschen, etwas hinzufügen oder entfernen, die Musik ändern), oder auf extend, um es vorwärts oder rückwärts fortzusetzen. Beschreibe im Prompt, was passieren soll: „Ersetze das Auto in @Video1 durch das aus @Image1“, „Setze @Video1 fort, während die Tänzerin die Bühne verlässt“.

• Beim Bearbeiten bleiben Format und Länge des Videos erhalten. Lass daher aspect_ratio und seconds weg. Berechnet wird die Länge des längsten Referenzvideos; dieses muss 4 bis 30 Sekunden lang sein.
• Beim Verlängern bleibt das Videoformat erhalten; mit seconds legst du die Länge des neuen Videos fest.
• Ohne reference_mode entscheidet das Modell anhand des Prompts. Ein Prompt, der wie eine Bearbeitung klingt, kann mit gesetztem seconds oder aspect_ratio fehlschlagen (fehlgeschlagene Videos sind kostenlos).

Regeln für Bilder

• PNG, JPEG oder WebP, als öffentlicher https-Link oder Daten-URL, bis zu 10 MB.
• 300 bis 6000 Pixel pro Seite und höchstens im Seitenverhältnis 5:2. Daten-URLs außerhalb dieser Grenzen werden sofort mit einer Begründung abgelehnt. Links werden beim Start des Videos abgerufen: Führt ein Link zu keinem verwendbaren Bild, schlägt das Video mit invalid_image fehl – kostenlos.
• Entweder Frames oder Referenzen, nicht beides in einer Anfrage.
• Anfragen sind JSON: Bilder werden als Links oder Daten-URLs übergeben, nicht als Multipart-Uploads.

Das Videoobjekt

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

Weitere Endpunkte

Videokosten

Ein Video kostet den Sekundenpreis (je nach Auflösung) mal seine Länge; Kling und PixVerse cost weniger pro Sekunde ohne Ton; Sekunden von Referenzvideos werden zu einem Teil dieses Preises berechnet. Wenn du es startest, wird der Preis von deinem Guthaben reserviert. Abgebucht wird erst, wenn das Video fertig ist. Schlägt es fehl, wird der Betrag wieder freigegeben. Ein fehlgeschlagenes Video ist kostenlos.