TokenLab

Démarrage

Démarrage rapide

Effectuez votre première requête API TokenLab avec cURL, Python, JavaScript, Go ou PHP. Configurez votre clé API, paramétrez le point de terminaison et vérifiez une réponse de Chat Completions.

Obtenir une clé API

Créer un compte

Inscrivez-vous sur tokenlab.sh en utilisant votre adresse e-mail, votre compte Google ou GitHub.

Créer et enregistrer une clé API

Ouvrez API Keys dans votre espace de travail. Créez une clé et enregistrez immédiatement la valeur complète ; elle n'est affichée qu'une seule fois. Si vous avez déjà enregistré une clé complète, utilisez cette valeur. Le préfixe affiché ou copié depuis la liste ne peut pas authentifier les requêtes.

Vérifier le solde de l'espace de travail

Vérifiez votre solde dans Billing. Un nouveau compte peut bénéficier d'un crédit d'essai unique ; sinon, il commence à 0 $ et nécessite un rechargement (minimum 5 $) avant la première requête. La requête est facturée au prix actuel du modèle sélectionné.

Gardez la clé API secrète. Ne l'incluez pas dans le code côté client ou dans un dépôt public.

Définir la clé pour ce terminal

Les commandes ci-dessous permettent de ne pas inclure la clé directement dans la commande. Elles la définissent uniquement pour le terminal actuel et ses processus enfants. Utilisez un gestionnaire de secrets pour les applications déployées.

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

Installer un client

pip install openai

Envoyer votre première requête

Pour la plupart des nouvelles intégrations, commencez par Chat Completions sur 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."}]}'

Enregistrez un exemple de SDK sous quickstart.py, quickstart.mjs, main.go ou quickstart.php, puis exécutez python quickstart.py, node quickstart.mjs, go run . ou php quickstart.php. Python, JavaScript et Go utilisent les SDK officiels d'OpenAI ; PHP utilise le client OpenAI PHP maintenu par la communauté (PHP 8.2+).

Utilisez POST /v1/responses uniquement lorsque vous avez besoin d'un comportement spécifique aux Responses. La prise en charge des champs réservés aux Responses dépend du modèle sélectionné.

Confirmer le résultat

Une requête réussie renvoie une réponse non vide. Ouvrez Runs dans le même espace de travail pour vérifier son modèle, son statut et son utilisation. En cas d'erreur, suivez le guide de dépannage. Changer de modèle ou ajouter le streaming constitue une étape suivante distincte dans le guide du SDK.

Pourquoi mon premier appel renvoie-t-il 402 ?

Le succès de votre premier appel dépend du solde affiché dans Billing. Tant que l'offre de crédit d'essai est active, un nouveau compte éligible reçoit 0,25 $ une fois, pour un maximum de 10 appels sur 7 jours ; le onzième appel renvoie 402 et indique que les appels d'essai gratuits sont épuisés, même s'il reste un peu de crédit. Un compte avec un solde de 0 $ reçoit une erreur HTTP 402 avec le code insufficient_balance. Rechargez au moins 5 $ dans Billing ; 5 $ est le montant minimum de rechargement. Envoyez ensuite la même requête à nouveau. Vous n'avez pas besoin d'une nouvelle clé API : la clé que vous avez créée continue de fonctionner une fois que le solde couvre la requête.

Un premier appel de test coûte très peu. Un exemple de requête vers deepseek-v4.1-flash coûte bien moins de 0,01 $.

Si vous avez déjà un solde, le message 402 indique approximativement le montant nécessaire pour la requête et votre solde actuel. TokenLab retient le coût de la totalité des max_tokens avant le début de l'appel ; ainsi, une entrée longue ou une valeur max_tokens élevée peut nécessiter un solde plus important qu'un petit solde. Sur /v1/chat/completions et /v1/messages, lorsqu'une valeur max_tokens plus petite conviendrait, le message indique également la valeur à laquelle la réduire. Lorsque l'entrée seule coûte plus cher que votre solde, il est conseillé de raccourcir l'entrée.

Une clé qui atteint sa propre limite de dépenses renvoie également 402, avec le code quota_exceeded. Augmentez ou supprimez la limite dans API Keys. Pour gérer le code 402 dans votre code, consultez la section gestion des erreurs.

Continuer à développer

Sur cette page