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.

Este skill le enseña a tu agente de programación cómo integrar cientos de APIs de IA de TokenLab simplemente describiendo lo que necesitas. Está empaquetado como un único skill compartido agent-first y funciona con cualquier agente de programación que admita archivos de skills o reglas.La API es Agent-First — incluso si el agente adivina incorrectamente el nombre de un modelo, la respuesta de error le indica exactamente cómo corregirlo.
Esta página documenta una capa reutilizable de empaquetado de skill, no una superficie de compatibilidad de protocolo. Si necesitas configuración de punto de conexión, SDK o cliente, usa las páginas de integración dedicadas para esas herramientas.

​
Cómo Funciona

  1. Describes lo que necesitas — “Quiero usar GPT-4 en mi proyecto de Python”
  2. El agente llama a la API — puede adivinar un nombre de modelo o punto de conexión
  3. Si algo sale mal — la API devuelve pistas estructuradas (did_you_mean, suggestions, retry_after)
  4. El agente se autocorrige — lee las pistas y vuelve a intentarlo con los parámetros correctos
  5. Obtienes código funcional — normalmente en el primer o segundo intento

​
Instalación

Usa el comando de instalación canónico no interactivo:
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 de skills de TokenLab.Si tu herramienta no admite el instalador, copia la carpeta skills/tokenlab-api-integration/ del repositorio en el directorio compartido de skills o reglas de tu herramienta.

​
Verificar la Instalación

Pregúntale a tu agente de programación: 
¿Qué skills están disponibles?
Si ves tokenlab-api-integration, la instalación fue exitosa.

​
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

Ve a Dashboard → API Keys y crea una nueva key
4

Copia la Key

Tu key comienza con sk-... — guárdala de forma segura
No necesitas pegar una API key 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.

​
Ejemplos

​
Chat Completion

Tú dices: 
Quiero usar GPT-4 en mi proyecto de Python
El agente genera: 
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-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
Ejecútalo con: 
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py
Si el agente adivina un nombre de modelo incorrecto (por ejemplo, gpt5), la API devuelve: 
{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.tokenlab.sh/v1/models to list all available models."
  }
}
El agente lee did_you_mean, corrige el nombre del modelo y vuelve a intentarlo — todo automáticamente.

​
Generación de Imágenes

Tú dices: 
Generate images with Flux in Node.js
El agente llama a la API de imágenes, maneja los errores y genera código completo con lógica de descarga y guardado.

​
Reconocimiento de Voz

Tú dices: 
Integrate speech-to-text in my app
El agente genera código con el punto de conexión correcto /v1/audio/transcriptions y manejo de archivos de audio.

​
Recuperación de Errores Agent-First

Cada respuesta de error incluye pistas estructuradas que cualquier agente de programación puede analizar. Consulta la referencia completa de la API Agent-First para obtener más detalles.
ErrorLo que devuelve la APILo que hace el agente
Nombre de modelo incorrectodid_you_mean + suggestionsCorrige automáticamente y reintenta
Saldo insuficientebalance_usd + suggestions más económicasCambia a un modelo asequible
Modelo no disponiblealternatives + retry_afterCambia a un modelo disponible
Límite de tasa alcanzadoretry_after (segundos exactos)Espera y reintenta
Contexto demasiado largosuggestions con modelos más grandesCambia a un modelo con mayor contexto
Incompatibilidad de contrato en solicitud no chatsupported_operations, supported_parameters, request_endpoint, recommended_requestReconstruye la solicitud desde el contrato público del modelo

​
Optimización de Endpoint Nativo

Cuando llamas a /v1/chat/completions con un modelo Claude o Gemini, la API devuelve headers de optimización: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
Trata estos headers como sugerencias de ruta, no como un cambio automático obligatorio. Las llamadas nativas de Claude usan /v1/messages; las llamadas nativas de Gemini deben seguir el endpoint anunciado por X-LemonData-Native-Endpoint, normalmente /v1beta/gemini.

​
Descubrimiento de Modelos

No necesitas buscar en la documentación: 
# Resumen de API legible por máquina
curl https://api.tokenlab.sh/llms.txt

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

# Lista recomendada para escenarios 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=translation" -H "Authorization: Bearer sk-KEY"

# Lee el contrato público de un modelo antes de reintentar una solicitud no chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer sk-KEY"

# Filtrar por capacidad
curl "https://api.tokenlab.sh/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
Capacidades Compatibles

TipoEjemplos
ChatGPT-5.4, Claude, Gemini, DeepSeek
Generación de ImágenesGPT Image, Flux, Stable Diffusion, modelos de imagen Gemini
Generación de VideoSora, Kling, Veo, Seedance
Generación de MúsicaSuno
Modelos 3DTripo3D
AudioTexto a voz, Voz a texto
Incrustacionestext-embedding-3
Reordenarbce-reranker, qwen3-rerank

​
Mejores Prácticas

Seguridad de la API Key

Usa variables de entorno. Nunca subas keys a git ni las expongas en código frontend.

Gestión de Costos

Establece límites de uso en tu dashboard. Revisa error.balance_usd para monitorear los costos de forma programática.

Sé Directo

Di “Quiero generar imágenes en Python” en lugar de “¿TokenLab tiene una API de imágenes?”

Describe tu Escenario

“Estoy creando un chatbot con GPT-4” le da al agente más contexto que “Usa GPT-4”.

​
FAQ

Intenta mencionar “TokenLab” o “TokenLab API” en tu solicitud:
Quiero integrar GPT-4 en mi proyecto con TokenLab
La API Agent-First de TokenLab devuelve pistas de error estructuradas. Si el agente adivina un nombre de modelo incorrecto, el error incluye did_you_mean con el nombre correcto y suggestions con alternativas. El agente las lee y se autocorrige en el siguiente intento.
Cualquier agente de programación que admita directorios compartidos de skills o reglas. Cuando el instalador es compatible, npx skills add coloca automáticamente el skill compartido tokenlab-api-integration en la ubicación detectada.
Vuelve a ejecutar el instalador:
npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

​
Recursos

API Agent-First

Referencia completa de las pistas de error estructuradas

Documentación de la API

Referencia completa de la API

Modelos

Explora cientos de modelos disponibles

llms.txt

Resumen legible por máquina de la API para agentes de IA
¿Tienes preguntas? Consulta nuestros GitHub Issues o contacta a support@tokenlab.sh