Primeros pasos
Inicio rápido
Envía tu primera solicitud a la API de TokenLab con cURL, Python, JavaScript, Go o PHP. Configura tu clave API y el endpoint, y comprueba la respuesta de Chat Completions.
Paso 1: Crea una cuenta y añade fondos
Crear una cuenta
Regístrate en tokenlab.sh con tu correo, Gmail o cuenta de GitHub.
Comprobar el saldo del espacio de trabajo
Revisa el saldo disponible en Facturación. La solicitud se cobra al precio actual del modelo; añade fondos si hace falta.
Crear y guardar una clave API
Abre Claves API en tu espacio de trabajo. Crea una clave y guarda su valor completo de inmediato; solo se muestra una vez. Si ya guardaste una clave completa, utiliza ese valor. El prefijo que aparece o se copia desde la lista no sirve para autenticar solicitudes.
Mantén segura tu clave de API. Nunca la expongas en código del lado del cliente ni en repositorios públicos.
Configurar la clave para esta terminal
Estos comandos no incluyen la clave en el propio comando. Solo se aplica a la terminal actual y sus procesos hijos. Usa un gestor de secretos al desplegar la aplicación.
printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEYPaso 2: Instalar un cliente
pip install openaiPaso 3: Haz tu primera solicitud
Para la mayoría de las nuevas integraciones, empieza con Chat Completions en POST /v1/chat/completions.
curl https://api.tokenlab.sh/v1/chat/completions \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'Guarda un ejemplo SDK como quickstart.py, quickstart.mjs, main.go o quickstart.php y ejecuta python quickstart.py, node quickstart.mjs, go run . o php quickstart.php. Python, JavaScript y Go usan SDK oficiales de OpenAI; PHP usa el cliente comunitario y requiere PHP 8.2+.
Usa POST /v1/responses solo cuando necesites explícitamente un comportamiento específico de Responses. Algunos campos exclusivos de Responses dependen del modelo seleccionado y de la ruta enrutada.
Comprobar el resultado
Una solicitud correcta devuelve una respuesta no vacía. Comprueba modelo, estado y uso en Solicitudes del mismo espacio. Consulta diagnóstico para errores y la guía SDK para cambiar de modelo o usar streaming.