Sora-API-Leitfaden — sofort nutzbare KI-Videogenerierung (Veo 3.1)

Sora ist OpenAIs Text-zu-Video-Modell, und „Sora API“ bezeichnet die programmgesteuerte Videogenerierung, nicht eine Verbraucher-App. Derzeit läuft Text-zu-Video bei Kunavo über einen einzigen OpenAI-kompatiblen Video-Endpoint mit Google Veo 3 — Sora-Unterstützung steht auf der Roadmap. Da der Endpoint nicht an ein Modell gebunden ist, erfordert der spätere Wechsel zu Sora nur die Änderung eines Wortes. Dieser Leitfaden zeigt den Workflow mit Veo 3, damit alle Beispiele sofort ausführbar sind.

Was ist die Sora API?

Sora (Sora 2 und Sora 2 Pro) wandelt Text-Prompts oder Standbilder in kurze Videoclips um und liefert bei Sora 2 synchronisiertes Audio. Als API lässt sich die Generierung in Pipelines skripten: Marketing-Clips, Produktanimationen, B-Roll, Storyboard-Vorschauen. Moderne Videomodelle haben alle dasselbe Grundprinzip: Sie senden Prompt und Parameter und erhalten eine gehostete Video-URL zurück.

Kunavos aktuelles Video: Veo 3

Kunavo bietet Videogenerierung über einen einzigen OpenAI-kompatiblen Endpoint /v1/video/generations. Sora ist im Katalog noch nicht aktiviert; das derzeit verfügbare Text-zu-Video-Modell ist Google Veo 3, das filmische Clips mit nativem Audio erzeugt. Die folgenden Beispiele verwenden veo-3 — sobald Sora hinzugefügt wird, muss nur das Feld model geändert werden.

Schnellstart für Text-zu-Video

Ein POST-Aufruf mit Ihrem Kunavo-Schlüssel genügt. Die Generierung kann mehrere Minuten dauern; ein synchroner Aufruf hält die Verbindung offen, bis der Clip bereit ist:

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "빨간 종이학이 펼쳐지는 영화적인 돌리인, 부드러운 조명",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # 생성에 몇 분이 걸릴 수 있습니다
)
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 zusammen mit dem Prompt image_url (eine HTTPS-URL oder eine Datei, die auf /v1/files hochgeladen wurde). Für kontrollierte Bewegungen können Sie mit image_urls und image_mode: "frame" ein erstes und letztes Bild übergeben. Das vollständige Beispiel finden Sie in der Videodokumentation.

Lebenszyklus asynchroner Aufgaben

Halten Sie in der Produktion keine zehnminütige Verbindung offen. Senden Sie den Auftrag an /v1/videos, erhalten Sie sofort eine Aufgaben-ID und fragen Sie GET /v1/videos/{id} bis zum Abschluss regelmäßig ab. Die Ergebnis-URL ist dauerhaft.

# 프로덕션: 작업을 제출한 뒤 폴링 — 장시간 연결을 유지하지 않습니다.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # 약 24시간 내 재시도 안전
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# 이후 완료될 때까지 GET /v1/videos/{task["id"]} 폴링

Die Videodokumentation behandelt die vollständige Polling-Schleife, Idempotenzschlüssel und die Zustellung per Webhook.

Preise

Veo 3 wird pro Video berechnet (hier am Beispiel eines 8-Sekunden-720p-Clips) und ist etwa 50~70 % günstiger als Googles Listenpreis. Höhere Auflösungen erhöhen die Kosten — die vollständige Tarifübersicht finden Sie auf der Preisseite.

Tipps für Video-Prompts

• Beschreiben Sie nicht nur das Motiv, sondern auch die Aufnahme. Kamerabewegungen (Dolly, Schwenk, Push-in), Objektivwirkung, Beleuchtung und Tempo sind wirkungsvoller als Adjektive.
• Seitenverhältnis ausdrücklich angeben — Querformat: 16:9, Hochformat/Social Media: 9:16.
• 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 zusammen.
• Referenzbilder verwenden (Bild-zu-Video). Das ist nützlich, wenn eine bestimmte Figur oder ein bestimmtes Produkt konsistent bleiben soll.

Häufig gestellte Fragen