Tool-Ausführung erstellen

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. Neue Aufrufe erfordern nicht leere version/input und Idempotency-Key. Geht die Erstellungsantwort ohne run_id verloren, diese Operation mit ursprünglichem API-Schlüssel, ursprünglichem Idempotency-Key und vollständigem ursprünglichem Anfragekörper wiederholen, um die bestehende Ausführung wiederherzustellen; keinen neuen Kostenvoranschlag anfordern und die Kostenobergrenze nicht ändern. Wiederholung akzeptierter Ausführungen hängt nicht von aktuellen Schaltern oder der Gültigkeit des Kostenvoranschlags ab. Bei bekannter run_id nur die ursprüngliche Ausführung abfragen; bei unbekannter Übermittlung keine neue mit anderem Schlüssel erstellen.

Ausführung nach Kostenvoranschlag

Lesen Sie die genaue version, input_schema und pricing aus den Tool-Details. mode=flat ist ein konstanter Preis je Aufruf, mode=input eine Vorausberechnung nach Eingaben und mode=usage eine Berechnung nach endgültiger Nutzung. schema_version der Regeln beschreibt nur das Speicherformat.

Neue Aufrufe mit quote_required=true benötigen zuerst einen Kostenvoranschlag. Prüfen Sie die zurückgegebenen tool_id/version und speichern Sie quote_id sowie die ursprüngliche Anfrage. Bei requires_usage=true muss zusätzlich max_cost_usd mindestens maximum_usd betragen. Für andere Ausführungen ist ein Kostenlimit optional, wird aber ebenfalls geprüft, wenn es angegeben ist. Konstant bepreiste Ausführungen ohne endgültige Nutzungsanforderung können direkt starten. Eingaberegeln verlangen einen Kostenvoranschlag, können aber ohne endgültige Nutzungsdaten abgerechnet werden.

Der Kostenvoranschlag fixiert die ursprüngliche Quelle. Ändert sich später die Standardquelle, verwendet er weiter die ursprüngliche, solange diese und ihre Konfiguration gültig bleiben. Noch nicht eingereichte neue Aufrufe können bei quote_expired, quote_stale oder invalid_quote nach Eingabeprüfung neu kalkuliert werden. Ist die Ausführung erfolgreich, billing aber weiterhin reserved, fragen Sie die endgültige Nutzung weiter ab. Eine erfolgreiche Ausgabe beweist keinen Abrechnungsabschluss.

Wiederherstellung bei verlorener Antwort

Speichern Sie vor dem Senden die ursprüngliche API-Key-Identität, Idempotency-Key und den vollständigen Anfragekörper. Geht die Erstellungsantwort ohne run_id verloren, wiederholen Sie POST /v1/tool-runs mit derselben Key, demselben Anfrageschlüssel und der ursprünglichen vollständigen Anfrage. Behalten Sie quote_id und max_cost_usd bei, ohne neuen Kostenvoranschlag oder Schlüsselwechsel. Vorhandene Ausführungen geben bevorzugt den ursprünglichen Datensatz zurück, ohne erneuten Dienstaufruf. Die Wiederherstellung funktioniert auch bei später abgelaufenem Kostenvoranschlag oder deaktivierten neuen Aufrufen. Sobald run_id vorliegt, verwenden Sie nur GET für die ursprüngliche Ausführung.

Bei Idempotenzkonflikten müssen Sie die ursprüngliche Anfrage prüfen; erstellen Sie nicht automatisch mit neuem Schlüssel einen kostenpflichtigen Vorgang. Siehe Fehlerbehandlung, Abrechnung und Asynchrone Wiederherstellung.

Authorization: Bearer $GLOOP_API_KEY