Documentation

Référence API

Obtenir un devis de vidéo persistante

POST/v1/video-quotes

retention=persistent : devis selon les modes et images hébergées du catalogue. Interrupteur désactivé : 404 direct. Expiration ou changement de prix exige une nouvelle confirmation.

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

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 200

Devis de vidéo persistante obtenu

application/json

Type
object
Champs obligatoires
idexpires_atrequest_hashpricing_kindcurrencyreserved_quotareserved_amountestimated_final_amountsettlement_note
  • idstringObligatoire

    Identifiant public de l'objet, utilisé dans son chemin de détails.

  • expires_atintegerObligatoire

    Expiration en secondes Unix ; 0 signifie aucune échéance fixe.

  • request_hashstringObligatoire

    Résumé de requête normalisée liant devis et création ; ce n'est pas la clé de requête idempotente.

  • pricing_kindstringObligatoire

    Mode tarifaire effectivement utilisé pour ce devis.

  • currencystringObligatoire

    Devise du devis/de la comptabilité.

  • reserved_quotaintegerObligatoire

    Réservation en unités quota de la plateforme, pas en dollars.

  • reserved_amountstringObligatoire

    Réservation maximale, chaîne dans la devise du devis.

  • estimated_final_amountstringObligatoireAutorise null

    Montant final estimé sous forme de chaîne ; null signifie indéterminable avant génération.

  • settlement_notestringObligatoire

    Description de la mesure et du règlement réels.

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

Notes sur le point de terminaison

Ces paramètres illustrent uniquement un préréglage complet. Copiez le preset entier (duration, resolution, aspect_ratio, generate_audio) du catalogue video-models de votre Key actuelle pour le model/mode choisi. Ne remplacez pas seulement le modèle et ne mélangez pas les préréglages.