✨ Skill d’intégration API TokenLab

Lisez cette page et ajoutez le Skill TokenLab à mon agent actuel. Vérifiez d’abord la version et la configuration active. Conservez les comptes, fournisseurs, permissions et réglages existants. Sauvegardez les fichiers et montrez les modifications. Je saisirai la clé API localement ; ne la demandez ni ne l’affichez dans le chat. Vérifiez le chargement de la configuration et expliquez tout test payant avant de l’exécuter.
https://tokenlab.sh/docs/fr/integrations/coding-agent-skill

Ce que fait le skillCopy Anchor Link

• Génère des exemples minimaux exécutables pour les familles API TokenLab chat, image, audio, vidéo, traduction et autres.
• Utilise https://api.tokenlab.sh/v1 pour les clients compatibles OpenAI et explique quand passer aux routes natives Anthropic ou Gemini.
• Découvre les modèles avec /v1/models, /llms.txt et les listes recommended_for, au lieu de deviner depuis des listes obsolètes.
• Lit le détails du modèle d’un modèle avant de relancer les requêtes non-chat afin de ne pas supprimer silencieusement des champs non pris en charge.
• Gère les indices d’erreur Agent-First comme did_you_mean, suggestions, retry_after et recommended_request.

InstallationCopy Anchor Link

npx skills add https://github.com/hedging8563/tokenlab-skills --skill tokenlab-api-integration -y

Mettre à jour une installation existanteCopy Anchor Link

Si vous avez installé le skill avant le nettoyage du dépôt TokenLab, relancez la même commande. Le package public actuel est plus petit et ne dépend plus de scripts de recherche locaux générés.

Vérifier l’installationCopy Anchor Link

Demandez à votre coding agent :

Quelles skills sont disponibles ?

Si tokenlab-api-integration apparaît, l’installation a réussi.

Obtenir votre API KeyCopy Anchor Link

Workflow Agent recommandéCopy Anchor Link

Lisez la liste actuelle puis tokenlab.accepted_request_formats et les champs publics du modèle choisi. Gardez le même format pour une conversation et ses appels d’outils ; les champs ne sont pas convertis automatiquement. Ne changez pas de modèle ou de protocole de votre propre initiative en cas d’erreur.

Exemple chat minimalCopy Anchor Link

Cet exemple utilise le SDK Python OpenAI avec la base URL 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-5.6-luna",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(response.choices[0].message.content)

Exécutez-le avec :

pip install openai
export TOKENLAB_API_KEY="sk-your-api-key"
python app.py

Découverte des modèles et contrats publicsCopy Anchor Link

Préférez la découverte en direct aux listes embarquées obsolètes :

# Vue d’ensemble API lisible par machine
curl https://api.tokenlab.sh/llms.txt

# Lister les modèles
curl "https://api.tokenlab.sh/v1/models" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# Listes courtes non-chat classées
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# Lire le détails du modèle d’un modèle avant de relancer une requête non-chat
curl "https://api.tokenlab.sh/v1/models/gpt-image-2" -H "Authorization: Bearer $TOKENLAB_API_KEY"

# Détail des prix uniquement
curl "https://api.tokenlab.sh/v1/models/gpt-image-2/pricing" -H "Authorization: Bearer $TOKENLAB_API_KEY"

Sélection du protocole natifCopy Anchor Link

Le chemin compatible OpenAI /v1 est le chemin par défaut pour les exemples courants de chat, image, embedding, audio et rerank. Ne déduisez pas la disponibilité d'un protocole natif du nom du modèle ou du fournisseur, ni des en-têtes d'une réponse Chat. Consultez GET /v1/models/{model} et utilisez uniquement un format de requête annoncé dans les détails du modèle.

Le champ à lire est tokenlab.accepted_request_formats.

Les endpoints sont /v1/chat/completions pour Chat Completions, /v1/responses pour Responses, /v1/messages pour Messages et /v1beta/models/{model}:generateContent pour Gemini.

Récupération d’erreurs Agent-FirstCopy Anchor Link

Les erreurs incluent des champs que les coding agents peuvent parser sans scraper la documentation :

Utilisez d’abord le statut HTTP et le code d’erreur. did_you_mean peut corriger un nom, mais ne changez pas de modèle sans le choix de l’utilisateur. Pour 429, respectez Retry-After ou retry_after et ne réessayez que si l’erreur le permet et que cette action est explicitement choisie. Corrigez d’abord les erreurs de validation, d’authentification, de solde ou de permission. Après un délai dépassé lors d’une création, vérifiez si une tâche existe déjà avant de renvoyer la demande.

Familles API prises en chargeCopy Anchor Link

Bonnes pratiquesCopy Anchor Link

FAQCopy Anchor Link

RessourcesCopy Anchor Link

Pour les questions API ou de compte, utilisez le support intégré, vérifiez l’aperçu et envoyez explicitement. Pour une requête précise, partez de Requêtes et du guide de dépannage. Signalez les défauts du Skill dans GitHub Issues.