Documentation

Référence API

Générer une image de manière synchrone

POST/v1/images/generations

Les paramètres synchrones sont validés selon le modèle ; seules les capacités image du modèle choisi sont disponibles. Qwen : maximum 6 images/3 références ; Ark selon modèle ; Venice texte-image : une image sans références. Les fichiers API ordinaires suivent la durée de stockage, contrairement aux tâches image persistantes.

Limites d'utilisation des sorties synchrones

Qwen accepte jusqu'à 6 images de sortie et 3 images de référence ; les limites Ark varient selon le modèle, tandis que Venice ne propose qu'une image issue du texte. Choisissez d'abord le modèle, puis envoyez ses champs correspondants ; ne transmettez pas de références à un modèle qui ne les prend pas en charge.

Pour une confirmation de devis, un historique à long terme et une récupération après déconnexion, utilisez le workflow d'images persistantes au lieu de répéter automatiquement une génération synchrone. Les en-têtes d'archivage de la réponse synchrone décrivent uniquement la phase de sauvegarde ; la conservation ordinaire des fichiers diffère de la protection par références de tâches. Voir Facturation.

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

Corps de requête obligatoire

  • image_urlsarrayFacultatif

    Liste d'URL de référence selon le modèle ; Qwen/Ark ont leurs propres limites, Venice texte-image synchrone refuse ce champ.

    Sous-champs de image_urls (1)
    • []stringFacultatif
  • modelstringObligatoire

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

  • promptstringObligatoire

    Prompt de génération.

  • nintegerFacultatif

    Nombre d'images demandé, toujours soumis au plafond du modèle.

  • sizestringFacultatif

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

  • response_formatstringFacultatif

    Format de sortie selon le modèle ; ne présumez pas que chacun accepte tous les formats.

  • userunknownFacultatif

    Valeur JSON définie par le schema ou protocole de l'outil choisi ; ne présumez pas de champs fixes.

  • extra_bodyunknownFacultatif

    Valeur JSON définie par le schema ou protocole de l'outil choisi ; ne présumez pas de champs fixes.

Réponses et erreurs

HTTP 200

Image synchrone générée

application/json

Type
object
Champs obligatoires
createddata
  • createdintegerObligatoire

    Date de génération de la réponse image en secondes Unix.

  • dataarrayObligatoire

    Tableau de données de la page/du catalogue actuel.

    Sous-champs de data (1)
    • []objectFacultatif
      Sous-champs de [] (7)
      • 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.

      • storage_errorstringFacultatif

        Catégorie publique de l'échec d'archivage du fichier.

      • expires_atintegerFacultatif

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

      • urlstringFacultatif

        URL d'accès au résultat ou à la référence ; les URL signées sont temporaires.

      • b64_jsonstringFacultatif

        Chaîne Base64 de l'image ; ne la demandez pas comme une URL.

      • revised_promptstringFacultatif

        Prompt révisé renvoyé par le service, le cas échéant.

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