Management-API

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Überblick

Mit der Management API können Sie Organisationsguthaben abrufen, Organisations-API-Keys verwalten und Nutzung sowie Billing für einen bestimmten Key abrufen, ohne einen normalen Inference-API-Key zu verwenden. Verwenden Sie ein Management-Token auf der Seite Einstellungen im Dashboard:

Authorization: Bearer mt-your-management-token

Management-Tokens sind nicht dasselbe wie Inference-API-Keys. Verwenden Sie mt-... für /v1/management/* und sk-... für Modell-Inference-Endpunkte wie /v1/responses.

Verfügbare Endpunkte

Endpunkt	Methode	Beschreibung
`/v1/management/balance`	GET	Ruft aktuelle Guthabensummen der Organisation ab
`/v1/management/api-keys`	GET	Listet benutzerverwaltete API-Keys in der aktuellen Organisation auf
`/v1/management/api-keys`	POST	Erstellt einen neuen Benutzer-API-Key
`/v1/management/api-keys/{keyId}`	PATCH	Aktualisiert Name, Nutzungslimit, erlaubte Modelle, Ablaufzeit oder Status
`/v1/management/api-keys/{keyId}/usage`	GET	Ruft paginierte Nutzungsdetails für einen bestimmten Key ab
`/v1/management/api-keys/{keyId}/billing`	GET	Ruft aggregierte Billing-Aufschlüsselungen für einen bestimmten Key ab

Nutzungsfilter

GET /v1/management/api-keys/{keyId}/usage unterstützt die folgenden Query-Parameter:

Parameter	Typ	Standard / Grenzen	Beschreibung
`page`	integer	Standard `1`, min. `1`	Seitennummer ab 1
`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`
`startDate`	string	-	Inklusive Untergrenze; akzeptiert RFC3339 mit Zeitzone oder `YYYY-MM-DD`
`endDate`	string	-	Inklusive Obergrenze; akzeptiert RFC3339 mit Zeitzone oder `YYYY-MM-DD`

Wenn startDate und endDate zusammen angegeben werden, muss startDate kleiner oder gleich endDate sein.

API-Key-Anfragekörper

POST /v1/management/api-keys

Feld	Typ	Standard / Grenzen	Beschreibung
`name`	string	erforderlich, Standard `Default Key`, Länge `1-50`	Anzeigename; führende und nachgestellte Leerzeichen werden serverseitig entfernt
`limitAmount`	number \| null	min. `0`, Eingabe max. `1000000`	`null` oder weggelassen = unbegrenzt, `0` = Nullkontingent. Positive Werte werden auf ein gespeichertes Limit normalisiert, das 100000 USD Gegenwert nicht überschreiten kann.
`limitCurrency`	enum	Standardwert `USD`	Nur USD. Das Senden von `CNY` gibt `400 currency_retired` zurück.
`models`	string[]	Standard `[]`	Optionale Modell-Allowlist
`expiresAt`	string \| null	RFC3339-Datetime	`null` bedeutet ohne Ablaufzeit

PATCH /v1/management/api-keys/

Feld	Typ	Standard / Grenzen	Beschreibung
`status`	enum	-	`active`, `inactive`, `revoked`
`name`	string	Länge `1-50`	Aktualisierter Anzeigename
`limitAmount`	number \| null	min. `0`, Eingabe max. `1000000`	`null` = unbegrenzt, `0` = Nullkontingent. Positive Werte werden auf ein gespeichertes Limit normalisiert, das 100000 USD Gegenwert nicht überschreiten kann.
`limitCurrency`	enum	Standardwert `USD`	Nur USD. Das Senden von `CNY` gibt `400 currency_retired` zurück.
`models`	string[]	-	Aktualisierte Modell-Allowlist
`expiresAt`	string \| null	RFC3339-Datetime	`null` entfernt die Ablaufzeit

Mindestens ein PATCH-Feld muss angegeben werden.

Geldbetragsfelder

Geldbetragsfelder in Anfragen und Antworten der Management API unterstützen ausschließlich USD.
limitCurrency ist standardmäßig USD; bei CNY wird 400 currency_retired zurückgegeben.

Reporting-Semantik

model bezeichnet den vom Aufrufer angeforderten Modellnamen.
modelVendor bezeichnet den öffentlichen Modellanbieter, nicht interne Ausführungsdetails.
scene ist die öffentliche Request-Szene, die aus Endpoint oder Task-Typ abgeleitet wird.

Die Antworten geben nur öffentliche Billing- und Reporting-Felder zurück. Provider-Ausführungsdetails bleiben verborgen.

Einzelne /usage-Zeilen können billing_transaction_id enthalten, sobald die zugrunde liegende Anfrage den abgerechneten Zustand erreicht hat. Verwenden Sie request_id + billing_transaction_id für den Abgleich auf Anfrageebene.

Hinweis zur Abrechnungspaginierung

/usage ist paginiert. /billing ist derzeit ein aggregierter Breakdown-Endpunkt und liefert keine page / limit-Paginierungsmetadaten. Wenn Sie Einzelzeilen benötigen, verwenden Sie /usage.

Schnellbeispiel

Prüfen Sie zunächst das Organisationsguthaben mit dem aktuellen Management-Token:

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Listen Sie danach die API-Keys auf, die demselben Management-Token zur Verfügung stehen:

curl "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Kern

Text & Chat

Dateien & Batch-Jobs

Bilder

Audio & Echtzeit

Musik

Video & Materialien

Worlds

3D

Asynchrone Jobs

Gemini nativ

Verwaltung

Überblick

Verfügbare Endpunkte

Nutzungsfilter

API-Key-Anfragekörper

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Geldbetragsfelder

Reporting-Semantik

Hinweis zur Abrechnungspaginierung

Schnellbeispiel

Nächste Schritte

​Überblick

​Verfügbare Endpunkte

​Nutzungsfilter

​API-Key-Anfragekörper

​POST /v1/management/api-keys

​PATCH /v1/management/api-keys/

​Geldbetragsfelder

​Reporting-Semantik

​Hinweis zur Abrechnungspaginierung

​Schnellbeispiel

​Nächste Schritte

Überblick

Verfügbare Endpunkte

Nutzungsfilter

API-Key-Anfragekörper

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Geldbetragsfelder

Reporting-Semantik

Hinweis zur Abrechnungspaginierung

Schnellbeispiel

Nächste Schritte