Skip to main content
POST
Video erstellen
Erfordert Zugriff auf die Vorschau im Arbeitsbereich. Informationen zu Einrichtung, Webhooks und Ergebnisverarbeitung findest du unter Video- und Stapelaufträge.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Body

application/json
model
string
erforderlich
prompt
string
erforderlich
duration
integer

Gewünschte Dauer in Sekunden (anbieter-/modellabhängig).

input_video_duration
number<double>

Dauer des Quellvideos in Sekunden. Erforderlich, wenn ein Anbieter die Quellvideodauer unabhängig von der erzeugten Ausgabe abrechnet.

Erforderlicher Bereich: 0 < x <= 3600
input_audio_duration
number<double>

Angegebene Quellaudiodauer in Sekunden zur Prüfung des Anbieterbereichs. Anbieter ohne verbindliche Nutzungsangaben können ihre maximal unterstützte Eingabedauer abrechnen.

Erforderlicher Bereich: 2 <= x <= 20
size
string

Explizite Abmessungen (z. B. 1280x720). Nicht mit resolution oder aspect_ratio kombinierbar.

resolution
string

480p, 720p, 1080p, 1K, 2K, 4K. Mit aspect_ratio kombinierbar. Nicht mit size kombinierbar.

aspect_ratio
string

Seitenverhältnis wie 16:9, 9:16 oder 1:1. Mit resolution kombinierbar. Nicht mit size kombinierbar.

seed
integer
sample_count
integer
Erforderlicher Bereich: 1 <= x <= 4
negative_prompt
string
generate_audio
boolean
enhance_prompt
boolean
compression_quality
integer
person_generation
string
resize_mode
string
input_references
object[]

HTTPS-Bild-, Audio- oder Videoeingaben zur Steuerung der Generierung. Unterstützte Typen, Rollen, Anzahlen und Kombinationen hängen vom gewählten Modell ab. Vor dem Absenden GET /videos/models prüfen. Der hier nicht aufgeführte einzelne Kompatibilitätsalias input_reference akzeptiert ein Multipart-Bild oder ein Objekt mit genau einem der Felder file_id oder image_url. Die Unterstützung hängt vom Anbieter ab.

Typisierte HTTPS-Medieneingabe. image_url für Bilder und media_url für Audio oder Video verwenden. Rollen beschreiben die Nutzung der Eingabe durch das Modell; Unterstützung variiert je Anbieter und Modell.

frame_images
object[]

HTTPS-Bilder des ersten/letzten Frames. Jeder frame_type darf einmal vorkommen. Nicht zusätzlich input_reference oder Frame-Rollen in input_references angeben.

Required array length: 1 - 2 elements
provider_params
object

Nur anbieterspezifische Erweiterungen. Vollständige Durchleitung der Anfrage und doppelte Routing-, Prompt-, Callback- oder Abrechnungsfelder werden abgelehnt.

provider_options
object

Erweiterungen nach kanonischer Anbieter-ID (z. B. atlascloud oder byteplus). Nur Optionen des gewählten Anbieters werden weitergeleitet. Nicht mit provider_params kombinierbar. Routing, Prompt, Callback, Dauer, Auflösung und Ausgabeanzahl müssen validierte Felder auf oberster Ebene verwenden.

output
object
webhook
object
provider
object

Anbieterrouting-Präferenzen für die Auswahl durch das Gateway.

Antwort

202 - application/json

Videoantwort

id
string
polling_url
string
websocket_url
string<uri>

WebSocket-URL zum Abonnieren normalisierter Lebenszyklusaktualisierungen asynchroner Aufträge.

model
string
request_id
string
session_id
string
status
enum<string>
Verfügbare Optionen:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

Normalisierter asynchroner Lebenszyklusstatus für Polling-, WebSocket- und Webhook-Empfänger.

Verfügbare Optionen:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

Für Kompatibilität reserviert; derzeit immer null.

output_access
enum<string>
Verfügbare Optionen:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

Anbietereigene Video-/Auftrags-ID, wenn sie von der Gateway-ID abweicht.

created_at
started_at
completed_at
object
string
Beispiel:

"video"

poll_after_seconds
integer
Beispiel:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Vorhanden, wenn output_access bytes einschließt (authentifizierter Endpunkt).

download_url
string | null

Signierte Erstanbieter-URL zum direkten Download bei Status completed.

expires_at
integer | null

Unix-Zeitstempel (Sekunden), zu dem die signierte download_url abläuft.

progress
integer | null
progress_source
string
asset
object | null
outputs
object[]
billing
object
webhook
object

Bereinigte asynchrone Webhook-Konfiguration und Zustellstatus. Geheimnisse werden nie zurückgegeben; has_secret zeigt an, ob signierte Zustellungen aktiviert sind. Signierte Zustellungen enthalten die Header x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt und x-phaseo-max-attempts.

next_webhook_retry_at
string | null

ISO-Zeitstempel des nächsten geplanten Benutzer-Webhook-Wiederholungsversuchs, sofern eingereiht.

last_webhook_progress
number | null

Letzte an Webhook-Empfänger gesendete grobe Fortschrittsstufe.

last_webhook_progress_at
string | null

ISO-Zeitstempel des Versands der letzten Webhook-Fortschrittsstufe.

last_webhook_dispatched_at
string | null

ISO-Zeitstempel des letzten Webhook-Versandversuchs.

usage
object
error
unknown
Zuletzt geändert am 2. Oktober 2026