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 APITokenLab Basis-URLEndpunktZu beachten
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsGeringster Änderungsaufwand für OpenAI-kompatiblen Chat und Function Calling
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesVerwenden, wenn Ihre App von Responses-spezifischen Eingaben, Tools oder der Output-Verarbeitung abhängt
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesHängen Sie /v1 nicht an die SDK-Basis-URL an
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentBehalten Sie Gemini-native Felder auf der Gemini-Route bei
Mediengenerierunghttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsEntdecken Sie Modelle mit recommended_for und erwarten Sie asynchrones Polling, wo dokumentiert
Verwaltung und Abrechnunghttps://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

  1. Fragen Sie GET /v1/models?recommended_for=image|video|music|3d ab.
  2. Lesen Sie die Modellliste aus GET /v1/models und die vollständigen Details aus GET /v1/models/{model}.
  3. Senden Sie explizit ein model, insbesondere bei Bild-Endpunkten.
  4. Speichern Sie task_id, poll_url, Endpunkt, Modell und Ihre eigene Job-ID für asynchrone Jobs. Pollen Sie diese mit GET /v1/tasks/{id}.
  5. Gleichen Sie Kosten über Nutzungsdatensätze und billing_transaction_id ab, 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 model explizit.
  • 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

ThemaReferenz
Multi-Format APIMulti-Format API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
BildgenerierungBildgenerierung
Asynchrone Jobs & PollingAsynchrone Jobs & Polling

Auf dieser Seite