API-Referenz
Tool-Kostenvoranschlag abrufen
/v1/tools/{id}/quoteUnterstü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_KEYAuthentifizierungsschemata: BearerAuth
Anfrage
Pfadparameter
idstringErforderlichTool-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
versionstringErforderlichErforderliche, nicht leere Tool-Vertragsversion. Exakte version aus den Details verwenden; die aktuelle Version wird nicht automatisch angenommen.
- Mindestlänge
1- Muster
".*\\S.*"
inputunknownErforderlichMuss 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_usdstringErforderlichMaximaler USD-Reservierungsbetrag für diese normalisierte Eingabe.
price_versionintegerErforderlichRevision des Verkaufspreises.
expires_atintegerErforderlichAblauf in Unix-Sekunden; Tool-Kostenvoranschläge gelten 300 Sekunden, maßgeblich ist expires_at.
componentsunknownErforderlichJSON-Wert gemäß Schema oder Protokoll des gewählten Tools; keine festen Felder annehmen.
tool_idstringErforderlichAn diesen Kostenvoranschlag gebundene Tool-ID.
versionstringErforderlichAn diesen Kostenvoranschlag gebundene exakte Tool-Vertragsversion.
HTTP 400
Ungültige Anfragefelder oder Parameter.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 401
Key fehlt, ist ungültig, abgelaufen oder widerrufen.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 403
Unzureichende IP-, Konto-, Modell- oder Tool-Berechtigungen.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 404
Objekt/Funktion nicht verfügbar oder Funktionsschalter deaktiviert.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 409
Idempotenz-/Kostenvoranschlagskonflikt, Objekt nicht bereit oder noch referenziert.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 429
Anfrage-/Warteschlangenlimit.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 500
Interner Authentifizierungs- oder Datenspeicherungsfehler.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional
HTTP 503
Dienst, Preisberechnung oder Speicherung nicht verfügbar.
application/json
- Typ
- object
- Pflichtfelder
error
errorobjectErforderlichUnterfelder von error (4)
codestringOptionalmessagestringOptionaltypestringOptionalrequest_idstringOptional