API-Referenz

Tool-Kostenvoranschlag abrufen

POST/v1/tools/{id}/quote

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. Die Pfad-id identifiziert das Tool. Der öffentliche Anfragekörper für Kostenvoranschläge akzeptiert nur eine erforderliche nicht leere version und input gemäß input_schema; zusätzliche Felder wie tool_id, quote_id und max_cost_usd werden abgelehnt. Kostenvoranschläge gelten 300 Sekunden und binden denselben Schlüssel, die exakte Version, normalisierte Eingabe und Preis-/Quellkonfiguration. Sie geben tool_id/version/maximum_usd zurück und übermitteln nichts an den Dienst.

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.

Anfragekörper · application/json

Typ
object
Pflichtfelder
versioninput
Zusätzliche Eigenschaften
false

Anfragekörper erforderlich

  • versionstringErforderlich

    Erforderliche, nicht leere Tool-Vertragsversion. Exakte version aus den Details verwenden; die aktuelle Version wird nicht automatisch angenommen.

    Mindestlänge
    1
    Muster
    ".*\\S.*"
  • inputunknownErforderlich

    Muss das input_schema dieser Tool-version erfüllen. Nur kanonisches JSON; zusätzliche Felder wie das administrative route_id sind verboten.

Antworten und Fehler

HTTP 200

Tool-Kostenvoranschlag erfolgreich abgerufen

application/json

Typ
object
Pflichtfelder
quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion
  • quote_idstringErforderlich

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

  • maximum_usdstringErforderlich

    Maximaler USD-Reservierungsbetrag für diese normalisierte Eingabe.

  • price_versionintegerErforderlich

    Revision des Verkaufspreises.

  • expires_atintegerErforderlich

    Ablauf in Unix-Sekunden; Tool-Kostenvoranschläge gelten 300 Sekunden, maßgeblich ist expires_at.

  • componentsunknownErforderlich

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

  • tool_idstringErforderlich

    An diesen Kostenvoranschlag gebundene Tool-ID.

  • versionstringErforderlich

    An diesen Kostenvoranschlag gebundene exakte Tool-Vertragsversion.

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.