Référence API

Obtenir un devis d'image persistante

POST/v1/image-quotes

Vérifie seulement entrées et autorisations, sans verrouiller les images. Devis valable 60 secondes ; routage, prix et requête sont revérifiés à la création. Service désactivé : 503.

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
modelpromptsize
Propriétés supplémentaires
false

Corps de requête obligatoire

  • modelstringObligatoire

    ID public du modèle dans le catalogue de la Key actuelle.

    Longueur maximale
    191
  • promptstringObligatoire

    Non vide, au plus 32000 octets UTF-8. OpenAPI maxLength compte les caractères ; aucun faux plafond de caractères n'est défini.

  • sizestringObligatoire

    Dimension renvoyée par image-models pour le modèle choisi ; capacités et dimensions validées séparément par modèle.

  • nintegerFacultatif

    Omis ou 0 est normalisé à 1. Le maximum réel est max_n de image-models ; le plafond global n'est pas une capacité du modèle.

    Valeur par défaut
    1
    Minimum
    1
    Maximum
    6
  • referencesarrayFacultatif

    Chaque élément choisit uniquement file_id, asset_id ou url ; quantité effective selon max_references.

    Nombre maximal d'éléments
    14
    Sous-champs de references (1)
    • []objectFacultatif
      Sous-champs de [] (3)
      • file_idstringFacultatif

        ID public du fichier hébergé du même compte et de la même Key.

      • asset_idstringFacultatif

        ID de ressource téléversée du même compte et de la même Key.

      • urlstringFacultatif

        URL HTTPS publique, sans userinfo ni fragment ; soumise aux contrôles SSRF.

        Format
        "uri"
      Branche oneOf 1

      Obligatoire dans cette branche : file_id

      Branche oneOf 2

      Obligatoire dans cette branche : asset_id

      Branche oneOf 3

      Obligatoire dans cette branche : url

  • source_task_idstringFacultatif

    Tâche source facultative de la même Key, uniquement pour la traçabilité ; ne remplace pas references.

    Longueur maximale
    64
  • quote_idstringFacultatif

    À la création, devis valide correspondant à la requête ; ignoré lors d'une demande de devis.

Réponses et erreurs

HTTP 200

Devis d'image persistante obtenu

application/json

Type
object
Champs obligatoires
pricing_noteidexpires_atreserved_quotaestimated_costcurrency
  • pricing_notestringObligatoire

    Description des prix du modèle ; règlement final selon la mesure confirmée.

  • 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.

  • reserved_quotaintegerObligatoire

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

  • estimated_costnumberObligatoire

    Coût de vente estimé dans la devise du devis.

  • currencystringObligatoire

    Devise du devis/de la comptabilité.

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