Dokumentation

API-Referenz

Tool-Ausführungen abfragen

GET/v1/tool-runs

Unterstützt einheitlich flat als konstanten Preis pro Aufruf, input als Vorabberechnung anhand der Eingaben und usage anhand der endgültigen Nutzung. pricing.quote_required bestimmt, ob ein Kostenvoranschlag erforderlich ist; requires_usage bestimmt, ob eine Kostenobergrenze und bestätigte endgültige Nutzungsdaten erforderlich sind. Beides wird nicht aus schema_version abgeleitet. Bei deaktiviertem metered_pricing sind nur neue Aufrufe eingeschränkt, die endgültige Nutzungsdaten benötigen; konstante/eingabebasierte Regeln ohne dieses Erfordernis bleiben nutzbar. Der aktuelle Schlüssel benötigt Tool-Berechtigung; Ausführungsidentität und Ergebnisse sind an den ursprünglichen Schlüssel gebunden. Bei deaktiviertem Tool-Hauptschalter ist der Katalog leer; der anonyme Katalog erteilt keine Ausführungsberechtigung. Listet nur Ausführungen des ursprünglichen Schlüssels, streng nach created_at absteigend und id absteigend; id löst Gleichstände innerhalb derselben Sekunde stabil auf. next_cursor ist ein opaker Zweier-Cursor und muss unverändert zurückgegeben werden; falsches Format liefert 400 invalid_cursor. Die Seitennavigation ist keine zeitliche Momentaufnahme. Für neue Datensätze vor dem aktuellen Cursor die erste Seite aktualisieren.

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 erstellen. Ungültige Cursor liefern 400 invalid_cursor.

  • limitintegerOptional

    Katalogbereich 1–100, ungültige Werte verwenden 20; Ausführungsliste 1–100, ungültige Werte verwenden 20.

Antworten und Fehler

HTTP 200

Tool-Ausführungen erfolgreich abgefragt

application/json

Typ
object
Pflichtfelder
items
  • itemsarrayErforderlich

    Array der Tools oder Ausführungen auf der aktuellen Seite.

    Unterfelder von items (1)
    • []objectOptional
      Unterfelder von [] (10)
      • idstringErforderlich

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

      • tool_idstringErforderlich

        Tool-ID aus dem ausführbaren Katalog des aktuellen Schlüssels.

      • versionstringErforderlich

        Vertrags-/Funktions- oder Tool-Version; Ausführungen verwenden die im Katalog angegebene Tool-Version.

      • statusstringErforderlich

        submitting/running/submission_unknown/succeeded/failed; submission_unknown bedeutet unbekanntes Übermittlungsergebnis: nicht mit geändertem Idempotency-Key wiederholen.

      • outputunknownErforderlich

        JSON gemäß output_schema des Tools; nach Ablauf nicht davon ausgehen, dass das Ergebnis noch existiert.

      • error_codestringOptional

        Öffentlicher Fehlercode für Fallunterscheidungen.

      • billingobjectErforderlich

        Unabhängiger Abrechnungsstatus; nicht durch den Generierungsstatus ersetzen.

        Unterfelder von billing (7)
        • review_requiredbooleanOptional

          Abrechnungsnachweise müssen manuell geprüft werden.

        • reasonstringOptional

          Öffentlicher Grund für nicht verfügbare Aktion oder Abrechnungsprüfung.

        • usageunknownOptional

          JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

        • breakdownunknownOptional

          JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

        • statusstringErforderlich

          Aktueller Objektstatus; getrennt von Abrechnung und Speicherungsstand bewerten.

        • reserved_usdstringErforderlich

          Maximaler USD-Reservierungsbetrag als Zeichenfolge.

        • charged_usdstringErforderlich

          Aktuell bestätigter USD-Abrechnungsbetrag als Zeichenfolge.

        allOf-Zweig 1

        Typ: object

        In diesem Zweig erforderlich: status, reserved_usd, charged_usd

        • review_requiredbooleanOptional

          Abrechnungsnachweise müssen manuell geprüft werden.

        • reasonstringOptional

          Öffentlicher Grund für nicht verfügbare Aktion oder Abrechnungsprüfung.

        • usageunknownOptional

          JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

        • breakdownunknownOptional

          JSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.

        • statusstringErforderlich

          Aktueller Objektstatus; getrennt von Abrechnung und Speicherungsstand bewerten.

        • reserved_usdstringErforderlich

          Maximaler USD-Reservierungsbetrag als Zeichenfolge.

        • charged_usdstringErforderlich

          Aktuell bestätigter USD-Abrechnungsbetrag als Zeichenfolge.

      • result_expiredbooleanErforderlich

        Ob das Ergebnis abgelaufen ist; Abrechnungs-/Idempotenzdatensätze bleiben erhalten.

      • created_atintegerErforderlich

        Erstellungszeit in Unix-Sekunden.

      • updated_atintegerErforderlich

        Letzte Aktualisierung in Unix-Sekunden.

  • next_cursorstringOptional

    Strikt undurchsichtiger created_at/id-Cursor, unverändert zurückgeben. Ungültiges Format: 400 invalid_cursor; fehlend oder leer: 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.