Skip to main content
POST
Créer une vidéo
Nécessite l’accès à la préversion dans l’espace de travail. Consultez Tâches vidéo et traitement par lots pour la configuration, les webhooks et le traitement des résultats.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Corps

application/json
model
string
requis
prompt
string
requis
duration
integer

Durée souhaitée en secondes (selon le fournisseur/modèle).

input_video_duration
number<double>

Durée de la vidéo source en secondes. Obligatoire si le fournisseur facture cette durée séparément de la sortie générée.

Plage requise: 0 < x <= 3600
input_audio_duration
number<double>

Durée déclarée de l’audio source en secondes, utilisée pour valider la plage du fournisseur. Les fournisseurs qui ne communiquent pas une consommation faisant autorité peuvent facturer selon leur durée d’entrée maximale prise en charge.

Plage requise: 2 <= x <= 20
size
string

Dimensions explicites (par exemple 1280x720). Incompatible avec resolution ou aspect_ratio.

resolution
string

480p, 720p, 1080p, 1K, 2K, 4K. Compatible avec aspect_ratio. Incompatible avec size.

aspect_ratio
string

Format d’image tel que 16:9, 9:16 ou 1:1. Compatible avec resolution. Incompatible avec size.

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

Entrées HTTPS d’image, d’audio ou de vidéo conditionnant la génération. Les types, rôles, nombres et combinaisons pris en charge dépendent du modèle choisi. Consultez GET /videos/models avant d’envoyer une tâche. L’alias de compatibilité au singulier input_reference, absent de ce schéma, accepte une image multipart ou un objet contenant exactement un champ parmi file_id et image_url. La prise en charge dépend du fournisseur.

Entrée multimédia HTTPS typée. Utilisez image_url pour les images et media_url pour l’audio ou la vidéo. Les rôles décrivent l’utilisation de l’entrée par le modèle ; la prise en charge varie selon le fournisseur et le modèle.

frame_images
object[]

Images HTTPS de la première/dernière image. Chaque frame_type ne peut apparaître qu’une fois. Ne fournissez pas également input_reference ou de rôles d’image dans input_references.

Required array length: 1 - 2 elements
provider_params
object

Extensions propres au fournisseur uniquement. La transmission intégrale de la requête et les doublons de champs de routage, prompt, callback ou facturation sont rejetés.

provider_options
object

Extensions indexées par ID canonique du fournisseur (par exemple atlascloud ou byteplus). Seules les options du fournisseur choisi sont transmises. Incompatible avec provider_params. Le routage, prompt, callback, la durée, résolution et le nombre de sorties doivent utiliser les champs de premier niveau validés.

output
object
webhook
object
provider
object

Préférences de routage des fournisseurs pour la sélection par la passerelle.

Réponse

202 - application/json

Réponse vidéo

id
string
polling_url
string
websocket_url
string<uri>

URL WebSocket permettant de s’abonner aux mises à jour normalisées du cycle de vie des tâches asynchrones.

model
string
request_id
string
session_id
string
status
enum<string>
Options disponibles:
queued,
processing,
completed,
failed,
cancelled,
expired
lifecycle_status
enum<string>

État normalisé du cycle de vie asynchrone pour les consommateurs par interrogation, WebSocket et webhook.

Options disponibles:
pending,
running,
completed,
failed,
cancelled,
expired
cancel_url
string<uri> | null

Réservé à la compatibilité ; actuellement toujours null.

output_access
enum<string>
Options disponibles:
bytes,
signed_url,
both
generation_id
string | null
native_video_id
string | null

ID vidéo/tâche natif du fournisseur lorsqu’il diffère de l’ID de la passerelle.

created_at
started_at
completed_at
object
string
Exemple:

"video"

poll_after_seconds
integer
Exemple:

20

provider
string
seconds
number
size
string
audio
boolean
content_url
string

Présent lorsque output_access inclut bytes (endpoint authentifié).

download_url
string | null

URL signée de première partie pour le téléchargement direct lorsque l’état est completed.

expires_at
integer | null

Horodatage Unix (secondes) d’expiration de la download_url signée.

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

Configuration nettoyée du webhook asynchrone et état de livraison. Les secrets ne sont jamais renvoyés ; has_secret indique si les livraisons signées sont activées. Les livraisons signées incluent les en-têtes x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt et x-phaseo-max-attempts.

next_webhook_retry_at
string | null

Horodatage ISO de la prochaine tentative programmée du webhook utilisateur, si en attente.

last_webhook_progress
number | null

Dernière tranche de progression approximative envoyée aux consommateurs de webhooks.

last_webhook_progress_at
string | null

Horodatage ISO de l’envoi de la dernière tranche de progression du webhook.

last_webhook_dispatched_at
string | null

Horodatage ISO de la tentative d’envoi du webhook la plus récente.

usage
object
error
unknown
Dernière modification le 2 octobre 2026