Guías principales
Guías de migración
Traslade sus clientes existentes de OpenAI, Anthropic, Gemini y multimedia a TokenLab
Mantenga el formato de solicitud que ya utiliza su aplicación. Los clientes compatibles con OpenAI, Anthropic Messages, Gemini REST y los endpoints de multimedia tienen cada uno una dirección de API de TokenLab correspondiente.
Mapeo de API
| API existente | URL base de TokenLab | Endpoint | A tener en cuenta |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | El cambio más sencillo para chat y llamadas a funciones compatibles con OpenAI |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | Úselo cuando su aplicación dependa de entradas, herramientas o manejo de salidas específicos de Responses |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | No añada /v1 a la URL base del SDK |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Mantenga los campos nativos de Gemini en la ruta de Gemini |
| Generación de multimedia | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | Descubra modelos con recommended_for y espere sondeo asíncrono donde esté documentado |
| Gestión y facturación | https://api.tokenlab.sh/v1 | /management/... | Las llamadas del lado del servidor usan un token de gestión, no una clave de API de modelo |
Recetas de migración rápida
De OpenAI a TokenLab
Cambie la base_url / baseURL del SDK a https://api.tokenlab.sh/v1, reemplace la clave de API y elija un ID de modelo desde GET /v1/models.
De OpenRouter a TokenLab
Reemplace la URL base de OpenRouter con https://api.tokenlab.sh/v1. Los IDs de modelo de TokenLab no incluyen un prefijo de proveedor de OpenRouter. Utilice Anthropic Messages o Gemini solo cuando su aplicación necesite campos de esos formatos.
De LiteLLM a TokenLab
Utilice la configuración custom_openai/<model> de LiteLLM con api_base: https://api.tokenlab.sh/v1. Mantenga su alias de LiteLLM separado del ID de modelo de TokenLab para que cualquiera de los dos pueda cambiar sin editar los prompts de la aplicación.
Claude Messages a través de TokenLab
Apunte los clientes del SDK de Anthropic a https://api.tokenlab.sh y llame a messages.create. No añada /v1 a la URL base del SDK; el SDK posee la ruta /v1/messages.
Gemini Native a través de TokenLab
Mantenga los payloads de Gemini en https://api.tokenlab.sh/v1beta/models/{model}:generateContent. Los contents, parts, archivos, contenidos cacheados, declaraciones de funciones y herramientas integradas nativos de Gemini deben permanecer en esta ruta cuando su aplicación dependa del comportamiento de Gemini.
Migración compatible con OpenAI
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"}],
)Su código existente de reintentos, tiempos de espera y streaming generalmente puede permanecer igual. Confirme el ID del modelo con GET /v1/models. Las solicitudes de imágenes deben incluir un modelo explícitamente; consulte la guía de imágenes para conocer las entradas específicas del modelo.
Migración de Anthropic
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."}],
)Utilice /v1/messages para llamadas a herramientas de Claude, bloques de pensamiento y campos de mensajes de Anthropic. Chat Completions no garantiza esos campos.
Migración de Gemini
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"}]}]}'Mantenga las herramientas integradas de Gemini, las referencias a File API, los contenidos cacheados, las declaraciones de funciones y las partes de contenido nativas en /v1beta cuando su aplicación dependa del comportamiento nativo de Gemini.
Migración de multimedia
- Consulte
GET /v1/models?recommended_for=image|video|music|3d. - Lea la lista de modelos desde
GET /v1/modelsy los detalles completos desdeGET /v1/models/{model}. - Envíe un
modelexplícito, especialmente para los endpoints de imágenes. - Almacene
task_id,poll_url, endpoint, modelo y su propio ID de trabajo para trabajos asíncronos. Sondee los mismos conGET /v1/tasks/{id}. - Concilie los costos a través de registros de uso y
billing_transaction_id, no mediante IDs de tarea del proveedor.
La generación de multimedia puede finalizar de forma asíncrona, así que guarde el task_id y la poll_url antes de reemplazar una integración existente. Un tiempo de espera en la solicitud de creación no debe producir un segundo trabajo de usuario.
Errores comunes de migración
- No coloque todos los modelos detrás de una única ruta de OpenAI Chat Completions si su aplicación necesita el comportamiento nativo de Anthropic, Gemini o Responses.
- No asuma valores predeterminados antiguos para imágenes. Envíe el
modelexplícitamente. - No reintente solicitudes de creación asíncronas sin verificar si una tarea ya fue creada.
- Utilice los IDs de tarea y registros de uso de TokenLab en su producto. Los IDs de tarea de terceros no son identificadores de facturación.
Referencia de API
| Tema | Referencia |
|---|---|
| API multiformato | API multiformato |
| SDK de OpenAI | SDK de OpenAI |
| SDK de Anthropic | SDK de Anthropic |
| Gemini Native | Gemini Native API |
| Generación de imágenes | Generación de imágenes |
| Trabajos asíncronos y sondeo | Trabajos asíncronos y sondeo |