TokenLab

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.

Travaux Asynchrones & Polling

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.

Sur cette page