API-Key anlegen

Legt einen Key an und gibt ihn einmalig unter key zurück. Gespeichert wird nur sein Hash. Ein verlorener Key kann nicht wiederhergestellt werden. Ein fremder oder unbekannter Workspace führt zu 404. Ein Management-Key kann keine Management-Keys anlegen (isManagement: true ergibt 403); diese legst du als Organisations-Admin im Dashboard an.

POST https://tokenlane.de/api/keys

Authentifizierung

[ [ { "name": "Authorization", "description": "Management-Key der Organisation: Authorization: Bearer sk-tl-v1-…. Bestehende sk-eu--Keys bleiben gültig. Erforderliche Scopes stehen in x-scopes; Inferenz-Keys berechtigen nicht zu Verwaltungsoperationen.", "type": "http bearer", "location": "", "scopes": [] } ] ]

curl

curl --request POST \
  --url 'https://tokenlane.de/api/keys' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Origin: https://tokenlane.de' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Production backend",
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
}'

node

const response = await fetch("https://tokenlane.de/api/keys", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Origin": "https://tokenlane.de",
    "Content-Type": "application/json",
  },
  body: `{
  "name": "Production backend",
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
}`,
});
console.log(await response.text());

python

import os
import urllib.request

body = (r'''{
  "name": "Production backend",
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
}''').encode("utf-8")

request = urllib.request.Request(
    "https://tokenlane.de/api/keys",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
        "Origin": "https://tokenlane.de",
        "Content-Type": "application/json",
    },
    data=body,
)

with urllib.request.urlopen(request) as response:
    print(response.read().decode("utf-8"))

vercel

// This operation uses HTTP directly.
const response = await fetch("https://tokenlane.de/api/keys", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
    "Origin": "https://tokenlane.de",
    "Content-Type": "application/json",
  },
  body: `{
  "name": "Production backend",
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
}`,
});
console.log(await response.text());

Anfrageinhalt: application/json

{
  "name": "Production backend",
  "workspaceId": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
}

s12: object

{"additionalProperties":"false"}

  • name (Pflichtfeld): s62

s62: string

Anzeigename, den das Gateway unter label ausgibt.

{"minLength":"1","maxLength":"100"}

"Production backend"
  • owner (optional): s44

s44: oneOf

Standardmäßig persönlicher Besitz für Workspace-Entwickler, andernfalls Besitz des Workspaces

{}

oneOf: s142

s142: object

{"additionalProperties":"false"}

  • kind (Pflichtfeld): s170

s170: string

"workspace"

{}

oneOf: s143

s143: object

{"additionalProperties":"false"}

  • kind (Pflichtfeld): s171

s171: string

"me"

{}

oneOf: s144

s144: object

{"additionalProperties":"false"}

  • kind (Pflichtfeld): s172

s172: string

"member"

{}

  • memberId (Pflichtfeld): s173

s173: string

Organisationsmitglied, dem dieser Key gehört

{}

"mem_01k7tm3w8vfz6b2r4m9q5xyz7c"
  • workspaceId (optional): s63

s63: string

Workspace des Keys. Ohne Angabe der Standard-Workspace.

{}

"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
  • isManagement (optional): s64

s64: boolean

Verwaltungsschlüssel anlegen; erfordert eine Sitzung eines Organisations-Owners oder Admins, niemals einen Bearer-Verwaltungsschlüssel

{"default":"false"}

  • policy (optional): s40

s40: object

Regeln eines Keys in der vom Gateway gelesenen Form (gw_core::KeyPolicy). Unbekannte Felder werden abgelehnt. Für eine Anfrage gilt die Schnittmenge aus Organisations-, Workspace- und Key-Policy: Jede Ebene darf nur weiter einschränken.

{"additionalProperties":"false"}

  • bridges (optional): s106

s106: object

Automatische Umwandlungen je Brücke (file-parser: PDF zu Text). Innere Ebenen können nur einschränken: ein strengerer Modus oder eine niedrigere Kostengrenze.

{"additionalProperties":"false"}

  • file-parser (optional): s41

s41: object

Einschränkungen für eine Brücke auf einer Ebene.

{"additionalProperties":"false"}

  • mode (optional): s128

s128: string

auto wandelt nur um, wenn der Request sonst scheitern würde, opt_in nur, wenn der Request das Plugin aktiviert, off nie. Weggelassen: auto.

"off", "opt_in", "auto"

{}

  • max_auto_cost (optional): s129

s129: string | null

Höchste automatische Reservierung in EUR als Dezimalstring; null oder weggelassen übernimmt die konfigurierte Grenze. Ausdrücklich angefragte Plugins begrenzt sie nicht.

{}

"0.05"
  • locked (optional): s130

s130: boolean

Requests können eine wirksame automatische Brücke nicht abschalten. Innere Ebenen können die Brücke wie immer weiter einschränken, aber nie lockern.

{}

  • byok (optional): s107

s107: boolean | null

Finanzierung: true verlangt BYOK; false verbietet BYOK; null übernimmt die übergeordnete Regel.

{}

  • allowed_models (optional): s108

s108: array

Modell-IDs oder Muster, die der Key verwenden darf. * steht für beliebige Werte. Ohne Angabe ist jedes Modell erlaubt.

{"minItems":"1","maxItems":"200"}

[
  "deepseek/deepseek-v4.1-flash",
  "mistralai/*"
]

s163: string

{"minLength":"1","maxLength":"256"}

"mistralai/*"
  • denied_models (optional): s109

s109: array

Modell-IDs oder Muster, die trotz Übereinstimmung mit allowed_models abgelehnt werden. Eine Ablehnung auf irgendeiner Ebene hat immer Vorrang.

{"maxItems":"200"}

[
  "openai/*"
]
  • allowed_providers (optional): s110

s110: array

Provider, die Anfragen bedienen dürfen, benannt wie provider.only (Provider-ID oder provider/variant für eine Tarifvariante). Nicht angegeben: alle Provider.

{"minItems":"1","maxItems":"200"}

s164: string

{"minLength":"1","maxLength":"128"}

"mistral"
  • denied_providers (optional): s111

s111: array

Provider, die keine Anfragen bedienen dürfen, benannt wie provider.ignore.

{"maxItems":"200"}

  • allowed_countries (optional): s112

s112: array

Länder, in denen verarbeitet werden darf (ISO 3166-1 Alpha-2, Großbuchstaben). Eine Route kommt nur infrage, wenn sie ihre Verarbeitungsländer nennt und alle in der Liste stehen.

{"minItems":"1","maxItems":"249"}

[
  "DE",
  "FR"
]

s165: string

{"pattern":"\"^[A-Z]{2}$\""}

"DE"
  • min_compliance (optional): s113

s113: string

Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: global (uneingeschränkt), eu_data_residency, eu_operated oder sovereign_eu.

"global", "eu_data_residency", "eu_operated", "sovereign_eu"

{}

  • require_zdr (optional): s114

s114: boolean

Nur Routen ohne Aufbewahrung von Prompt- und Antwortinhalten.

{}

  • deny_training (optional): s115

s115: boolean

Routen ausschließen, deren Provider Kundendaten möglicherweise zum Training nutzt (auch bei unbekanntem Status).

{}

  • max_price (optional): s42

s42: object

Höchste akzeptierte Routenpreise in EUR als Dezimalstrings; eine Anfrage darf sie nicht erhöhen.

{"additionalProperties":"false"}

  • prompt (optional): s131

s131: string

EUR pro Million Eingabetokens.

{}

"25"
  • completion (optional): s132

s132: string

EUR pro Million Ausgabetokens.

{}

"25"
  • request (optional): s133

s133: string

EUR pro Upstream-Anfrage.

{}

"25"
  • image (optional): s134

s134: string

EUR pro Eingabebild.

{}

"25"
  • audio (optional): s135

s135: string

EUR pro von der Route festgelegter Einheit der Audioeingabe.

{}

"25"
  • page (optional): s136

s136: string

EUR je OCR-Seite.

{}

"25"
  • character (optional): s137

s137: string

EUR je PII-Eingabezeichen.

{}

"25"
  • forbid_capture (optional): s116

s116: boolean

Prompts und Antworten dürfen nicht gespeichert werden, unabhängig von capture am Key.

{}

  • default_sort (optional): s117

s117: string

Standard für provider.sort, wenn die Anfrage keinen Wert nennt.

"price", "throughput", "latency"

{}

  • default_allow_fallbacks (optional): s118

s118: boolean

Standard für provider.allow_fallbacks, wenn die Anfrage keinen Wert nennt.

{}

  • locked (optional): s119

s119: array

Routing-Standards dieser Policy, die Anfragen und innere Ebenen nicht überschreiben dürfen. Für jede hier aufgeführte Einstellung muss dieselbe Policy einen Standardwert enthalten.

{}

s166: string

"sort", "allow_fallbacks"

{}

  • rate_limits (optional): s120

s120: object

{"additionalProperties":"false"}

  • rpm (optional): s167

s167: integer | null

{"minimum":"1","maximum":"4294967295"}

  • tpm (optional): s167
  • max_parallel_requests (optional): s167
  • pii_redact (optional): s121

s121: array

Vom Betreiber eingerichtete, erzwungene Unkenntlichmachung. Lesen und Bearbeiten in der Verwaltung bewahren vorhandene Regeln; Änderungen dieser Regeln erfordern eine Betreiberprüfung der Detektor- und Providerkonfiguration.

{"maxItems":"16"}

s168: object

{"additionalProperties":"false"}

  • when (optional): s184

s184: object

{"additionalProperties":"false"}

  • below_compliance (optional): s191

s191: string | null

Schwächste zulässige Einstufung der Rechtsordnung einer Route, in aufsteigender Reihenfolge: global (uneingeschränkt), eu_data_residency, eu_operated oder sovereign_eu.

"global", "eu_data_residency", "eu_operated", "sovereign_eu", null

{}

  • providers_except (optional): s192

s192: array | null

{"maxItems":"128"}

  • models (optional): s193

s193: array | null

{"minItems":"1","maxItems":"128"}

  • entities (optional): s185

s185: array

{"minItems":"1"}

s194: string

"person", "address", "email", "phone", "iban", "identifier", "date_of_birth", "organization"

{}

  • threshold (optional): s186

s186: number

{"minimum":"0","maximum":"1"}

  • restore (optional): s89

s89: boolean

{}

  • expires_at (optional): s122

s122: string

Ab diesem Zeitpunkt wird der Key abgelehnt (RFC 3339).

date-time

{}

"2026-12-31T23:59:59Z"
  • allow_attribution_export (optional): s123

s123: boolean | null

Der Export von Zuordnungsdaten des Aufrufers erfordert die globale Freigabe durch den Betreiber und die ausdrückliche Zustimmung des Keys mit true. false in Organisation, Workspace oder Key verhindert den Export; ein fehlender Wert oder null erbt die Vorgabe, ohne die Zustimmung des Keys zu erteilen.

{}

  • capture (optional): s124

s124: boolean

Ob Prompts und Antworten dieses Keys für den späteren Abruf gespeichert werden.

{}

  • limit (optional): s125

s125: string

EUR-Ausgabenlimit als Dezimalzeichenkette.

{}

"25"
  • limit_reset (optional): s126

s126: string

UTC-Zeitfenster, nach dem die auf limit angerechneten Ausgaben bei 0 beginnen. Wochen beginnen am Montag.

"daily", "weekly", "monthly"

{}

  • server_tools (optional): s127

s127: array

Vom Key verwendbare Server-Tools. Sie kosten zusätzlich und senden Teile der Anfrage an Dritte.

{}

s169: string

"web_search"

{}

Antwort 201: application/json

Ressource erfolgreich erstellt

{
  "key": "sk-tl-v1-4fKq…",
  "apiKey": {
    "id": "key_01k7tm3w8vfz6b2r4m9q5xyz7c",
    "name": "Production backend",
    "keyPrefix": "sk-tl-v1-4fKq",
    "workspace": {
      "id": "wsp_01k7tm3w8vfz6b2r4m9q5xyz7c",
      "name": "Default"
    },
    "isManagement": false,
    "owner": {
      "kind": "workspace"
    },
    "usage": {
      "currency": "EUR",
      "lastUsedAt": "YOUR_LASTUSEDAT",
      "totalPicoEur": "YOUR_TOTALPICOEUR",
      "periodPicoEur": "YOUR_PERIODPICOEUR",
      "periodStartsAt": "YOUR_PERIODSTARTSAT",
      "asOf": "YOUR_ASOF"
    },
    "disabled": false,
    "policy": {
      "allowed_models": [
        "deepseek/deepseek-v4.1-flash",
        "mistralai/*"
      ],
      "denied_models": [
        "openai/*"
      ],
      "allowed_countries": [
        "DE",
        "FR"
      ],
      "expires_at": "2026-12-31T23:59:59Z",
      "limit": "25"
    },
    "createdAt": "YOUR_CREATEDAT",
    "updatedAt": "YOUR_UPDATEDAT"
  }
}

s13: object

{}

  • key (Pflichtfeld): s65

s65: string

Der Key selbst. Nur in dieser Antwort sichtbar. Er kann später nicht wiederhergestellt werden.

{}

"sk-tl-v1-4fKq…"
  • apiKey (Pflichtfeld): s15

s15: object

{}

  • id (Pflichtfeld): s66

s66: string

Key-Identität, nie der Key selbst

{}

"key_01k7tm3w8vfz6b2r4m9q5xyz7c"
  • name (Pflichtfeld): s67

s67: string

{}

"Production backend"
  • keyPrefix (Pflichtfeld): s68

s68: string

Anfang des Keys zur Wiedererkennung

{}

"sk-tl-v1-4fKq"
  • workspace (Pflichtfeld): s69

s69: object

Workspace, zu dem der Key gehört

{}

  • id (Pflichtfeld): s100

s100: string

{}

"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
  • name (Pflichtfeld): s103

s103: string

{}

"Default"
  • isManagement (Pflichtfeld): s70

s70: boolean

Verwaltet Keys der Organisation und kann keine Modelle aufrufen.

{}

  • owner (Pflichtfeld): s71

s71: oneOf

Beim Erstellen gewählte Zuordnung innerhalb der Organisation

{}

oneOf: s155

s155: object

{}

  • kind (Pflichtfeld): s170

oneOf: s156

s156: object

{}

  • kind (Pflichtfeld): s172
  • memberId (Pflichtfeld): s35

s35: string

{}

  • userId (Pflichtfeld): s35
  • name (Pflichtfeld): s35
  • email (Pflichtfeld): s35
  • usage (Pflichtfeld): s43

s43: object

{}

  • currency (Pflichtfeld): s81

s81: string

"EUR"

{}

  • lastUsedAt (Pflichtfeld): s138

s138: string | null

Erstellungszeitpunkt der neuesten Generierung. Nie der Zeitpunkt einer Verwaltungsänderung.

date-time

{}

  • totalPicoEur (Pflichtfeld): s139

s139: string | null

Alle aufgezeichneten Key-Kosten als ganze Pico-EUR. Null, wenn nicht verfügbar.

{"pattern":"\"^\\\\d+$\""}

  • periodPicoEur (Pflichtfeld): s140

s140: string | null

Aufgezeichnete Kosten im aktuellen UTC-Zeitfenster der Regeln. Ohne Zurücksetzen über die gesamte Laufzeit.

{"pattern":"\"^\\\\d+$\""}

  • periodStartsAt (Pflichtfeld): s86

s86: string | null

date-time

{}

  • asOf (Pflichtfeld): s141

s141: string | null

Zeitpunkt der Abrechnungsprojektion. Null bei Antworten auf Änderungen oder wenn nicht anwendbar.

date-time

{}

  • disabled (Pflichtfeld): s72

s72: boolean

Gesperrte Keys werden vom Gateway abgelehnt.

{}

  • policy (Pflichtfeld): s40
  • createdAt (Pflichtfeld): s73

s73: string

Erstellungszeitpunkt

date-time

{}

  • updatedAt (Pflichtfeld): s74

s74: string

Zeitpunkt der letzten Aktualisierung

date-time

{}

Antwort 400: application/json

Ungültige Anfrage: Validierungsfehler oder ungültige Eingabe.

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

s11: object

{}

  • requestId (optional): s56

s56: string

Serverseitige Zuordnungs-ID für einen internen Fehler. Auch in X-Request-Id enthalten.

uuid

{}

  • status (Pflichtfeld): s57

s57: number

HTTP-Statuscode

{}

400
  • code (Pflichtfeld): s58

s58: string

Fehlercode

{}

"VALIDATION_ERROR"
  • message (Pflichtfeld): s59

s59: string

Fehlermeldung

{}

"Request validation failed"
  • remedy_hint (optional): s60

s60: string

Sichere, ausführbare Abhilfe aus dem Fehlerkatalog.

{}

  • details (optional): s61

s61: array

Detaillierte Validierungsfehler

{}

s154: object

{}

  • path (Pflichtfeld): s179

s179: string

Feldpfad

{}

"title"
  • message (Pflichtfeld): s180

s180: string

Fehlermeldung zum Feld

{}

"Required"

Antwort 401: application/json

Authentifizierung erforderlich: Zugangsdaten fehlen oder sind ungültig.

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

Antwort 403: application/json

Berechtigungsumfang reicht nicht aus: authentifiziert, aber nicht berechtigt.

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

Antwort 404: application/json

Ressource nicht gefunden

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

Antwort 409: application/json

Aktuell veröffentlichte Bedingungen vor Fortsetzen dieser Sitzung lesen und akzeptieren

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

Antwort 500: application/json

Interner Serverfehler

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}

Antwort 503: application/json

Konfigurierter Upstream hat das Zeitlimit überschritten, ist fehlgeschlagen oder hat eine ungültige Antwort geliefert.

{
  "status": 400,
  "code": "VALIDATION_ERROR",
  "message": "Request validation failed"
}