Kern
API-Referenz
Endpoints, Authentifizierung, Antwort-Header und Fehler
Übersicht
TokenLab unterstützt OpenAI-kompatible Endpoints sowie die Anfrageformate von Anthropic und Gemini. Bestehende OpenAI-Clients können /v1 verwenden; wählen Sie ein anderes Format nur dann, wenn Ihre Anwendung ein spezifisches Verhalten benötigt, das für diese API erforderlich ist. POST /v1/responses ist optional und hängt von der Modellunterstützung ab.
Basis-URL
https://api.tokenlab.shAuthentifizierung
Modellanfragen verwenden einen TokenLab API-Key. Der Standard-Authentifizierungs-Header lautet:
Authorization: Bearer sk-your-api-keyGET /v1/models, GET /v1/models/{model}, GET /v1/models/{model}/pricing und GET /v1/pricing sind öffentlich und benötigen keinen Key. Anthropic Messages akzeptiert auch x-api-key; Gemini akzeptiert x-goog-api-key oder ?key= sowie Bearer-Authentifizierung. /v1/management/* erfordert ein Management-Token (mt-...).
Sie erhalten Ihren API-Key über die Console.
Bereitstellungsrichtlinie (Delivery Policy)
Generierungsanfragen akzeptieren X-TokenLab-Delivery-Policy: auto | verified | official. Ein Request-Header überschreibt die Einstellung des API-Keys, welche wiederum den Workspace-Standard überschreibt.
Autoverwendet TokenLab Verified, falls verfügbar, andernfalls Official. Sie bezahlen für die Option, die Ihre Anfrage abschließt.TokenLab Verifiedist eine von TokenLab verifizierte Bereitstellung. Es gilt der Verified-Preis.Officialberechnet den Official-Preis, welcher dem vom Modellhersteller veröffentlichten Preis entspricht.- Echtzeit-Sitzungen (Realtime sessions) verwenden den API-Key oder die Workspace-Einstellung und akzeptieren keine Request-Überschreibung.
Ein ungültiger Header gibt 400 zurück. Wenn die angeforderte Option nicht verfügbar ist, gibt TokenLab 503 delivery_tier_unavailable sowie eine Request-ID zurück. Lesen Sie retryable: Wenn für den ausgewählten Vorgang kein Angebot verfügbar ist, ist dieser Wert false. Wiederholen Sie dieselbe Anfrage nicht unverändert.
API-Seiten mit einem Anfrageformular akzeptieren Ihren TokenLab API-Key und senden echte Anfragen. Diese Anfragen belasten Ihr Kontoguthaben und Ihre Limits. Sie können auch cURL, Postman oder ein SDK verwenden.
Unterstützte Endpoints
Chat & Textgenerierung
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/chat/completions | POST | OpenAI-kompatible Chat-Completions |
/v1/messages | POST | Anthropic-kompatible Messages |
/v1/messages/count_tokens | POST | Eingabe-Tokens einer Messages-Anfrage zählen |
/v1/messages/batches | POST, GET | Message-Batches erstellen und auflisten |
/v1/messages/batches/{message_batch_id} | GET, DELETE | Message-Batch abrufen oder löschen |
/v1/messages/batches/{message_batch_id}/results | GET | Ergebnisse lesen |
/v1/messages/batches/{message_batch_id}/cancel | POST | Message-Batch abbrechen |
/v1/responses | POST | OpenAI Responses API |
/v1/responses/{id} | GET, DELETE | Gespeicherte Antwort abrufen oder löschen |
/v1/responses/compact | POST | Kontext einer Responses-Konversation komprimieren |
/v1/translations | POST | Text-zu-Text-Übersetzung |
Embeddings & Rerank
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/embeddings | POST | Text-Embeddings erstellen |
/v1/multimodal/embeddings | POST | Embeddings mit einem multimodalen Embedding-Modell erstellen |
/v1/rerank | POST | Dokumente neu bewerten (Rerank) |
Entscheidungen
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/systemone | POST | Typisierte Entscheidungsfragen auswerten |
Dateien & Batches
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/files | POST, GET | Dateien hochladen und auflisten |
/v1/files/{file_id} | GET, DELETE | Datei abrufen oder löschen |
/v1/files/{file_id}/content | GET | Dateiinhalt herunterladen |
/v1/batches | POST, GET | Batches erstellen und auflisten |
/v1/batches/{batch_id} | GET | Batch abrufen |
/v1/batches/{batch_id}/cancel | POST | Batch abbrechen |
Bilder
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/images/generations | POST | Bilder aus Text generieren |
/v1/images/edits | POST | Bilder bearbeiten |
/v1/images/variations | POST | Bildvariationen erstellen |
/v1/images/generations/{id} | GET | Kompatibilitäts-Statuspfad für aufgabenbasierte Bildantworten |
Modelle für Bilder können ein fertiges Bild oder eine asynchrone Aufgabe zurückgeben. Wenn die Antwort status: "pending" oder eine Aufgaben-ID enthält, fragen Sie GET /v1/tasks/{id} ab.
Audio
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/audio/speech | POST | Text-zu-Sprache (TTS) |
/v1/audio/transcriptions | POST | Sprache-zu-Text (STT) |
/v1/audio/translations | POST | Sprache in englischen Text übersetzen |
Echtzeit (Realtime)
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/realtime?model={model} | WS | Echtzeit-WebSocket-Sitzungen |
Verwenden Sie /v1/realtime für WebSocket-Upgrades. Ein einfaches GET /v1/realtime gibt Endpoint-Metadaten zurück. Dies ist nicht die OpenAI Realtime REST-Oberfläche; client-secret, Calls und Legacy-Beta-Sitzungs-Endpoints sind nicht verfügbar.
Video
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/videos/generations | POST | Video-Generierungsaufgabe erstellen |
/v1/videos/generations/{id} | GET | Kompatibilitäts-Statuspfad |
/v1/videos/assets | POST, GET | Seedance-Material-Assets erstellen und auflisten |
/api/v3/contents/generations/tasks | POST, GET | Seedance-Aufgaben mit dem Volcengine-Anfrageformat |
Fragen Sie GET /v1/tasks/{id} mit der Aufgaben-id ab. /v1/videos/generations/{id} bleibt für bestehende Integrationen verfügbar.
Asynchrone Aufgaben
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/tasks/{id} | GET | Status für jede asynchrone Aufgabe |
/v1/tasks/{id} | DELETE | Asynchrone Aufgabe abbrechen |
Fragen Sie GET /v1/tasks/{id} für jede asynchrone Aufgabe ab: Bilder, Video, Musik, 3D, Worlds und asynchrone Audiotranskription. Verwenden Sie die id oder task_id aus der Erstellungsantwort. Eine Worlds-Erstellungsantwort gibt eine poll_url unter /v1/worlds/generations/{id} zurück; fragen Sie dort ebenfalls /v1/tasks/{id} ab. Die modalitätsspezifischen Statuspfade auf dieser Seite sind Kompatibilitäts-Endpoints für bestehende Integrationen.
Musik
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/music/generations | POST | Musik-Generierungsaufgabe erstellen |
/v1/music/generations/{id} | GET | Kompatibilitäts-Statuspfad |
3D-Generierung
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/3d/generations | POST | 3D-Modell-Generierungsaufgabe erstellen |
/v1/3d/generations/{id} | GET | Kompatibilitäts-Statuspfad |
Worlds
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/worlds/generations | POST | World-Generierungsaufgabe erstellen |
/v1/worlds/list | POST | Worlds auflisten |
/v1/worlds/{id} | GET, DELETE | World abrufen oder löschen |
/v1/worlds/media-assets/prepare-upload | POST | Medien-Asset-Upload vorbereiten |
Modelle & Preise
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1/models | GET | Alle verfügbaren Modelle auflisten |
/v1/models/{model} | GET | Spezifische Modellinformationen abrufen |
/v1/models/{model}/pricing | GET | Preise eines Modells abrufen |
/v1/pricing | GET | Modellpreise auflisten |
Gemini (v1beta)
Native Unterstützung des Google Gemini API-Formats:
| Endpoint | Methode | Beschreibung |
|---|---|---|
/v1beta/models | GET | Modelle auflisten, die Gemini-Anfragen akzeptieren |
/v1beta/models/{model} | GET | Modell abrufen |
/v1beta/models/{model}:generateContent | POST | Inhalt generieren |
/v1beta/models/{model}:streamGenerateContent | POST | Inhalt streamen |
/v1beta/models/{model}:countTokens | POST | Tokens zählen |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | Gemini-Dateien und zwischengespeicherte Inhalte |
Gemini-Endpoints unterstützen zusätzlich zur Standard-Bearer-Token-Authentifizierung den Abfrageparameter ?key=.
Management
/v1/management/* verwaltet Guthaben, API-Keys und Webhooks mit einem Management-Token. Siehe Management-API.
Antwortformat
Jeder Endpoint behält sein API-Format bei. Die Erfolgs- und Fehlerbeispiele unten verwenden das Chat-Completions-Format.
Erfolgsantwort
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-5.6-terra",
"choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 20,
"total_tokens": 30
}
}Antwort-Header
Verwenden Sie diese Header, wenn sie vorhanden sind.
| Header | Beschreibung |
|---|---|
X-Request-ID | Anfrage-Identifikator für Support und Debugging |
X-Routing-Time-MS | Nicht-Streaming: Gesamtzeit in Millisekunden bis zur Antwort des Upstreams, einschließlich Warteschlange und Inferenz beim Upstream. Streaming: immer 0. Keine Messung von Routing oder Warteschlange. |
X-Task-ID | Öffentlicher asynchroner Aufgaben-Identifikator für aufgabenbasierte Antworten |
X-Billing-Transaction-ID | Abrechnungs-Transaktions-Identifikator nach der endgültigen Abrechnung |
Offizielle Ablehnungen von Anfragen können upstream mit dem vom Dienst gemeldeten Fehler und dem öffentlichen Dienstnamen enthalten. Siehe API-Fehler behandeln.
Fehlerantwort
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}Ratenbegrenzungen (Rate Limits)
Die Limits hängen vom Kontotyp ab und gelten pro API-Key. Eine 429-Antwort enthält Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Siehe Ratenbegrenzungen für die Stufen und wie man Wiederholungsversuche durchführt.
OpenAPI-Spezifikation
OpenAPI Spec
Laden Sie die vollständige OpenAPI 3.1-Spezifikation herunter