Documentation

Référence API

Obtenir le résultat d'une tâche image

GET/v1/image-tasks/{task_id}/result

Disponible uniquement pour succeeded/partial_succeeded. L'archivage est indépendant ; sans ready, le téléchargement n'est pas garanti.

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

  • task_idstringObligatoire

    ID public d'une tâche créée avec la même Key.

Réponses et erreurs

HTTP 200

Résultat de la tâche image obtenu

application/json

Type
object
Champs obligatoires
modelpromptsizenreferencesidstatuscreated_atupdated_atreserved_quotafinal_quotabilling_statusresults
  • modelstringObligatoire

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

  • promptstringObligatoire

    Prompt de génération.

  • sizestringObligatoire

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

  • nintegerObligatoire

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

  • referencesarrayObligatoire

    Liste des images de référence pour la génération.

    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

    ID public de la tâche source, uniquement pour traçabilité.

  • quote_idstringFacultatif

    ID public du devis ; doit respecter les liens prix/requête à la création.

  • idstringObligatoire

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

  • statusstringObligatoire

    unknown n'est pas répété automatiquement ; la pré-réservation comptable peut rester pending.

    Énumération
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
  • created_atintegerObligatoire

    Date de création en secondes Unix.

  • updated_atintegerObligatoire

    Dernière mise à jour en secondes Unix.

  • reserved_quotaintegerObligatoire

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

  • final_quotaintegerObligatoire

    Coût final en unités quota de la plateforme ; null signifie non déterminé.

  • billing_statusstringObligatoire

    État de réservation/règlement/remboursement, à vérifier séparément de la tâche et de l'archivage.

  • error_codestringFacultatif

    Code d'erreur public utilisable pour choisir une branche de traitement.

  • error_messagestringFacultatif

    Explication utilisateur issue de la classification publique des erreurs.

  • resultsarrayObligatoire

    Éléments de sortie générés ; archivage indépendant pour chacun.

    Sous-champs de results (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