Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Visión general

TokenLab es nativo primero y compatible con OpenAI. Usa rutas nativas del proveedor como POST /v1/messages para Anthropic y /v1beta/models/…:generateContent para Gemini cuando necesites comportamiento nativo, y endpoints /v1 compatibles con OpenAI cuando migres SDKs o herramientas de estilo OpenAI. POST /v1/responses sigue siendo una ruta avanzada opcional para comportamiento específico de Responses.

​
URL base

https://api.tokenlab.sh

​
Autenticación

Todos los endpoints de la API requieren autenticación mediante un token Bearer: 
Authorization: Bearer sk-your-api-key
Obtén tu clave API en el Panel de control.
Acerca del Playground interactivo: el playground en este sitio de documentación es solo para fines de demostración y no admite ingresar claves API. Para probar la API, por favor utiliza:
  • cURL - Copia los comandos de ejemplo y reemplaza sk-your-api-key con tu clave real
  • Postman - Importa nuestra OpenAPI spec
  • SDK - Usa el SDK de OpenAI/Anthropic con nuestra URL base

​
Endpoints compatibles

​
Chat y generación de texto

Punto de accesoMétodoDescripción
/v1/chat/completionsPOSTChat completions compatibles con OpenAI
/v1/messagesPOSTAPI de mensajes compatible con Anthropic
/v1/responsesPOSTAPI de respuestas de OpenAI

​
Embeddings y rerank

Punto de accesoMétodoDescripción
/v1/embeddingsPOSTCrear embeddings de texto
/v1/rerankPOSTReordenar documentos

​
Imágenes

Punto de accesoMétodoDescripción
/v1/images/generationsPOSTGenerar imágenes a partir de texto
/v1/images/editsPOSTEditar imágenes
/v1/images/generations/{id}GETRuta de estado de tarea para respuestas de imagen basadas en tareas
Algunos modelos de imagen pueden devolver resultados inline, otros pueden devolver respuestas basadas en tareas, y algunos pueden comportarse de ambas formas dependiendo de la ruta del proveedor. Si la respuesta de creación incluye poll_url, síguela exactamente.

​
Audio

Punto de accesoMétodoDescripción
/v1/audio/speechPOSTTexto a voz (TTS)
/v1/audio/transcriptionsPOSTVoz a texto (STT)

​
Video

Punto de accesoMétodoDescripción
/v1/videos/generationsPOSTCrear tarea de generación de video
/v1/tasks/{id}GETObtener estado de tarea asincrónica para trabajos de video
/v1/videos/generations/{id}GETRuta de estado de tarea de video compatible con versiones anteriores
Para clientes nuevos, prefiera /v1/tasks/{id} y siga el poll_url devuelto por las respuestas de creación. Mantenga /v1/videos/generations/{id} solo por compatibilidad con versiones anteriores.

​
Tareas asincrónicas

Punto de accesoMétodoDescripción
/v1/tasks/{id}GETEndpoint unificado de estado de tareas asincrónicas. Recomendado cuando se sigue un poll_url devuelto
Este endpoint no está limitado a video, música y 3D. Algunas tareas de imagen también pueden usar /v1/tasks/{id} como la ruta canónica de polling.

​
Música

Punto de accesoMétodoDescripción
/v1/music/generationsPOSTCrear tarea de generación de música
/v1/music/generations/{id}GETRuta de estado específica para música
Para clientes nuevos, prefiera primero el poll_url devuelto. Si necesitas un endpoint fijo de estado de tarea, usa /v1/tasks/{id}; mantén /v1/music/generations/{id} para rutas de compatibilidad específicas de música.

​
Generación 3D

Punto de accesoMétodoDescripción
/v1/3d/generationsPOSTCrear tarea de generación de modelo 3D
/v1/3d/generations/{id}GETRuta de estado específica para 3D
Para clientes nuevos, prefiera primero el poll_url devuelto. Si necesitas un endpoint fijo de estado de tarea, usa /v1/tasks/{id}; mantén /v1/3d/generations/{id} para rutas de compatibilidad específicas de 3D.

​
Modelos

Punto de accesoMétodoDescripción
/v1/modelsGETListar todos los modelos disponibles
/v1/models/{model}GETObtener información de un modelo específico

​
Gemini (v1beta)

Soporte nativo para el formato de la API Google Gemini:
Punto de accesoMétodoDescripción
/v1beta/models/{model}:generateContentPOSTGenerar contenido (formato Gemini)
/v1beta/models/{model}:streamGenerateContentPOSTGenerar contenido en streaming (formato Gemini)
Los endpoints de Gemini admiten la autenticación mediante el parámetro de consulta ?key= además del token Bearer estándar.

​
Formato de respuesta

Todas las respuestas siguen un formato consistente:

​
Respuesta exitosa

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

​
Transparencia de enrutamiento

Todas las respuestas incluyen un campo _routing con información del canal: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
CampoDescripción
channel.idIdentificador del canal utilizado
channel.providerProveedor upstream (openai, anthropic, etc.)
channel.channelTypePLATFORM (TokenLab) o PRIVATE (BYOK)
cachedSi la respuesta fue servida desde caché
retryCountNúmero de intentos de reintento (si los hubo)

​
Respuesta de error

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

​
Límites de tasa

Los límites de tasa son basados en roles y configurables por los administradores. Valores predeterminados:
RolSolicitudes/min
User60
Partner300
VIP1,000
Contacta con el soporte para límites de tasa personalizados. Los valores exactos pueden variar según la configuración de la cuenta.
Cuando se exceden los límites de tasa, la API devuelve un código de estado 429 con un encabezado Retry-After que indica cuánto tiempo esperar.

​
Especificación OpenAPI

Especificación OpenAPI

Descarga la especificación completa OpenAPI 3.0