Référence API

Créer une tâche de génération vidéo

POST/v1/videos

Le worker persistant gère en arrière-plan l'envoi, l'interrogation, la comptabilité et la sauvegarde ; le client observe sans déclencher le règlement. Requêtes ordinaires et persistent suivent leurs contraintes de modèle/images hébergées/devis. Pour unknown/submission_state_unknown, ne changez pas la clé pour répéter aveuglément.

Workflows ordinaires et persistants

La vidéo ordinaire utilise les entrées HTTPS publiques propres au modèle ; la vidéo persistante utilise retention=persistent, un preset complet du catalogue des capacités, des images hébergées et un devis valide. N'ajoutez pas les champs d'images de l'espace de travail aux requêtes ordinaires et ne combinez pas des paramètres de preset différents.

L'arrière-plan poursuit l'exécution, le règlement et la sauvegarde ; les consultations du client observent uniquement l'enregistrement. La réservation estimée peut donner lieu à un complément ou à un remboursement. Si la sauvegarde échoue après réussite, réessayez l'archivage du résultat initial sans régénérer. Récupérez d'abord toute soumission inconnue avec sa clé de requête d'origine. Voir Tâches asynchrones et idempotence.

Authentification et autorisations

Utilisez votre clé GloopAPI actuelle. Les modèles, capacités et autorisations disponibles dépendent de son catalogue et de la documentation du point de terminaison.

Authorization: Bearer $GLOOP_API_KEY

Schémas d'authentification : BearerAuth

Requête

En-têtes de requête

Idempotency-KeystringObligatoire
Longueur minimale
1
Longueur maximale
191
Motif
"^[\\x20-\\x7E]{1,191}$"

Corps de requête · application/json

Type: object
Champs obligatoires: modelprompt
Propriétés supplémentaires: false

Corps de requête obligatoire

modestringFacultatif
Obligatoire pour persistent.

Énumération
["text_to_video","image_to_video"]
retentionstringFacultatif
persistent utilise l'espace persistant ; omis, tâche ordinaire.
quote_idstringFacultatif
Une nouvelle requête persistent exige la confirmation préalable d'un devis valide de video-quotes.
start_frameobjectFacultatif
Obligatoire pour l'image-vers-vidéo persistent : fichier hébergé de la même Key. Interdit en texte-vers-vidéo.
Sous-champs de start_frame (1)
- file_idstringObligatoire
  ID public du fichier hébergé du même compte et de la même Key.
Branche allOf 1
Type: object
Obligatoire dans cette branche : file_id
- file_idstringObligatoire
  ID public du fichier hébergé du même compte et de la même Key.
end_frameobjectFacultatif
Image finale facultative pour persistent, si la capacité le permet.
Sous-champs de end_frame (1)
- file_idstringObligatoire
  ID public du fichier hébergé du même compte et de la même Key.
Branche allOf 1
Type: object
Obligatoire dans cette branche : file_id
- file_idstringObligatoire
  ID public du fichier hébergé du même compte et de la même Key.
webhook_endpoint_idstringFacultatif
Les tâches ordinaires peuvent référencer un récepteur configuré dans la console ; interdit pour persistent.
modelstringObligatoire
ID public du modèle dans le catalogue de la Key actuelle ; ne garantit pas la disponibilité d'un ancien modèle service.
promptstringObligatoire
Prompt de génération.

Longueur minimale
1
Longueur maximale
2500
durationintegerFacultatif
Durée selon le modèle ; utilisez la combinaison complète de video-models mode.presets, sans produit cartésien. Wan Turbo ne prend pas ce champ en charge ; aucune valeur par défaut uniforme.
image_urlstringFacultatif
Image initiale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
end_image_urlstringFacultatif
Image finale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
resolutionstringFacultatif
Résolution du preset du modèle.
aspect_ratiostringFacultatif
Rapport d'aspect du preset du modèle.
generate_audiobooleanFacultatifAutorise null
Dépend du modèle ; utilisez la politique audio et les presets du mode. Ne supposez pas que tous les modèles génèrent de l'audio.

Réponses et erreurs

HTTP 202

Tâche acceptée, pas nécessairement terminée.

application/json

Type: object
Champs obligatoires: idmodelstatuscreated_at

updated_atintegerFacultatif
Dernière mise à jour en secondes Unix.
retentionstringFacultatif
Politique de conservation des résultats ; persistent désigne l'espace persistant.
inputobjectFacultatif
Entrée initiale de la tâche ou entrée du contrat d'outil.
Sous-champs de input (14)
- modestringFacultatif
  Obligatoire pour persistent.
  
  Énumération
  ["text_to_video","image_to_video"]
- retentionstringFacultatif
  persistent utilise l'espace persistant ; omis, tâche ordinaire.
- quote_idstringFacultatif
  Une nouvelle requête persistent exige la confirmation préalable d'un devis valide de video-quotes.
- start_frameobjectFacultatif
  Obligatoire pour l'image-vers-vidéo persistent : fichier hébergé de la même Key. Interdit en texte-vers-vidéo.
  Sous-champs de start_frame (1)
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
  Branche allOf 1
  Type: object
  Obligatoire dans cette branche : file_id
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
- end_frameobjectFacultatif
  Image finale facultative pour persistent, si la capacité le permet.
  Sous-champs de end_frame (1)
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
  Branche allOf 1
  Type: object
  Obligatoire dans cette branche : file_id
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
- webhook_endpoint_idstringFacultatif
  Les tâches ordinaires peuvent référencer un récepteur configuré dans la console ; interdit pour persistent.
- modelstringObligatoire
  ID public du modèle dans le catalogue de la Key actuelle ; ne garantit pas la disponibilité d'un ancien modèle service.
- promptstringObligatoire
  Prompt de génération.
  
  Longueur minimale
  1
  Longueur maximale
  2500
- durationintegerFacultatif
  Durée selon le modèle ; utilisez la combinaison complète de video-models mode.presets, sans produit cartésien. Wan Turbo ne prend pas ce champ en charge ; aucune valeur par défaut uniforme.
- image_urlstringFacultatif
  Image initiale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
- end_image_urlstringFacultatif
  Image finale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
- resolutionstringFacultatif
  Résolution du preset du modèle.
- aspect_ratiostringFacultatif
  Rapport d'aspect du preset du modèle.
- generate_audiobooleanFacultatifAutorise null
  Dépend du modèle ; utilisez la politique audio et les presets du mode. Ne supposez pas que tous les modèles génèrent de l'audio.
Branche allOf 1
Type: object
Obligatoire dans cette branche : model, prompt
Propriétés supplémentaires: false
- modestringFacultatif
  Obligatoire pour persistent.
  
  Énumération
  ["text_to_video","image_to_video"]
- retentionstringFacultatif
  persistent utilise l'espace persistant ; omis, tâche ordinaire.
- quote_idstringFacultatif
  Une nouvelle requête persistent exige la confirmation préalable d'un devis valide de video-quotes.
- start_frameobjectFacultatif
  Obligatoire pour l'image-vers-vidéo persistent : fichier hébergé de la même Key. Interdit en texte-vers-vidéo.
  Sous-champs de start_frame (1)
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
  Branche allOf 1
  Type: object
  Obligatoire dans cette branche : file_id
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
- end_frameobjectFacultatif
  Image finale facultative pour persistent, si la capacité le permet.
  Sous-champs de end_frame (1)
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
  Branche allOf 1
  Type: object
  Obligatoire dans cette branche : file_id
  - file_idstringObligatoire
    ID public du fichier hébergé du même compte et de la même Key.
- webhook_endpoint_idstringFacultatif
  Les tâches ordinaires peuvent référencer un récepteur configuré dans la console ; interdit pour persistent.
- modelstringObligatoire
  ID public du modèle dans le catalogue de la Key actuelle ; ne garantit pas la disponibilité d'un ancien modèle service.
- promptstringObligatoire
  Prompt de génération.
  
  Longueur minimale
  1
  Longueur maximale
  2500
- durationintegerFacultatif
  Durée selon le modèle ; utilisez la combinaison complète de video-models mode.presets, sans produit cartésien. Wan Turbo ne prend pas ce champ en charge ; aucune valeur par défaut uniforme.
- image_urlstringFacultatif
  Image initiale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
- end_image_urlstringFacultatif
  Image finale HTTPS selon modèle, tâches ordinaires uniquement ; interdit pour persistent.
- resolutionstringFacultatif
  Résolution du preset du modèle.
- aspect_ratiostringFacultatif
  Rapport d'aspect du preset du modèle.
- generate_audiobooleanFacultatifAutorise null
  Dépend du modèle ; utilisez la politique audio et les presets du mode. Ne supposez pas que tous les modèles génèrent de l'audio.
billingobjectFacultatif
État comptable indépendant, à ne pas remplacer par l'état de génération.
Sous-champs de billing (7)
- currencystringObligatoire
  Devise du devis/de la comptabilité.
- error_codestringFacultatif
  Code d'erreur public utilisable pour choisir une branche de traitement.
- statusstringObligatoire
  État actuel de l'objet ; évaluer séparément comptabilité et sauvegarde.
- reserved_quotaintegerObligatoire
  Réservation en unités quota de la plateforme, pas en dollars.
- final_quotaintegerObligatoireAutorise null
  Coût final en unités quota de la plateforme ; null signifie non déterminé.
- reserved_amountstringObligatoire
  Réservation maximale, chaîne dans la devise du devis.
- final_amountstringObligatoireAutorise null
  Coût final sous forme de chaîne ; null signifie non réglé.
Branche allOf 1
Type: object
Obligatoire dans cette branche : currency, status, reserved_quota, final_quota, reserved_amount, final_amount
- currencystringObligatoire
  Devise du devis/de la comptabilité.
- error_codestringFacultatif
  Code d'erreur public utilisable pour choisir une branche de traitement.
- statusstringObligatoire
  État actuel de l'objet ; évaluer séparément comptabilité et sauvegarde.
- reserved_quotaintegerObligatoire
  Réservation en unités quota de la plateforme, pas en dollars.
- final_quotaintegerObligatoireAutorise null
  Coût final en unités quota de la plateforme ; null signifie non déterminé.
- reserved_amountstringObligatoire
  Réservation maximale, chaîne dans la devise du devis.
- final_amountstringObligatoireAutorise null
  Coût final sous forme de chaîne ; null signifie non réglé.
storageobjectFacultatif
État indépendant de sauvegarde du fichier.
Sous-champs de storage (3)
- file_idstringFacultatif
  ID public du fichier hébergé du même compte et de la même Key.
- statusstringObligatoire
  État actuel de l'objet ; évaluer séparément comptabilité et sauvegarde.
- error_codestringFacultatif
  Code d'erreur public utilisable pour choisir une branche de traitement.
Branche allOf 1
Type: object
Obligatoire dans cette branche : status
- file_idstringFacultatif
  ID public du fichier hébergé du même compte et de la même Key.
- statusstringObligatoire
  État actuel de l'objet ; évaluer séparément comptabilité et sauvegarde.
- error_codestringFacultatif
  Code d'erreur public utilisable pour choisir une branche de traitement.
availabilityobjectFacultatif
Capacités actuelles de l'opération.
Sous-champs de availability (4)
- can_cancelbooleanObligatoire
  Indique si l'annulation de la tâche actuelle peut être demandée.
- can_deletebooleanObligatoire
  Indique si la tâche actuelle peut être supprimée.
- can_retry_storagebooleanObligatoire
  Indique si la sauvegarde de la tâche peut être réessayée.
- reasonstringFacultatif
  Raison publique de l'indisponibilité de l'action ou de la révision comptable.
Branche allOf 1
Type: object
Obligatoire dans cette branche : can_cancel, can_delete, can_retry_storage
- can_cancelbooleanObligatoire
  Indique si l'annulation de la tâche actuelle peut être demandée.
- can_deletebooleanObligatoire
  Indique si la tâche actuelle peut être supprimée.
- can_retry_storagebooleanObligatoire
  Indique si la sauvegarde de la tâche peut être réessayée.
- reasonstringFacultatif
  Raison publique de l'indisponibilité de l'action ou de la révision comptable.
idstringObligatoire
Identifiant public de l'objet, utilisé dans son chemin de détails.
modelstringObligatoire
ID public du modèle dans le catalogue de la Key actuelle.
statusstringObligatoire
État des tâches ordinaires et persistantes : pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. Un état terminal ne signifie ni règlement final ni archivage ready.
created_atintegerObligatoire
Date de création en secondes Unix.
resultobjectFacultatif
Métadonnées du résultat prêt, éventuellement absentes avant achèvement.
Sous-champs de result (8)
- file_idstringFacultatif
  ID public du fichier hébergé du même compte et de la même Key.
- storage_statusstringFacultatif
  État d'archivage du fichier ; le téléchargement hébergé est garanti seulement après ready.
- deliverystringFacultatif
  authenticated_content exige le chemin de contenu ; ne présumez pas une URL directe.
- content_pathstringFacultatif
  Chemin de contenu authentifié de la plateforme ; demandez les octets avec la même Key.
- urlstringFacultatif
  URL d'accès au résultat ou à la référence ; les URL signées sont temporaires.
- content_typestringFacultatif
  Type MIME du résultat.
- file_namestringFacultatif
  Nom public du fichier téléchargé.
- file_sizeintegerFacultatif
  Taille du fichier résultat en octets.
Branche allOf 1
Type: object
- file_idstringFacultatif
  ID public du fichier hébergé du même compte et de la même Key.
- storage_statusstringFacultatif
  État d'archivage du fichier ; le téléchargement hébergé est garanti seulement après ready.
- deliverystringFacultatif
  authenticated_content exige le chemin de contenu ; ne présumez pas une URL directe.
- content_pathstringFacultatif
  Chemin de contenu authentifié de la plateforme ; demandez les octets avec la même Key.
- urlstringFacultatif
  URL d'accès au résultat ou à la référence ; les URL signées sont temporaires.
- content_typestringFacultatif
  Type MIME du résultat.
- file_namestringFacultatif
  Nom public du fichier téléchargé.
- file_sizeintegerFacultatif
  Taille du fichier résultat en octets.
errorstringFacultatif
Catégorie d'échec ou objet d'erreur public.

HTTP 400

Paramètres de requête incorrects.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (3)
- messagestringObligatoire
- typestringObligatoire
  Énumération
  ["new_api_error"]
- codestringObligatoire

HTTP 401

Key absente, invalide, expirée ou révoquée.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (4)
- codestringFacultatif
- messagestringFacultatif
- typestringFacultatif
- request_idstringFacultatif

HTTP 402

Quota disponible du compte ou de la Key insuffisant.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (3)
- messagestringObligatoire
- typestringObligatoire
  Énumération
  ["new_api_error"]
- codestringObligatoire

HTTP 403

Key actuelle non autorisée.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (3)
- messagestringObligatoire
- typestringObligatoire
  Énumération
  ["new_api_error"]
- codestringObligatoire

HTTP 409

Conflit, résultat non prêt ou soumission inconnue : consultez d'abord l'enregistrement initial, sans répétition aveugle.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (3)
- messagestringObligatoire
- typestringObligatoire
  Énumération
  ["new_api_error"]
- codestringObligatoire

HTTP 429

Limitation de débit des requêtes/de la file.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (4)
- codestringFacultatif
- messagestringFacultatif
- typestringFacultatif
- request_idstringFacultatif

HTTP 500

Défaillance interne d'authentification ou de stockage des données.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (4)
- codestringFacultatif
- messagestringFacultatif
- typestringFacultatif
- request_idstringFacultatif

HTTP 503

Service, stockage, tarification temporairement indisponible.

application/json

Type: object
Champs obligatoires: error

errorobjectObligatoire
Sous-champs de error (3)
- messagestringObligatoire
- typestringObligatoire
  Énumération
  ["new_api_error"]
- codestringObligatoire