Dokumentation

API-Referenz

Tool-Ausführung abrufen

GET/v1/tool-runs/{id}

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.

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

Pfadparameter

  • idstringErforderlich

    Tool-ID aus dem Katalog oder ursprüngliche Tool-Ausführungs-ID, je nach Zielobjekt der Operation.

Antworten und Fehler

HTTP 200

Tool-Ausführung erfolgreich abgerufen

application/json

Typ
object
Pflichtfelder
idtool_idversionstatusoutputbillingresult_expiredcreated_atupdated_at
  • 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.

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.