Documentation

Référence API

Lister l'historique des images persistantes

GET/v1/image-tasks

Historique de la même Key, 20 éléments par page, avec le curseur du service. L'historique vérifie toujours les autorisations actuelles du modèle.

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 requête

  • cursorstringFacultatif

    next_cursor de la réponse d'origine, sans construction manuelle.

  • qstringFacultatif

    Recherche de prompt, 256 octets UTF-8 maximum.

  • statusstringFacultatif

    Filtre exact queued/dispatching/running/succeeded/partial_succeeded/failed/unknown.

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

Réponses et erreurs

HTTP 200

Historique des images persistantes obtenu

application/json

Type
object
Champs obligatoires
datanext_cursor
  • dataarrayObligatoire

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

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

  • next_cursorstringObligatoire

    Curseur suivant, à retransmettre tel quel au paramètre de pagination ; vide à la dernière page.

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