Guides essentiels
Une intégration TokenLab fiable
Une intégration TokenLab fiable
Modèles et coût
Consultez les capacités et prix actuels dans l’API ou la page du modèle. Comparez des tâches identiques et indiquez le modèle dans chaque requête. Ne changez pas de modèle sans l’annoncer : prix, qualité, outils et contexte peuvent varier.
Limitez la sortie selon le format et le modèle, et réduisez le contexte dupliqué. Le coût des médias dépend parfois du nombre, de la durée ou de la résolution ; affichez l’estimation disponible avant une génération coûteuse.
Streaming et reprises
Le streaming affiche le texte plus tôt sans réduire le coût des tokens. Conservez la sortie partielle utile après une coupure sans la présenter comme une réponse complète.
Pour 429, respectez Retry-After ou retry_after ; appliquez une courte attente progressive aux 5xx temporaires. Authentification, permissions, solde, validation et contexte exigent une correction. Limitez les tentatives et la durée totale sans cumuler les reprises du SDK.
Clés et journaux
Gardez les clés sur le serveur ou dans un gestionnaire de secrets, jamais dans le navigateur, une application distribuée, un dépôt public ou les logs. Séparez développement, production et applications, limitez modèles et dépenses et révoquez les clés exposées.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKENLAB_API_KEY"],
base_url="https://api.tokenlab.sh/v1",
timeout=30.0,
max_retries=0,
)Enregistrez request_id, task_id, le billing_transaction_id reçu, le modèle, l’endpoint et votre ID de tâche. Excluez identifiants, prompts privés complets, médias et URL signées. Le montant final figure dans Usage ou l’API de gestion.
Tâches asynchrones
Enregistrez l’ID et poll_url dès la création asynchrone, puis consultez jusqu’à completed ou failed. Une erreur de consultation ne signifie pas un échec de génération. Après expiration ou rechargement, reprenez la tâche enregistrée ; utilisez une clé d’idempotence si l’endpoint le permet.
Avant publication
Avant publication, vérifiez le modèle et le format exacts, les succès et erreurs courantes, le prix actuel, les rechargements et les clics répétés.