Primeros pasos

Inicio rápido

Realice su primera solicitud a la API de TokenLab con cURL, Python, JavaScript, Go o PHP. Configure su clave de API, ajuste el endpoint y verifique una respuesta de Chat Completions.

Obtener una clave de API

Crear una cuenta

Regístrese en tokenlab.sh usando su correo electrónico, cuenta de Google o GitHub.

Crear y guardar una clave de API

Abra API Keys en su espacio de trabajo. Cree una clave y guarde el valor completo inmediatamente; solo se muestra una vez. Si ya guardó una clave completa, utilice ese valor. El prefijo que se muestra o se copia de la lista no puede autenticar solicitudes.

Verificar el saldo del espacio de trabajo

Verifique su saldo en Billing. Una cuenta nueva puede recibir un crédito de prueba único; de lo contrario, comienza en $0 y requiere una recarga (mínimo $5) antes de la primera solicitud. La solicitud se factura al precio actual del modelo seleccionado.

Mantenga la clave de API en secreto. No la incluya en código del lado del cliente ni en un repositorio público.

Configurar la clave para esta terminal

Los comandos a continuación mantienen la clave fuera del comando en sí. Solo la configuran para la terminal actual y sus procesos secundarios. Utilice un gestor de secretos para aplicaciones desplegadas.

printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY

Instalar un cliente

pip install openai

Enviar su primera solicitud

Para la mayoría de las integraciones nuevas, comience 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."}]}'

Guarde un ejemplo de SDK como quickstart.py, quickstart.mjs, main.go o quickstart.php, luego ejecute python quickstart.py, node quickstart.mjs, go run . o php quickstart.php. Python, JavaScript y Go utilizan SDKs oficiales de OpenAI; PHP utiliza el cliente de OpenAI para PHP mantenido por la comunidad (PHP 8.2+).

Utilice POST /v1/responses solo cuando necesite un comportamiento específico de Responses. La compatibilidad con campos exclusivos de Responses depende del modelo seleccionado.

Confirmar el resultado

Una solicitud exitosa devuelve una respuesta no vacía. Abra Runs en el mismo espacio de trabajo para verificar su modelo, estado y uso. Para errores, siga la guía de solución de problemas. Cambiar el modelo o añadir streaming es un paso adicional en la guía del SDK.

¿Por qué mi primera llamada devuelve 402?

Si su primera llamada funciona o no depende del saldo que se muestra en Billing. Mientras la oferta de crédito de prueba esté activa, una cuenta nueva elegible recibe $0.25 una vez, para hasta 10 llamadas dentro de los 7 días; la llamada 11 devuelve 402 e indica que las llamadas de prueba gratuitas se han agotado, incluso si queda algo de crédito. Una cuenta con un saldo de $0 recibe un error HTTP 402 con el código insufficient_balance. Recargue al menos $5 en Billing; $5 es la recarga mínima. Luego, envíe la misma solicitud nuevamente. No necesita una nueva clave de API: la clave que creó seguirá funcionando una vez que el saldo cubra la solicitud.

Una primera llamada de prueba cuesta muy poco. Un ejemplo de solicitud a deepseek-v4.1-flash cuesta mucho menos de $0.01.

Si ya tiene algo de saldo, el mensaje 402 indica aproximadamente cuánto necesita la solicitud y cuál es su saldo. TokenLab retiene el costo del max_tokens completo antes de que comience la llamada, por lo que una entrada larga o un max_tokens grande pueden requerir más que un saldo pequeño. En /v1/chat/completions y /v1/messages, cuando un max_tokens más pequeño sería suficiente, el mensaje también proporciona el valor al que reducirlo. Cuando la entrada por sí sola cuesta más que su saldo, indica que debe acortar la entrada.

Una clave que alcanza su propio límite de gasto también devuelve 402, con el código quota_exceeded. Aumente o elimine el límite en API Keys. Para manejar el 402 en el código, consulte manejo de errores.

Siga construyendo

En esta página