Sora API — KI-Video generieren am OpenAI-artigen Endpoint (heute mit Veo 3.1)

Sora ist OpenAIs Text-zu-Video-Modell, und “die Sora API” ist der Weg, mit dem Teams Video programmatisch erzeugen statt über die Consumer-App. Bei Kunavo läuft Text-zu-Video heute über Google Veo 3 an einem OpenAI-artigen Video-Endpoint — Sora-Zugang steht auf der Roadmap, und da der Endpoint modellunabhängig ist, ist der spätere Wechsel zu Sora eine Ein-Wort-Änderung. Diese Anleitung zeigt den Workflow mit Veo 3, damit jedes Beispiel sofort läuft.

Was ist die Sora API?

Sora (Sora 2 und Sora 2 Pro) macht aus einem Text-Prompt — oder einem Standbild — einen kurzen Videoclip, bei Sora 2 mit synchronem Ton. Die API-Form lässt Sie die Generierung in eine Pipeline skripten: Marketing-Shots, Produktanimationen, B-Roll, Storyboard-Vorschauen. Die Form ist über moderne Videomodelle hinweg gleich: Prompt und Parameter senden, eine gehostete Video-URL zurückbekommen.

Video bei Kunavo heute: Veo 3

Kunavo stellt die Videogenerierung über einen einzigen OpenAI-artigen Endpoint bereit, /v1/video/generations. Sora ist im Katalog noch nicht aktiviert; das aktive Text-zu-Video-Modell ist Google Veo 3, das cinematische Clips mit nativem Ton erzeugt. Die Beispiele unten verwenden veo-3 — wenn Sora kommt, ist die einzige Änderung das model-Feld.

Text-zu-Video Quickstart

Ein POST mit Ihrem Kunavo-Key. Die Generierung kann ein paar Minuten dauern, deshalb hält der synchrone Aufruf die Verbindung, bis der Clip fertig ist:

import os

import requests

API_KEY = os.environ["KUNAVO_API_KEY"]

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # die Generierung kann Minuten dauern
)
print(resp.json()["data"][0]["url"])

duration (in Sekunden) legt die Cliplänge bei den Modellen mit sekundengenauer Abrechnung fest: den Seedance-Modellen und Wan 2.7. Die Veo-Modelle ignorieren den Wert; jeder Veo-Clip ist 8 Sekunden lang und wird pro Video abgerechnet.

Bild-zu-Video

Um ein Standbild zu animieren, übergeben Sie image_url (eine https-URL oder eine Datei, die Sie nach /v1/files hochgeladen haben) zusammen mit dem Prompt. Für kontrollierte Bewegung können Sie mit image_urls und image_mode: "frame" einen ersten und letzten Frame übergeben. Vollständige Beispiele stehen in den Video-Docs.

Asynchroner Task-Lebenszyklus

In Produktion sollten Sie keine 10-Minuten-Verbindung offen halten. Reichen Sie einen Task an /v1/videos ein, bekommen Sie sofort eine Task-ID zurück und pollen Sie dann GET /v1/videos/{id}, bis er fertig ist. Ergebnis-URLs sind dauerhaft.

# Produktion: Task einreichen, dann pollen — keine langlebige Verbindung.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # eine Wiederholung liefert denselben Task
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# dann GET /v1/videos/{task["id"]} pollen, bis er fertig ist

Die Video-Docs behandeln die komplette Polling-Schleife, Idempotency-Keys und Webhook-Zustellung.

Preise

Veo 3 wird pro Video abgerechnet (hier pro 8-Sekunden-Clip in 720p), rund 50–70% unter Googles Listenpreis. Höhere Auflösungen kosten mehr — die vollständige Stufen-Tabelle steht auf der Preisseite.

Prompting-Tipps für Video

• Beschreiben Sie die Einstellung, nicht nur das Motiv. Kamerabewegung (Dolly, Schwenk, Push-in), Objektivanmutung, Beleuchtung und Tempo zählen mehr als Adjektive.
• Setzen Sie das Seitenverhältnis explizit — 16:9 für Querformat, 9:16 für Hochformat/Social.
• Jeder Veo-Clip ist 8 Sekunden lang. Planen Sie jede Aufnahme für diese Länge und fügen Sie für längere Sequenzen mehrere Generierungen aneinander.
• Nutzen Sie einen Referenz-Frame (Bild-zu-Video), wenn eine bestimmte Figur oder ein Produkt konsistent bleiben soll.

Häufig gestellte Fragen