✨ Skill d’intégration API TokenLab

Cette page documente le skill partagé tokenlab-api-integration maintenu. La distribution canonique se trouve dans hedging8563/tokenlab-skills, où le dépôt public conserve volontairement uniquement ce skill.

Cette page couvre l’installation du skill et le workflow agent. Pour la configuration d’un endpoint, utilisez la page SDK, client ou référence API dédiée.

Ce que fait le skill

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.

Installation

Utilisez la commande d’installation canonique non interactive :

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

Cette commande installe le skill partagé tokenlab-api-integration depuis le dépôt TokenLab skills.Si votre outil ne prend pas en charge l’installer, copiez skills/tokenlab-api-integration/ depuis le dépôt vers le dossier skills ou rules partagé de votre outil.

Mettre à jour une installation existante

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’installation

Demandez à votre coding agent :

Quelles skills sont disponibles ?

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

Obtenir votre API Key

Visiter TokenLab

Allez sur tokenlab.sh

Se connecter

Créez un compte ou connectez-vous

Obtenir une API Key

Ouvrez Dashboard → API Keys et créez une nouvelle key

Copier la key

Votre key commence par sk-.... Conservez-la en sécurité.

Ne collez pas les API keys dans les prompts ou les fichiers source. Le skill doit demander quelle variable d’environnement utiliser et générer du code qui lit la key depuis cette variable.

Workflow Agent recommandé

Commencez par le plus petit exemple fonctionnel adapté au langage et à la famille API demandés.
Si le choix du modèle est ouvert, appelez /v1/models ou https://api.tokenlab.sh/llms.txt avant de coder un modèle en dur.
Pour les tâches non-chat, appelez /v1/models?recommended_for=<scene> où <scene> vaut image, video, music, 3d, tts, stt, embedding, rerank ou translation.
Avant de modifier une requête non-chat échouée, lisez /v1/models/:model et alignez supported_operations, supported_parameters, request_endpoint, request_endpoint_by_operation, request_shape_mode et recommended_request.
Si l’API renvoie une erreur Agent-First, utilisez les champs structurés pour corriger la requête et ne réessayez que si l’erreur est retryable.

Exemple chat minimal

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-4o-mini",
    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 publics

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 sk-KEY"
curl "https://api.tokenlab.sh/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Listes courtes non-chat classées
curl "https://api.tokenlab.sh/v1/models?recommended_for=image" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" -H "Authorization: Bearer sk-KEY"
curl "https://api.tokenlab.sh/v1/models?recommended_for=translation" -H "Authorization: Bearer sk-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 sk-KEY"

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

Sélection du protocole natif

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-First

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

Erreur	Champs utiles	Action de l’agent
Nom de modèle incorrect	`did_you_mean`, `suggestions`, `hint`	Réessayer avec le modèle corrigé ou une alternative suggérée
Solde insuffisant	`balance_usd`, `estimated_cost_usd`, `suggestions`	Demander une approbation ou passer à un modèle abordable
Limite de débit ou indisponibilité temporaire	`retryable`, `retry_after`, `alternatives`	Attendre, réessayer ou choisir une alternative listée
Requête non-chat incompatible	`supported_operations`, `supported_parameters`, `request_endpoint`, `request_endpoint_by_operation`, `request_shape_mode`, `recommended_request`	Reconstruire la requête à partir des détails du modèle et renvoyer une erreur explicite pour les champs qui modifient l’intention

Familles API prises en charge

Famille	Chemin principal
Chat et Responses	`/v1/chat/completions`, `/v1/responses`
Messages natifs Claude	`/v1/messages`
Requêtes natives Gemini	`/v1beta/models/{model}:generateContent`
Images	`/v1/images/generations`, `/v1/images/edits`
Vidéo	`/v1/videos/generations`
Musique	`/v1/music/generations`
Worlds	`/v1/worlds/generations` plus endpoints de statut world et media asset
3D	`/v1/3d/generations`
Audio	`/v1/audio/speech`, `/v1/audio/transcriptions`, `/v1/audio/translations`
Realtime	`/v1/realtime?model={model}`
Embeddings et rerank	`/v1/embeddings`, `/v1/rerank`
Traduction de texte	`/v1/translations`

Bonnes pratiques

Sécurité des API Keys

Utilisez des variables d’environnement et des appels côté serveur. N’exposez jamais les keys dans le code frontend.

Contrat d’abord pour le non-chat

Lisez /v1/models?recommended_for=... et /v1/models/:model avant de relancer des requêtes image, vidéo, musique, 3D, traduction, audio, embedding ou rerank.

Plus petit exemple exécutable

Produisez un appel fonctionnel avant d’ajouter abstractions, files d’attente ou flows UI.

Utiliser les indices structurés

Parsez did_you_mean, retry_after, alternatives et recommended_request avant de modifier le code.

FAQ

Le skill ne se déclenche pas automatiquement ?

Mentionnez “TokenLab” ou “TokenLab API” dans la demande, par exemple : Utilise TokenLab pour ajouter la génération d’images à mon app Node.js.

Quels coding agents sont pris en charge ?

Tout coding agent prenant en charge des dossiers partagés de skills ou rules peut utiliser ce dossier. L’installer skills gère automatiquement les agents compatibles.

Comment mettre à jour le skill ?

Relancez la commande d’installation. Elle rafraîchit la copie locale depuis le dépôt public canonique.

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

Ressources

Agent-First API

Indices d’erreur structurés et comportement de récupération

Documentation API

Configuration par endpoint et API Reference

Modèles

Parcourir les modèles disponibles

llms.txt

Vue d’ensemble API lisible par machine pour agents

Des questions ? Utilisez GitHub Issues ou contactez support@tokenlab.sh.

Démarrage

Guides essentiels

Guides médias

✨ Skill d’intégration API TokenLab

Ce que fait le skill

Installation

Mettre à jour une installation existante

Vérifier l’installation

Obtenir votre API Key

Workflow Agent recommandé

Exemple chat minimal

Découverte des modèles et contrats publics

Sélection du protocole natif

Récupération d’erreurs Agent-First

Familles API prises en charge

Bonnes pratiques

Sécurité des API Keys

Contrat d’abord pour le non-chat

Plus petit exemple exécutable

Utiliser les indices structurés

FAQ

Ressources

Agent-First API

Documentation API

Modèles

llms.txt

​Ce que fait le skill

​Installation

​Mettre à jour une installation existante

​Vérifier l’installation

​Obtenir votre API Key

​Workflow Agent recommandé

​Exemple chat minimal

​Découverte des modèles et contrats publics

​Sélection du protocole natif

​Récupération d’erreurs Agent-First

​Familles API prises en charge

​Bonnes pratiques

Sécurité des API Keys

Contrat d’abord pour le non-chat

Plus petit exemple exécutable

Utiliser les indices structurés

​FAQ

​Ressources

Agent-First API

Documentation API

Modèles

llms.txt

Ce que fait le skill

Installation

Mettre à jour une installation existante

Vérifier l’installation

Obtenir votre API Key

Workflow Agent recommandé

Exemple chat minimal

Découverte des modèles et contrats publics

Sélection du protocole natif

Récupération d’erreurs Agent-First

Familles API prises en charge

Bonnes pratiques

FAQ

Ressources