Base
Referencia de la API
Endpoints, autenticación, encabezados de respuesta y errores
Descripción general
TokenLab admite endpoints compatibles con OpenAI, además de los formatos de solicitud de Anthropic y Gemini. Los clientes de OpenAI existentes pueden usar /v1; elija otro formato solo cuando su aplicación necesite un comportamiento específico de esa API. POST /v1/responses es opcional y depende de la compatibilidad del modelo.
URL base
https://api.tokenlab.shAutenticación
Las solicitudes de modelos utilizan una clave de API de TokenLab. El encabezado de autenticación estándar es:
Authorization: Bearer sk-your-api-keyGET /v1/models, GET /v1/models/{model}, GET /v1/models/{model}/pricing y GET /v1/pricing son públicos y no necesitan una clave. Los mensajes de Anthropic también aceptan x-api-key; Gemini acepta x-goog-api-key o ?key=, además de la autenticación Bearer. /v1/management/* requiere un token de gestión (mt-...).
Obtenga su clave de API desde la Consola.
Política de entrega
Las solicitudes de generación aceptan X-TokenLab-Delivery-Policy: auto | verified | official. Un encabezado de solicitud anula la configuración de la clave de API, la cual a su vez anula el valor predeterminado del Workspace.
Autoutiliza TokenLab Verified cuando está disponible, y luego Official si es necesario. Usted paga por la opción que completa su solicitud.TokenLab Verifiedes una entrega verificada por TokenLab. Se aplica el precio de Verified.Officialfactura al precio Official, que es el precio publicado por el creador del modelo.- Las sesiones en tiempo real utilizan la clave de API o la configuración del Workspace y no aceptan una anulación en la solicitud.
Un encabezado no válido devuelve 400. Si la opción solicitada no está disponible, TokenLab devuelve 503 delivery_tier_unavailable y un ID de solicitud. Lea retryable: cuando la operación seleccionada no tiene disponibilidad, es false. No repita la misma solicitud sin cambios.
Las páginas de la API con un formulario de solicitud aceptan su clave de API de TokenLab y envían solicitudes reales. Estas solicitudes utilizan el saldo y los límites de su cuenta. También puede usar cURL, Postman o un SDK.
Endpoints admitidos
Chat y generación de texto
| Endpoint | Método | Descripción |
|---|---|---|
/v1/chat/completions | POST | Completado de chat compatible con OpenAI |
/v1/messages | POST | Mensajes compatibles con Anthropic |
/v1/messages/count_tokens | POST | Contar los tokens de entrada de una solicitud de Mensajes |
/v1/messages/batches | POST, GET | Crear y listar lotes de mensajes |
/v1/messages/batches/{message_batch_id} | GET, DELETE | Recuperar o eliminar un lote de mensajes |
/v1/messages/batches/{message_batch_id}/results | GET | Leer los resultados |
/v1/messages/batches/{message_batch_id}/cancel | POST | Cancelar un lote de mensajes |
/v1/responses | POST | API de respuestas de OpenAI |
/v1/responses/{id} | GET, DELETE | Recuperar o eliminar una respuesta almacenada |
/v1/responses/compact | POST | Compactar el contexto de una conversación de respuestas |
/v1/translations | POST | Traducción de texto a texto |
Embeddings y Rerank
| Endpoint | Método | Descripción |
|---|---|---|
/v1/embeddings | POST | Crear embeddings de texto |
/v1/multimodal/embeddings | POST | Crear embeddings con un modelo de embedding multimodal |
/v1/rerank | POST | Reclasificar (rerank) documentos |
Decisiones
| Endpoint | Método | Descripción |
|---|---|---|
/v1/systemone | POST | Evaluar preguntas de decisión tipadas |
Archivos y lotes
| Endpoint | Método | Descripción |
|---|---|---|
/v1/files | POST, GET | Subir y listar archivos |
/v1/files/{file_id} | GET, DELETE | Recuperar o eliminar un archivo |
/v1/files/{file_id}/content | GET | Descargar el contenido de un archivo |
/v1/batches | POST, GET | Crear y listar lotes |
/v1/batches/{batch_id} | GET | Recuperar un lote |
/v1/batches/{batch_id}/cancel | POST | Cancelar un lote |
Imágenes
| Endpoint | Método | Descripción |
|---|---|---|
/v1/images/generations | POST | Generar imágenes a partir de texto |
/v1/images/edits | POST | Editar imágenes |
/v1/images/variations | POST | Crear variaciones de imágenes |
/v1/images/generations/{id} | GET | Ruta de estado de compatibilidad para respuestas de imágenes basadas en tareas |
Los modelos de imagen pueden devolver una imagen terminada o una tarea asíncrona. Si la respuesta incluye status: "pending" o un ID de tarea, consulte GET /v1/tasks/{id}.
Audio
| Endpoint | Método | Descripción |
|---|---|---|
/v1/audio/speech | POST | Texto a voz (TTS) |
/v1/audio/transcriptions | POST | Voz a texto (STT) |
/v1/audio/translations | POST | Traducir voz a texto en inglés |
Tiempo real
| Endpoint | Método | Descripción |
|---|---|---|
/v1/realtime?model={model} | WS | Sesiones WebSocket en tiempo real |
Utilice /v1/realtime para actualizaciones de WebSocket. Un GET /v1/realtime simple devuelve metadatos del endpoint. Esta no es la superficie REST de OpenAI Realtime; los secretos de cliente, las llamadas (Calls) y los endpoints de sesión beta heredados no están disponibles.
Video
| Endpoint | Método | Descripción |
|---|---|---|
/v1/videos/generations | POST | Crear tarea de generación de video |
/v1/videos/generations/{id} | GET | Ruta de estado de compatibilidad |
/v1/videos/assets | POST, GET | Crear y listar activos de material de Seedance |
/api/v3/contents/generations/tasks | POST, GET | Tareas de Seedance con el formato de solicitud de Volcengine |
Consulte GET /v1/tasks/{id} con el id de la tarea. /v1/videos/generations/{id} sigue estando disponible para integraciones existentes.
Tareas asíncronas
| Endpoint | Método | Descripción |
|---|---|---|
/v1/tasks/{id} | GET | Estado de cualquier tarea asíncrona |
/v1/tasks/{id} | DELETE | Cancelar una tarea asíncrona |
Consulte GET /v1/tasks/{id} para cada tarea asíncrona: imágenes, video, música, 3D, Worlds y transcripción de audio asíncrona. Utilice el id o task_id de la respuesta de creación. Una respuesta de creación de Worlds devuelve una poll_url bajo /v1/worlds/generations/{id}; consulte /v1/tasks/{id} allí también. Las rutas de estado por modalidad en esta página son endpoints de compatibilidad para integraciones existentes.
Música
| Endpoint | Método | Descripción |
|---|---|---|
/v1/music/generations | POST | Crear tarea de generación de música |
/v1/music/generations/{id} | GET | Ruta de estado de compatibilidad |
Generación 3D
| Endpoint | Método | Descripción |
|---|---|---|
/v1/3d/generations | POST | Crear tarea de generación de modelo 3D |
/v1/3d/generations/{id} | GET | Ruta de estado de compatibilidad |
Worlds
| Endpoint | Método | Descripción |
|---|---|---|
/v1/worlds/generations | POST | Crear una tarea de generación de mundo |
/v1/worlds/list | POST | Listar mundos |
/v1/worlds/{id} | GET, DELETE | Recuperar o eliminar un mundo |
/v1/worlds/media-assets/prepare-upload | POST | Preparar una subida de activo multimedia |
Modelos y precios
| Endpoint | Método | Descripción |
|---|---|---|
/v1/models | GET | Listar todos los modelos disponibles |
/v1/models/{model} | GET | Obtener información de un modelo específico |
/v1/models/{model}/pricing | GET | Obtener los precios de un modelo |
/v1/pricing | GET | Listar precios de modelos |
Gemini (v1beta)
Soporte nativo para el formato de API de Google Gemini:
| Endpoint | Método | Descripción |
|---|---|---|
/v1beta/models | GET | Listar modelos que aceptan solicitudes de Gemini |
/v1beta/models/{model} | GET | Obtener un modelo |
/v1beta/models/{model}:generateContent | POST | Generar contenido |
/v1beta/models/{model}:streamGenerateContent | POST | Generar contenido en streaming |
/v1beta/models/{model}:countTokens | POST | Contar tokens |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | Archivos y contenido en caché de Gemini |
Los endpoints de Gemini admiten la autenticación mediante el parámetro de consulta ?key= además del token Bearer estándar.
Gestión
/v1/management/* gestiona el saldo, las claves de API y los webhooks con un token de gestión. Consulte la API de gestión.
Formato de respuesta
Cada endpoint conserva su formato de API. Los ejemplos de éxito y error a continuación utilizan el formato de Chat Completions.
Respuesta de éxito
{
"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
}
}Encabezados de respuesta
Utilice estos encabezados cuando estén presentes.
| Encabezado | Descripción |
|---|---|
X-Request-ID | Identificador de solicitud para soporte y depuración |
X-Routing-Time-MS | Sin streaming: tiempo total en milisegundos hasta que llega la respuesta del upstream, incluida su cola e inferencia. Streaming: siempre 0. No es una medición de enrutamiento ni de cola. |
X-Task-ID | Identificador público de tarea asíncrona para respuestas basadas en tareas |
X-Billing-Transaction-ID | Identificador de transacción de facturación después de la facturación final |
Los rechazos de solicitudes oficiales pueden incluir upstream con el error reportado por el servicio y el nombre público del servicio. Consulte Manejo de errores de API.
Respuesta de error
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}Límites de tasa
Los límites dependen del nivel de la cuenta y se aplican por clave de API. Una respuesta 429 incluye Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Consulte Límites de tasa para conocer los niveles y cómo reintentar.
Especificación OpenAPI
Especificación OpenAPI
Descargue la especificación completa de OpenAPI 3.1