Verwaltung
API-Schlüssel-Nutzung abrufen
Gibt paginierte Nutzungsdetails für einen API-Schlüssel eines Benutzers zurück.
Übersicht
Gibt paginierte Nutzungsdatensätze für einen API-Schlüssel zurück.
Abfrageparameter
| Parameter | Typ | Standard / Grenzwerte | Hinweise |
|---|---|---|---|
page | integer | Standard 1, min 1 | 1-basierte Seitennummer |
limit | integer | Standard 50, min 1, max 100 | Seitengröße |
model | string | max. Länge 100 | Angeforderter Modellname |
modelVendor | string | max. Länge 100 | Öffentlicher Modellanbieter |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | Inklusive Untergrenze; akzeptiert RFC3339 mit Zeitzone oder YYYY-MM-DD (00:00 UTC) |
endDate | string | - | Inklusive Obergrenze; akzeptiert RFC3339 mit Zeitzone oder YYYY-MM-DD. Ein reines Datum bedeutet 00:00 UTC zu Beginn des Tages; um einen ganzen Tag einzuschließen, verwenden Sie das nächste Datum oder eine RFC3339-Zeit |
Wenn sowohl startDate als auch endDate vorhanden sind, muss startDate vor oder am gleichen Tag wie endDate liegen.
Hinweise
-
Währungsfelder sind nur in USD.
-
Die Antwort ist paginiert.
-
Abgerechnete Datensätze können eine
billing_transaction_identhalten. Speichern Sie diese zusammen mit derrequest_id, wenn Sie eine Belastung einer Anfrage zuordnen müssen. -
Datensätze sind nach
created_atsortiert, die neuesten zuerst. -
Ein
429-Fehler mit dem Codereport_busybedeutet, dass die Berichtswarteschlange voll ist. Versuchen Sie es nach den inRetry-Afterangegebenen Sekunden erneut.
Anfrage
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=chat&startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
-H "Authorization: Bearer mt-your-management-token"Anfrage / Antwort
Diese Seite stellt das OpenAPI-Schema und kopierbare Anfragebeispiele bereit. Senden Sie Management-Anfragen von Ihrem Terminal oder Client mit einem Management Token; ein direktes Senden ist auf dieser Seite nicht möglich.
Antwort
{
"api_key": {
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-sonnet-4-6"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
},
"items": [
{
"request_id": "req_abc123",
"billing_transaction_id": "billtxn_abc123",
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"scene": "chat",
"usage_unit": "per_token",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500",
"prompt_tokens": 1000,
"completion_tokens": 500,
"total_tokens": 1500,
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"cache_write_tokens_5m": 0,
"cache_write_tokens_1h": 0,
"cost": 0.0012,
"cost_decimal": "0.0012",
"created_at": "2026-07-08T03:15:00.000Z",
"requested_policy": null,
"resolved_tier": null,
"charged_price_basis": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
},
"summary": {
"total_requests": 1,
"total_cost": 0.0012,
"total_cost_decimal": "0.0012",
"total_prompt_tokens": 1000,
"total_completion_tokens": 500,
"total_tokens": 1500,
"usage_unit_breakdown": [
{
"usage_unit": "per_token",
"usage_quantity": 1500
}
]
},
"breakdowns": {
"by_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_logical_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_model_vendor": [
{
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012
}
],
"by_scene": [
{
"scene": "chat",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012"
}
],
"daily_cost": [
{
"date": "2026-07-08T00:00:00.000Z",
"cost": 0.0012,
"cost_decimal": "0.0012"
}
]
}
}Wichtige Felder
page, limit, total und totalPages.per_token.auto, verified, official, null. Angeforderte Bereitstellungsrichtlinie, sofern aufgezeichnet.verified, official, null. Verwendete Bereitstellungsstufe, sofern aufgezeichnet.measure.dimensions webSearchCalls oder groundedPrompts, und effectiveUnitPrices enthält den Preis jedes Aufrufs als webSearch oder groundedPrompt.Autorisierung
ManagementTokenAuth Management-Token-Authentifizierung. Erstellen oder verwalten Sie Management-Token unter Dashboard > API > Management Tokens.
Ort: header
Pfadparameter
Abfrageparameter
Seitennummer (beginnend bei 1). Standard ist 1.
1 <= value1Seitengröße. Standard ist 50, das Maximum ist 100.
1 <= value <= 10050Nach angefordertem Modellnamen filtern. Maximale Länge 100.
length <= 100Nach öffentlichem Modell-Anbieter filtern. Maximale Länge 100.
length <= 100Nach öffentlicher Anfrageszene filtern.
Zulässige Werte
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
Untergrenze, inklusive. Akzeptiert RFC3339 mit Zeitzone (zum Beispiel 2026-03-28T00:00:00+08:00) oder YYYY-MM-DD, was 00:00 UTC bedeutet.
Obergrenze, inklusive. Akzeptiert RFC3339 mit Zeitzone (zum Beispiel 2026-03-28T23:59:59+08:00) oder YYYY-MM-DD, was 00:00 UTC zu Beginn dieses Tages bedeutet. Um einen ganzen Tag einzuschließen, übergeben Sie das Datum des nächsten Tages oder eine RFC3339-Zeit am Ende des Tages.
Antwort
application/json
application/json
application/json
application/json
application/json
application/json