# 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
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

```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

```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

```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

```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"}

```json
"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

{}

```json
"mem_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- workspaceId (optional): s63

### s63: string

Workspace des Keys. Ohne Angabe der Standard-Workspace.

{}

```json
"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.

{}

```json
"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"}

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

### s163: string

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

```json
"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"}

```json
[
  "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"}

```json
"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"}

```json
[
  "DE",
  "FR"
]
```

### s165: string

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

```json
"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.

{}

```json
"25"
```

- completion (optional): s132

### s132: string

EUR pro Million Ausgabetokens.

{}

```json
"25"
```

- request (optional): s133

### s133: string

EUR pro Upstream-Anfrage.

{}

```json
"25"
```

- image (optional): s134

### s134: string

EUR pro Eingabebild.

{}

```json
"25"
```

- audio (optional): s135

### s135: string

EUR pro von der Route festgelegter Einheit der Audioeingabe.

{}

```json
"25"
```

- page (optional): s136

### s136: string

EUR je OCR-Seite.

{}

```json
"25"
```

- character (optional): s137

### s137: string

EUR je PII-Eingabezeichen.

{}

```json
"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

{}

```json
"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.

{}

```json
"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

```json
{
  "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.

{}

```json
"sk-tl-v1-4fKq…"
```

- apiKey (Pflichtfeld): s15

### s15: object

{}

- id (Pflichtfeld): s66

### s66: string

Key-Identität, nie der Key selbst

{}

```json
"key_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- name (Pflichtfeld): s67

### s67: string

{}

```json
"Production backend"
```

- keyPrefix (Pflichtfeld): s68

### s68: string

Anfang des Keys zur Wiedererkennung

{}

```json
"sk-tl-v1-4fKq"
```

- workspace (Pflichtfeld): s69

### s69: object

Workspace, zu dem der Key gehört

{}

- id (Pflichtfeld): s100

### s100: string

{}

```json
"wsp_01k7tm3w8vfz6b2r4m9q5xyz7c"
```

- name (Pflichtfeld): s103

### s103: string

{}

```json
"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.

```json
{
  "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

{}

```json
400
```

- code (Pflichtfeld): s58

### s58: string

Fehlercode

{}

```json
"VALIDATION_ERROR"
```

- message (Pflichtfeld): s59

### s59: string

Fehlermeldung

{}

```json
"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

{}

```json
"title"
```

- message (Pflichtfeld): s180

### s180: string

Fehlermeldung zum Feld

{}

```json
"Required"
```

## Antwort 401: application/json

Authentifizierung erforderlich: Zugangsdaten fehlen oder sind ungültig.

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

## Antwort 403: application/json

Berechtigungsumfang reicht nicht aus: authentifiziert, aber nicht berechtigt.

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

## Antwort 404: application/json

Ressource nicht gefunden

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

## Antwort 409: application/json

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

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

## Antwort 500: application/json

Interner Serverfehler

```json
{
  "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.

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