Saltar al contenido principal
Esta página documenta el skill compartido mantenido tokenlab-api-integration. La distribución canónica vive en hedging8563/tokenlab-skills, donde el repositorio público conserva intencionalmente solo este skill.
Usa esta página para instalar el skill y guiar el flujo del agent. Para configuración por endpoint, usa la página dedicada de SDK, cliente o referencia API.

​
Qué hace el skill

  • Genera ejemplos mínimos ejecutables para chat, imagen, audio, video, traducción y otras familias de API de TokenLab.
  • Usa https://api.tokenlab.sh/v1 para clientes compatibles con OpenAI y explica cuándo cambiar a rutas nativas de Anthropic o Gemini.
  • Descubre modelos con /v1/models, /llms.txt y listas recommended_for en lugar de adivinar desde listas obsoletas.
  • Lee los detalhes do modelo de un modelo antes de reintentar solicitudes no-chat para no eliminar silenciosamente campos no compatibles.
  • Gestiona pistas de error Agent-First como did_you_mean, suggestions, retry_after y recommended_request.

​
Instalación

Usa el comando canónico de instalación no interactiva:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y
Esto instala el skill compartido tokenlab-api-integration desde el repositorio TokenLab skills.Si tu herramienta no soporta el installer, copia skills/tokenlab-api-integration/ del repositorio al directorio compartido de skills o rules de tu herramienta.

​
Actualizar instalaciones existentes

Si instalaste el skill anteriormente, vuelve a ejecutar el mismo comando para actualizar al paquete público actual.

​
Verificar instalación

Pregunta a tu coding agent: 
¿Qué skills están disponibles?
Si ves tokenlab-api-integration, la instalación fue correcta.

​
Obtén tu API Key

1

Visita TokenLab

Ve a tokenlab.sh
2

Inicia sesión

Crea una cuenta o inicia sesión
3

Obtén la API Key

Abre Dashboard → API Keys y crea una nueva key
4

Copia la key

Tu key empieza por sk-.... Guárdala de forma segura.
No pegues API keys en prompts ni archivos fuente. El skill debe preguntar qué variable de entorno usar y generar código que lea la key desde esa variable.

​
Flujo recomendado para Agent

  1. Empieza con el ejemplo funcional más pequeño que coincida con el lenguaje y la familia de API solicitados.
  2. Si la elección de modelo está abierta, llama a /v1/models o https://api.tokenlab.sh/llms.txt antes de fijar un modelo.
  3. Para trabajo no-chat, llama a /v1/models?recommended_for=<scene> donde <scene> es image, video, music, 3d, tts, stt, embedding, rerank o translation.
  4. Antes de cambiar una solicitud no-chat fallida, lee /v1/models/:model y alinea supported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode y recommended_request.
  5. Si la API devuelve un error Agent-First, usa los campos estructurados para corregir la solicitud y reintenta solo si el error es retryable.

​
Ejemplo mínimo de chat

Este ejemplo usa el SDK Python de OpenAI con la base URL de TokenLab: 
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["TOKENLAB_API_KEY"],
    base_url="https://api.tokenlab.sh/v1"
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
Ejecútalo con: 
pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py

​
Descubrimiento de modelos y contratos

Prefiere descubrimiento en vivo antes que listas empaquetadas obsoletas: 
# Resumen API legible por máquina
curl https://api.tokenlab.sh/llms.txt

# Listar modelos
curl "https://api.tokenlab.sh/v1/models" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Listas cortas clasificadas para no-chat
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-KEY"

# Leer los detalhes do modelo de un modelo antes de reintentar solicitudes no-chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Detalle solo de precios
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer sk-KEY"

​
Pistas de enrutamiento nativo

La ruta compatible con OpenAI /v1 es la opción predeterminada para ejemplos comunes de chat, Responses, imagen, embedding, audio y rerank. Usa rutas nativas de Anthropic o Gemini solo cuando la solicitud necesite comportamiento específico del proveedor o TokenLab devuelva X-TokenLab-Native-Endpoint como pista de optimización. 
X-TokenLab-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-TokenLab-Native-Endpoint: /v1/messages

​
Recuperación de errores Agent-First

Los errores incluyen campos que los coding agents pueden analizar sin extraer la documentación:
ErrorCampos útilesAcción del agent
Nombre de modelo incorrectodid_you_mean, suggestions, hintReintenta con el modelo corregido o una alternativa sugerida
Saldo insuficientebalance_usd, estimated_cost_usd, suggestionsPide aprobación o cambia a un modelo asequible
Límite de tasa o indisponibilidad temporalretryable, retry_after, alternativesEspera, reintenta o elige una alternativa listada
Contrato no-chat incompatiblesupported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode, recommended_requestReconstruye la solicitud desde los detalhes do modelo y return a clear error en campos que cambien la intención

​
Familias de API compatibles

FamiliaRuta principal
Chat y Responses/v1/chat/completions, /v1/responses
Mensajes nativos Claude/v1/messages
Solicitudes nativas Gemini/v1beta/models/{model}:generateContent
Imágenes/v1/images/generations, /v1/images/edits
Video/v1/videos/generations
Música/v1/music/generations
Worlds/v1/worlds/generations más endpoints de estado world y media asset
3D/v1/3d/generations
Audio/v1/audio/speech, /v1/audio/transcriptions, /v1/audio/translations
Realtime/v1/realtime?model={model}
Embeddings y rerank/v1/embeddings, /v1/rerank
Traducción de texto/v1/translations

​
Buenas prácticas

Seguridad de API Key

Usa variables de entorno y llamadas del lado servidor. Nunca expongas keys en código frontend.

Contrato primero para no-chat

Lee /v1/models?recommended_for=... y /v1/models/:model antes de reintentar solicitudes de imagen, video, música, 3D, traducción, audio, embedding o rerank.

Ejemplo ejecutable mínimo

Genera una llamada funcional antes de añadir abstracciones, colas o flujos de UI.

Usa pistas estructuradas

Analiza did_you_mean, retry_after, alternatives y recommended_request antes de cambiar el código.

​
FAQ

Menciona “TokenLab” o “TokenLab API” en la solicitud, por ejemplo: Usa TokenLab para agregar generación de imágenes a mi app Node.js.
Cualquier coding agent que soporte directorios compartidos de skill o rules puede usar la carpeta. El installer skills gestiona automáticamente los agents compatibles.
Vuelve a ejecutar el comando de instalación. Actualiza la copia local desde el repositorio público canónico.
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

​
Recursos

Agent-First API

Pistas estructuradas de error y comportamiento de recuperación

Documentación API

Configuración por endpoint y API Reference

Modelos

Explora modelos disponibles

llms.txt

Resumen API legible por máquina para agents
¿Preguntas? Usa GitHub Issues o contacta a support@tokenlab.sh.