Kernleitfäden
Migrationsleitfäden
Migrieren Sie bestehende OpenAI-, Anthropic-, Gemini- und Medien-Clients zu TokenLab
Behalten Sie das Anforderungsformat bei, das Ihre Anwendung bereits verwendet. OpenAI-kompatible Clients, Anthropic Messages, Gemini REST und Medien-Endpunkte haben jeweils eine entsprechende TokenLab API-Adresse.
API-Mapping
| Bestehende API | TokenLab Basis-URL | Endpunkt | Zu beachten |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | Geringster Änderungsaufwand für OpenAI-kompatiblen Chat und Function Calling |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | Verwenden, wenn Ihre App von Responses-spezifischen Eingaben, Tools oder der Output-Verarbeitung abhängt |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | Hängen Sie /v1 nicht an die SDK-Basis-URL an |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Behalten Sie Gemini-native Felder auf der Gemini-Route bei |
| Mediengenerierung | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | Entdecken Sie Modelle mit recommended_for und erwarten Sie asynchrones Polling, wo dokumentiert |
| Verwaltung und Abrechnung | https://api.tokenlab.sh/v1 | /management/... | Server-seitige Aufrufe verwenden ein Management-Token, keinen Modell-API-Key |
Schnelle Migrationsrezepte
OpenAI zu TokenLab
Ändern Sie die SDK base_url / baseURL zu https://api.tokenlab.sh/v1, ersetzen Sie den API-Key und wählen Sie eine Modell-ID aus GET /v1/models.
OpenRouter zu TokenLab
Ersetzen Sie die OpenRouter Basis-URL durch https://api.tokenlab.sh/v1. TokenLab Modell-IDs enthalten kein OpenRouter-Provider-Präfix. Verwenden Sie Anthropic Messages oder Gemini nur, wenn Ihre Anwendung Felder aus diesen Formaten benötigt.
LiteLLM zu TokenLab
Verwenden Sie die custom_openai/<model>-Konfiguration von LiteLLM mit api_base: https://api.tokenlab.sh/v1. Halten Sie Ihren LiteLLM-Alias getrennt von der TokenLab Modell-ID, damit beide geändert werden können, ohne Anwendungsprompts bearbeiten zu müssen.
Claude Messages via TokenLab
Richten Sie Anthropic SDK-Clients auf https://api.tokenlab.sh und rufen Sie messages.create auf. Hängen Sie /v1 nicht an die SDK-Basis-URL an; das SDK verwaltet den Pfad /v1/messages selbst.
Gemini Native via TokenLab
Behalten Sie Gemini-Payloads auf https://api.tokenlab.sh/v1beta/models/{model}:generateContent bei. Gemini-native contents, parts, Dateien, gecachte Inhalte, Funktionsdeklarationen und integrierte Tools sollten auf dieser Route bleiben, wenn Ihre App von Gemini-Verhalten abhängt.
OpenAI-kompatible Migration
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)Ihr bestehender Code für Retries, Timeouts und Streaming kann in der Regel beibehalten werden. Bestätigen Sie die Modell-ID mit GET /v1/models. Bildanfragen müssen explizit ein Modell enthalten; siehe den Bild-Leitfaden für modellspezifische Eingaben.
Anthropic Migration
from anthropic import Anthropic
client = Anthropic(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)Verwenden Sie /v1/messages für Claude-Tool-Aufrufe, Thinking-Blöcke und Anthropic-Nachrichtenfelder. Chat Completions garantiert diese Felder nicht.
Gemini Migration
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'Behalten Sie Gemini-integrierte Tools, File API-Referenzen, gecachte Inhalte, Funktionsdeklarationen und native Inhalts-Parts auf /v1beta bei, wenn Ihre App von Gemini-nativem Verhalten abhängt.
Medien-Migration
- Fragen Sie
GET /v1/models?recommended_for=image|video|music|3dab. - Lesen Sie die Modellliste aus
GET /v1/modelsund die vollständigen Details ausGET /v1/models/{model}. - Senden Sie explizit ein
model, insbesondere bei Bild-Endpunkten. - Speichern Sie
task_id,poll_url, Endpunkt, Modell und Ihre eigene Job-ID für asynchrone Jobs. Pollen Sie diese mitGET /v1/tasks/{id}. - Gleichen Sie Kosten über Nutzungsdatensätze und
billing_transaction_idab, nicht über Provider-Task-IDs.
Die Mediengenerierung kann asynchron abgeschlossen werden, speichern Sie daher task_id und poll_url, bevor Sie eine bestehende Integration ersetzen. Ein Timeout bei einer Erstellungsanfrage darf keinen zweiten Benutzer-Job erzeugen.
Migrations-Fallstricke
- Legen Sie nicht jedes Modell hinter einen OpenAI Chat Completions-Pfad, wenn Ihre App natives Anthropic-, Gemini- oder Responses-Verhalten benötigt.
- Gehen Sie nicht von alten Bild-Standardwerten aus. Senden Sie
modelexplizit. - Wiederholen Sie keine asynchronen Erstellungsanfragen, ohne zu prüfen, ob bereits ein Task erstellt wurde.
- Verwenden Sie TokenLab-Task-IDs und Nutzungsdatensätze in Ihrem Produkt. Task-IDs von Drittanbietern sind keine Abrechnungsidentifikatoren.
API-Referenz
| Thema | Referenz |
|---|---|
| Multi-Format API | Multi-Format API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| Bildgenerierung | Bildgenerierung |
| Asynchrone Jobs & Polling | Asynchrone Jobs & Polling |