API-Referenz

Übersicht

TokenLab ist native-first und OpenAI-kompatibel. Verwende provider-native Routen wie POST /v1/messages für Anthropic und /v1beta/models/…:generateContent für Gemini, wenn du natives Verhalten brauchst. Nutze OpenAI-kompatible /v1-Endpunkte, wenn du bestehende OpenAI-ähnliche SDKs oder Tools migrierst. POST /v1/responses bleibt ein optionaler erweiterter Pfad für Responses-spezifisches Verhalten.

Basis-URL

https://api.tokenlab.sh

Authentifizierung

Alle API-Endpunkte erfordern eine Authentifizierung mit einem Bearer-Token:

Authorization: Bearer sk-your-api-key

Holen Sie Ihren API-Schlüssel vom Dashboard.

Zum interaktiven Playground: Der Playground auf dieser Dokumentationsseite dient nur zu Demonstrationszwecken und unterstützt das Eingeben von API-Schlüsseln nicht. Um die API zu testen, verwenden Sie bitte:

cURL - Kopieren Sie die Beispielbefehle und ersetzen Sie sk-your-api-key durch Ihren tatsächlichen Schlüssel
Postman - Importieren Sie unsere OpenAPI spec
SDK - Verwenden Sie das OpenAI/Anthropic SDK mit unserer Basis-URL

Unterstützte Endpunkte

Chat & Textgenerierung

Endpunkt	Methode	Beschreibung
`/v1/chat/completions`	POST	OpenAI-kompatible Chat-Completions
`/v1/messages`	POST	Anthropic-kompatible Messages-API
`/v1/responses`	POST	OpenAI Responses API

Embeddings und Reranking

Endpunkt	Methode	Beschreibung
`/v1/embeddings`	POST	Text-Embeddings erstellen
`/v1/rerank`	POST	Dokumente neu bewerten (Rerank)

Bilder

Endpunkt	Methode	Beschreibung
`/v1/images/generations`	POST	Bilder aus Text generieren
`/v1/images/edits`	POST	Bilder bearbeiten
`/v1/images/generations/{id}`	GET	Statuspfad für Bildaufgaben bei aufgabenbasierten Bildantworten

Einige Bildmodelle können Ergebnisse inline zurückgeben, einige liefern aufgabenbasierte Antworten, und einige verhalten sich je nach geroutetem Anbieter-Pfad unterschiedlich. Wenn die Create-Antwort poll_url enthält, folgen Sie dieser exakt.

Audio

Endpunkt	Methode	Beschreibung
`/v1/audio/speech`	POST	Text-zu-Sprache (TTS)
`/v1/audio/transcriptions`	POST	Sprache-zu-Text (STT)

Realtime

Endpunkt	Methode	Beschreibung
`/v1/realtime?model={model}`	WS	Realtime-WebSocket-Sitzungen

Verwenden Sie /v1/realtime für WebSocket-Upgrade-Anfragen. Ein normales GET /v1/realtime gibt Endpunkt-Metadaten für Clients zurück, die WebSocket-Routen nicht direkt auswerten können. Dies ist nicht die OpenAI-Realtime-REST-Oberfläche; client secret, translation client secret, Calls und legacy beta session-Endpunkte sind derzeit nicht öffentlich verfügbar.

Video

Endpunkt	Methode	Beschreibung
`/v1/videos/generations`	POST	Video-Generierungsaufgabe erstellen
`/v1/tasks/{id}`	GET	Status asynchroner Aufgaben für Video-Jobs abrufen
`/v1/videos/generations/{id}`	GET	Abwärtskompatibler Statuspfad für Videoaufgaben

Für neue Clients bevorzugen Sie /v1/tasks/{id} und folgen Sie der von Create-Antworten zurückgegebenen poll_url. Behalten Sie /v1/videos/generations/{id} nur aus Gründen der Rückwärtskompatibilität.

Asynchrone Aufgaben

Endpunkt	Methode	Beschreibung
`/v1/tasks/{id}`	GET	Vereinheitlichter Endpunkt für den Status asynchroner Aufgaben. Empfohlen, wenn Sie einem zurückgegebenen `poll_url` folgen

Dieser Endpunkt ist nicht auf Video, Musik und 3D beschränkt. Einige Bildaufgaben können ebenfalls /v1/tasks/{id} als kanonischen Polling-Pfad verwenden.

Musik

Endpunkt	Methode	Beschreibung
`/v1/music/generations`	POST	Musik-Generierungsaufgabe erstellen
`/v1/music/generations/{id}`	GET	Musik-spezifischer Statuspfad

Für neue Clients bevorzugen Sie zunächst die zurückgegebene poll_url. Wenn Sie einen festen Task-Status-Endpunkt benötigen, verwenden Sie /v1/tasks/{id}; behalten Sie /v1/music/generations/{id} für musik-spezifische Kompatibilitätspfade.

3D-Generierung

Endpunkt	Methode	Beschreibung
`/v1/3d/generations`	POST	3D-Modell-Generierungsaufgabe erstellen
`/v1/3d/generations/{id}`	GET	3D-spezifischer Statuspfad

Für neue Clients bevorzugen Sie zunächst die zurückgegebene poll_url. Wenn Sie einen festen Task-Status-Endpunkt benötigen, verwenden Sie /v1/tasks/{id}; behalten Sie /v1/3d/generations/{id} für 3D-spezifische Kompatibilitätspfade.

Modelle

Endpunkt	Methode	Beschreibung
`/v1/models`	GET	Alle verfügbaren Modelle auflisten
`/v1/models/{model}`	GET	Informationen zu einem bestimmten Modell abrufen

Gemini (v1beta)

Native Unterstützung des Google Gemini API-Formats:

Endpunkt	Methode	Beschreibung
`/v1beta/models/{model}:generateContent`	POST	Inhalte generieren (Gemini-Format)
`/v1beta/models/{model}:streamGenerateContent`	POST	Inhalte streamen/generieren (Gemini-Format)

Gemini-Endpunkte unterstützen die Authentifizierung über den Query-Parameter ?key= zusätzlich zum standardmäßigen Bearer-Token.

Antwortformat

Alle Antworten folgen einem konsistenten Format:

Erfolgsantwort

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

Routing-Transparenz

Alle Antworten enthalten ein _routing-Feld mit Kanalinformationen:

{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai"
    },
    "cached": false,
    "retryCount": 0
  }
}

Feld	Beschreibung
`channel.id`	Verwendete Channel-Kennung
`channel.provider`	Upstream-Anbieter (openai, anthropic, etc.)
`cached`	Ob die Antwort aus dem Cache geliefert wurde
`retryCount`	Anzahl der Wiederholungsversuche (falls zutreffend)

Fehlerantwort

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

Ratenlimits

Standardwerte:

Rolle	Anfragen/min
Benutzer	1.000
Partner	10.000
VIP	10.000

Kontaktieren Sie den Support für benutzerdefinierte Rate Limits. Exakte Werte können je nach Kontokonfiguration variieren.

Wenn Rate Limits überschritten werden, gibt die API einen Statuscode 429 zurück mit einem Retry-After-Header, der angibt, wie lange gewartet werden soll.

OpenAPI-Spezifikation

Laden Sie die vollständige OpenAPI 3.0-Spezifikation herunter

Kern

Text & Chat

Dateien & Batch-Jobs

Bilder

Audio & Echtzeit

Musik

Video & Materialien

Worlds

3D

Asynchrone Jobs

Gemini nativ

Verwaltung

Übersicht

Basis-URL

Authentifizierung

Unterstützte Endpunkte

Chat & Textgenerierung

Embeddings und Reranking

Bilder

Audio

Realtime

Video

Asynchrone Aufgaben

Musik

3D-Generierung

Modelle

Gemini (v1beta)

Antwortformat

Erfolgsantwort

Routing-Transparenz

Fehlerantwort

Ratenlimits

OpenAPI-Spezifikation

OpenAPI-Spezifikation

​Übersicht

​Basis-URL

​Authentifizierung

​Unterstützte Endpunkte

​Chat & Textgenerierung

​Embeddings und Reranking

​Bilder

​Audio

​Realtime

​Video

​Asynchrone Aufgaben

​Musik

​3D-Generierung

​Modelle

​Gemini (v1beta)

​Antwortformat

​Erfolgsantwort

​Routing-Transparenz

​Fehlerantwort

​Ratenlimits

​OpenAPI-Spezifikation

OpenAPI-Spezifikation

Übersicht

Basis-URL

Authentifizierung

Unterstützte Endpunkte

Chat & Textgenerierung

Embeddings und Reranking

Bilder

Audio

Realtime

Video

Asynchrone Aufgaben

Musik

3D-Generierung

Modelle

Gemini (v1beta)

Antwortformat

Erfolgsantwort

Routing-Transparenz

Fehlerantwort

Ratenlimits

OpenAPI-Spezifikation