Documentation

Référence API

Récupérer une vidéo persistante par clé de requête

GET/v1/video-requests/{key}

Seulement persistent, récupération avec la même Key. Ce chemin ne réexécute pas actuellement toute la politique des modèles ; aucune garantie de correction uniforme des permissions historiques.

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

  • keystringObligatoire

    Idempotency-Key de la requête persistent d'origine : lettres/chiffres ASCII, traits de soulignement ou tirets, 1–128 octets.

    Longueur minimale
    1
    Longueur maximale
    128
    Motif
    "^[A-Za-z0-9_-]+$"

Réponses et erreurs

HTTP 200

Vidéo persistante récupérée par clé de requête

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

Champs ou paramètres de requête invalides.

application/json

Type
object
Champs obligatoires
error

HTTP 401

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

application/json

Type
object
Champs obligatoires
error

HTTP 403

Autorisations IP, compte, modèle ou outil insuffisantes.

application/json

Type
object
Champs obligatoires
error

HTTP 404

Objet/capacité indisponible ou fonctionnalité désactivée.

application/json

Type
object
Champs obligatoires
error

HTTP 409

Conflit d'idempotence/devis, objet non prêt ou encore référencé.

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 503

Service, tarification ou stockage indisponible.

application/json

Type
object
Champs obligatoires
error