API-Schlüsselnutzung abrufen
Management key required. Ruft Anfragezahlen und abgerechnete USD-Kosten eines Schlüssels ab, auch nach seiner Löschung.
api_key_id in der URL ist das Feld id im Format ak_... aus der Antwort von API-Schlüssel erstellen (POST /public/v1/api-keys). Speichern Sie es zum Deaktivieren, Löschen, Ändern des Budgets und Abfragen der Nutzung. Das Feld key (apikey-...) dient Modellaufrufen; Verwaltungsaufrufe verwenden weiterhin mgmt-... im Autorisierungsheader.
Management key required. Use a Management API Key (mgmt-...) for your Team, created by a Team Owner. Requests use the Team associated with that key.
Includes disabled, expired and deleted keys and keys in archived projects. Only API-key-based sources are counted; a user with the same internal ID is excluded. See ResourceUsage for accounting semantics. Unknown or repeated query parameters are rejected.
Authorization
ManagementKeyBearer Management key required. Send Authorization: Bearer mgmt-....
In: header
Path Parameters
The id returned by Create a model API key (POST /public/v1/api-keys). Copy the complete ak_... value into this path parameter. Use the mgmt-... management key in the authorization header; the returned key (apikey-...) is for model calls.
^ak_[0-9A-Za-z]{22}$Query Parameters
Inclusive RFC 3339 start after the Unix epoch, aligned to a UTC hour boundary. Maximum window is 31 days.
date-timeExclusive RFC 3339 end, aligned to a UTC hour boundary and strictly after from.
date-timeResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage?from=2026-11-01T00%3A00%3A00Z&to=2026-11-02T00%3A00%3A00Z"{ "object": "api_key_usage", "api_key_id": "ak_0123456789ABCDEFGHIJKL", "from": "2026-11-01T00:00:00Z", "to": "2026-11-02T00:00:00Z", "requests": 12, "successes": 10, "failures": 2, "amount": { "value": "1.230000", "currency": "usd" }, "request_id": "req_example"}Last updated on
API-Schlüsselbudget ersetzen PUT
Management key required. Setzt ein unbegrenztes, festes oder periodisches Budget, ohne die Nutzung zurückzusetzen.
Kontostand abrufen GET
Model API key required. Gibt den aktuellen Kontostand und die Übersicht der Guthabenzuteilungen für das Konto des authentifizierten API-Schlüssels zurück.