Référence API
Obtenir un devis d'image persistante
/v1/image-quotesVé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_KEYSché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
modelstringObligatoireID public du modèle dans le catalogue de la Key actuelle.
- Longueur maximale
191
promptstringObligatoireNon vide, au plus 32000 octets UTF-8. OpenAPI maxLength compte les caractères ; aucun faux plafond de caractères n'est défini.
sizestringObligatoireDimension renvoyée par image-models pour le modèle choisi ; capacités et dimensions validées séparément par modèle.
nintegerFacultatifOmis 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
referencesarrayFacultatifChaque é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)
[]objectFacultatifSous-champs de [] (3)
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_idstringFacultatifTâ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_notestringObligatoireDescription des prix du modèle ; règlement final selon la mesure confirmée.
idstringObligatoireIdentifiant public de l'objet, utilisé dans son chemin de détails.
expires_atintegerObligatoireExpiration en secondes Unix ; 0 signifie aucune échéance fixe.
reserved_quotaintegerObligatoireRéservation en unités quota de la plateforme, pas en dollars.
estimated_costnumberObligatoireCoût de vente estimé dans la devise du devis.
currencystringObligatoireDevise du devis/de la comptabilité.
HTTP 400
Champs ou paramètres de requête invalides.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 401
Key absente, invalide, expirée ou révoquée.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 403
Autorisations IP, compte, modèle ou outil insuffisantes.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 404
Objet/capacité indisponible ou fonctionnalité désactivée.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 409
Conflit d'idempotence/devis, objet non prêt ou encore référencé.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 429
Limitation de débit des requêtes/de la file.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 500
Défaillance interne d'authentification ou de stockage des données.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif
HTTP 503
Service, tarification ou stockage indisponible.
application/json
- Type
- object
- Champs obligatoires
error
errorobjectObligatoireSous-champs de error (4)
codestringFacultatifmessagestringFacultatiftypestringFacultatifrequest_idstringFacultatif