Documentation

Référence API

Consulter l'état d'une tâche vidéo

GET/v1/videos/{task_id}

Consultation d'état : réussite de génération, billing.status et storage.status s'évaluent séparément. Une Key valide épuisée peut consulter la tâche ; les autorisations actuelles du modèle suivent cette implémentation.

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

Paramètres de chemin

  • task_idstringObligatoire

    ID public d'une tâche créée avec la même Key.

Réponses et erreurs

HTTP 200

Requête réussie.

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 401

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

application/json

Type
object
Champs obligatoires
error

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 404

Objet ou capacité indisponible.

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 410

Tâche vidéo supprimée (task_deleted), lecture impossible.

application/json

Type
object
Champs obligatoires
error

HTTP 429

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

application/json

Type
object
Champs obligatoires
error

HTTP 500

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

application/json

Type
object
Champs obligatoires
error

HTTP 502

Erreur de réponse du service.

application/json

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

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