Dokumentation

API-Referenz

Verlauf persistenter Bilder abfragen

GET/v1/image-tasks

Verlauf desselben Schlüssels, 20 Einträge pro Seite, mit dem vom Dienst gelieferten Cursor. Die aktuelle Modellberechtigung wird weiterhin geprüft.

Authentifizierung und Berechtigungen

Verwenden Sie Ihren aktuellen GloopAPI-Schlüssel. Verfügbare Modelle, Funktionen und Berechtigungen hängen von seinem Katalog und der Endpunktdokumentation ab.

Authorization: Bearer $GLOOP_API_KEY

Authentifizierungsschemata: BearerAuth

Anfrage

Abfrageparameter

  • cursorstringOptional

    next_cursor aus der ursprünglichen Antwort; nicht selbst zusammensetzen.

  • qstringOptional

    Prompt-Suche, maximal 256 UTF-8-Bytes.

  • statusstringOptional

    Exakter Statusfilter queued/dispatching/running/succeeded/partial_succeeded/failed/unknown.

    Aufzählung
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown"]

Antworten und Fehler

HTTP 200

Verlauf persistenter Bilder erfolgreich abgefragt

application/json

Typ
object
Pflichtfelder
datanext_cursor
  • dataarrayErforderlich

    Datenarray der aktuellen Seite/des Katalogs.

    Unterfelder von data (1)
    • []objectOptional
      Unterfelder von [] (17)
      • modelstringErforderlich

        Öffentliche Modell-ID aus dem Katalog des aktuellen Schlüssels.

      • promptstringErforderlich

        Generierungsprompt.

      • sizestringErforderlich

        Größenwert aus dem ausgewählten image-models-Eintrag; Funktionen und Größen werden je Modell geprüft.

      • nintegerErforderlich

        Angeforderte Anzahl der Ausgabebilder, weiterhin durch das Modellmaximum begrenzt.

      • referencesarrayErforderlich

        Liste der Referenzbilder für die Generierung.

        Unterfelder von references (1)
        • []objectOptional
          Unterfelder von [] (3)
          • file_idstringOptional

            Öffentliche ID einer verwalteten Datei desselben Kontos und Schlüssels.

          • asset_idstringOptional

            ID eines hochgeladenen Objekts desselben Kontos und Schlüssels.

          • urlstringOptional

            Öffentliche HTTPS-URL ohne userinfo oder fragment; SSRF-geprüft.

            Format
            "uri"
          oneOf-Zweig 1

          In diesem Zweig erforderlich: file_id

          oneOf-Zweig 2

          In diesem Zweig erforderlich: asset_id

          oneOf-Zweig 3

          In diesem Zweig erforderlich: url

      • source_task_idstringOptional

        Öffentliche Quellaufgaben-ID, nur zur Herkunftsverfolgung.

      • quote_idstringOptional

        Öffentliche Kostenvoranschlags-ID; muss beim Erstellen zur Preis- und Anfragebindung passen.

      • idstringErforderlich

        Öffentliche Kennung dieses Objekts für den zugehörigen Detailpfad.

      • statusstringErforderlich

        unknown wird nicht automatisch wiederholt; Vorabbuchung kann pending bleiben.

        Aufzählung
        ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
      • created_atintegerErforderlich

        Erstellungszeit in Unix-Sekunden.

      • updated_atintegerErforderlich

        Letzte Aktualisierung in Unix-Sekunden.

      • reserved_quotaintegerErforderlich

        Reservierung in Plattform-quota-Einheiten, nicht in Dollar.

      • final_quotaintegerErforderlich

        Endkosten in Plattform-quota-Einheiten; null bedeutet noch unbestimmt.

      • billing_statusstringErforderlich

        Reservierungs-/Abrechnungs-/Erstattungsstatus; getrennt von Aufgaben- und Archivierungsstatus prüfen.

      • error_codestringOptional

        Öffentlicher Fehlercode für Fallunterscheidungen.

      • error_messagestringOptional

        Nutzerbeschreibung nach öffentlicher Fehlerklassifizierung.

      • resultsarrayErforderlich

        Generierte Ausgabeelemente; jedes hat einen unabhängigen Archivierungsstatus.

        Unterfelder von results (1)
        • []objectOptional
          Unterfelder von [] (7)
          • file_idstringOptional

            Öffentliche ID einer verwalteten Datei desselben Kontos und Schlüssels.

          • storage_statusstringOptional

            Dateiarchivierungsstatus; verwaltete Downloads sind erst nach ready garantiert verfügbar.

          • storage_errorstringOptional

            Öffentliche Kategorie eines Dateiarchivierungsfehlers.

          • expires_atintegerOptional

            Ablauf in Unix-Sekunden; 0 bedeutet keine feste Frist.

          • urlstringOptional

            Zugriffs-URL für Ergebnis oder Referenz; signierte URLs gelten nur kurzzeitig.

          • b64_jsonstringOptional

            Base64-Zeichenfolge des Bildes; nicht als URL aufrufen.

          • revised_promptstringOptional

            Vom Dienst zurückgegebener überarbeiteter Prompt, sofern vorhanden.

  • next_cursorstringErforderlich

    Cursor der nächsten Seite unverändert als Seitenparameter zurückgeben; leer bedeutet letzte Seite.

HTTP 400

Ungültige Anfragefelder oder Parameter.

application/json

Typ
object
Pflichtfelder
error

HTTP 401

Key fehlt, ist ungültig, abgelaufen oder widerrufen.

application/json

Typ
object
Pflichtfelder
error

HTTP 403

Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.

application/json

Typ
object
Pflichtfelder
error

HTTP 404

Objekt/Funktion nicht verfügbar oder Funktionsschalter deaktiviert.

application/json

Typ
object
Pflichtfelder
error

HTTP 409

Idempotenz-/Kostenvoranschlagskonflikt, Objekt nicht bereit oder noch referenziert.

application/json

Typ
object
Pflichtfelder
error

HTTP 429

Anfrage-/Warteschlangenlimit.

application/json

Typ
object
Pflichtfelder
error

HTTP 500

Interner Authentifizierungs- oder Datenspeicherungsfehler.

application/json

Typ
object
Pflichtfelder
error

HTTP 503

Dienst, Preisberechnung oder Speicherung nicht verfügbar.

application/json

Typ
object
Pflichtfelder
error
Bereit zum Entwickeln? Öffnen Sie Konsole um einen API-Schlüssel zu erstellen, oder durchsuchen Sie Funktionen.