TokenLab

Guides essentiels

Facturation et tarification

Fonctionnement des frais, des estimations, des soldes et des limites

Un solde TokenLab unique fonctionne avec tous les modèles. Il n'y a pas d'abonnement ni de dépense minimale. Les rechargements commencent à 5 $. Les frais sont basés sur le modèle et l'utilisation enregistrée pour chaque requête.

Options de livraison

Le même modèle et la même API sont disponibles via deux routes : Verified coûte moins cher, et Official est plus fiable. L'option de livraison détermine quelle route exécute une requête et quel prix vous payez.

OptionRoutePrixSi la route est indisponible
VerifiedVerified uniquement : routes testées par TokenLabPrix Verified, inférieur au prix Official sur la plupart des modèlesLa requête échoue et n'est pas facturée
OfficialOfficial uniquement : le créateur du modèle ou une plateforme majeurePrix Official, le prix publié par le créateur du modèleLa requête échoue et n'est pas facturée
Auto (par défaut)Verified en priorité. Official exécute la requête une fois si Verified n'a pas de disponibilité ou échoue avant toute sortieLe prix de la route qui a terminé la requêteOfficial exécute la requête

La page Models affiche les deux prix pour chaque modèle.

  • Chaque requête terminée est facturée une fois.
  • Auto ne bascule pas après le début de la sortie ou après l'acceptation d'une tâche.
  • Avant une exécution, Auto retient le plus élevé des deux montants possibles. Si le solde ne couvre que l'estimation Verified, Auto exécute uniquement Verified pour cette requête et ne bascule pas vers Official. Après l'exécution, vous payez les frais réels et le reste est libéré.
  • L'en-tête de requête X-TokenLab-Delivery-Policy remplace le paramètre de la clé API, et le paramètre de la clé API remplace la valeur par défaut de l'espace de travail (Workspace). Voir l'introduction à l'API.

Pour la génération payante, la Console affiche l'estimation maximale avant confirmation. Après l'achèvement, Runs et Usage affichent les frais finaux et l'option qui a terminé la requête.

Modèles de tarification

Les prix des modèles peuvent changer. Consultez la Console, la page Models, GET /v1/models/:model/pricing, ou l'API de tarification pour connaître le prix actuel.

Sur la page Models, un tiret dans la colonne du prix ou de la remise Verified signifie qu'aucune offre Verified n'est actuellement disponible ; cela ne signifie pas que c'est gratuit. Les modèles avec une offre Official restent disponibles via Official ou Auto. Dans l'API, les champs de prix Verified d'un tel modèle sont null ou omis, et les champs de prix official_* indiquent ce que vous payez. Les étiquettes de livraison décrivent les options prises en charge, tandis que la disponibilité est vérifiée lors de l'exécution de chaque requête. Les prix des séries résument les modèles avec une disponibilité dans l'option de livraison pertinente et maintiennent les unités de facturation distinctes.

Tarification basée sur les jetons (tokens)

La plupart des modèles de chat, de raisonnement, d'embedding, de rerank et certains modèles d'image sont facturés par jetons d'entrée, de sortie, de cache ou de sortie d'image.

Famille de tarificationExemplesVérifier le prix actuel
Chat / Réponsesgpt-5.4, claude-sonnet-4-6, gemini-3.6-flashPage Models ou API de tarification
Embeddings / reranktext-embedding-3-small, qwen3-vl-rerankDétail de tarification du modèle
Images tarifées par jetonsgpt-image-2GET /v1/models/gpt-image-2/pricing

Ne codez pas en dur un tableau de prix copié. Lisez le prix actuel lorsque votre application doit afficher ou comparer les coûts.

Frais d'outils

Certains outils intégrés coûtent plus cher en plus des jetons. TokenLab facture des frais d'outil uniquement lorsque le modèle utilise l'outil et que la réponse le signale. Une requête qui propose un outil que le modèle n'utilise pas n'entraîne aucuns frais d'outil.

OutilModèlesFrais
Recherche WebModèles OpenAI, Claude et Grok, et modèles Gemini 3 avec Google Search groundingChaque recherche effectuée par le modèle. Pour Gemini 3, chaque requête de recherche unique
Search groundingModèles Gemini 2.5 avec Google Search groundingUne fois pour chaque requête que la recherche a étayée
  • Chaque modèle a ses propres frais d'outil pour Verified et Official, identiques à ses prix par jeton. Les détails de tarification du modèle l'affichent sous le nom Web search ou Search grounding.
  • Les résultats de recherche lus par le modèle sont facturés comme des jetons d'entrée au prix du modèle.
  • Un outil sans prix sur un modèle n'est pas facturé.
  • Dans la Console, ouvrez une requête dans Runs : Tool fees affiche le nombre d'appels et le prix de chaque appel. Les enregistrements d'utilisation de la clé API affichent les mêmes valeurs dans charged_price_basis : le nombre dans measure.dimensions.webSearchCalls ou groundedPrompts, et le prix de chaque appel dans effectiveUnitPrices.webSearch ou effectiveUnitPrices.groundedPrompt.

Mise en cache des invites (Prompt caching)

Un modèle peut lire le début répété d'une invite à partir d'un cache. Les jetons lus à partir du cache coûtent moins cher que les jetons d'entrée.

  • Les modèles GPT, Gemini et certains autres modèles mettent automatiquement en cache les longues invites répétées. Vous n'avez rien à configurer.
  • Les modèles Claude ne mettent en cache que si vous le demandez. Envoyez "anthropic_options": {"prompt_caching": true} dans une requête Chat Completions. TokenLab marque la fin de l'invite système et le dernier message utilisateur comme points de cache. Avec l'API Messages, ajoutez vous-même cache_control aux blocs.
FraisComparé au prix d'entrée
Écriture en cache, 5 minutes (par défaut)Plus élevé
Écriture en cache, 1 heure ("prompt_caching_ttl": "1h")Plus élevé que l'écriture de 5 minutes
Lecture du cachePlus bas
  • Les prix du cache diffèrent selon le modèle et l'option de livraison. Vérifiez les prix du cache du modèle sur la page Models ou dans l'API de tarification avant de vous fier à un ratio.
  • Une invite qui ne se répète jamais coûte un peu plus cher avec la mise en cache activée, en raison de l'écriture dans le cache.
  • Une invite plus courte que la longueur minimale pouvant être mise en cache par le modèle n'est pas mise en cache et n'entraîne aucuns frais d'écriture en cache.
  • Un cache d'une heure n'est pas disponible sur tous les modèles. Si le modèle ne l'indique pas, utilisez le cache de cinq minutes.
  • La réponse affiche le résultat : usage.prompt_tokens_details.cached_tokens est le nombre de jetons lus à partir du cache. usage.cache_creation_input_tokens est le nombre écrit dans celui-ci, et n'apparaît que lorsqu'il est supérieur à zéro.

Niveau de service

TokenLab exécute et facture les requêtes au niveau de service standard. Les valeurs service_tier auto et default sont acceptées. Les autres valeurs, telles que flex, priority, fast et ultrafast, sont ignorées : la requête s'exécute au niveau standard et est facturée au prix standard.

Tarification des requêtes et des tâches

Les modèles d'image, de vidéo, de musique, 3D, audio et mondiaux peuvent être facturés par requête, image, seconde, minute ou tâche. La page du modèle indique l'unité de facturation.

FamilleExemples
Imageflux-pro-1.1
Vidéoveo3.1, seedance-2.0
Musiquesuno-music
3Dtripo-h3.1
Audiogrok-tts, whisper-large-v3

Facturation des tâches asynchrones

Certaines tâches réservent le coût estimé lors de leur création. Une tâche terminée est facturée une fois ; une tâche échouée libère ou rembourse le montant en attente.

La génération de vidéo, de musique, 3D et d'image basée sur des tâches renvoie un ID de tâche et une poll_url. Le montant final est enregistré une fois que la tâche devient completed ou failed. Une tâche terminée inclut billing_transaction_id après la facturation ; une tâche échouée n'est pas facturée.

Si Usage n'affiche toujours pas les frais finaux ou le montant libéré une fois la tâche terminée, contactez hello@tokenlab.sh avec l'ID de requête et l'ID de tâche.

ID de transaction de facturation

Les réponses non diffusées (non-streaming) compatibles avec OpenAI incluent billing_transaction_id lorsque la facturation se termine avant l'envoi de la réponse. La même valeur peut apparaître dans X-Billing-Transaction-ID ; Gemini et d'autres formats natifs peuvent ne l'exposer que dans cet en-tête.

Les tâches asynchrones incluent billing_transaction_id après l'achèvement. Le streaming peut se terminer avant la facturation, utilisez donc Usage lorsque l'en-tête est absent.

Nombre de jetons

Les modèles de texte rapportent généralement les jetons d'entrée, de sortie et totaux dans usage. La tokenisation diffère selon le modèle, la langue et l'entrée média, les formules basées sur le nombre de caractères ne sont donc pas des estimations de facturation fiables. Utilisez le prix actuel du modèle et l'enregistrement Usage final.

Trouver votre utilisation

Ouvrez Usage pour trouver :

  • Le solde en temps réel
  • L'historique d'utilisation par modèle
  • La répartition des coûts
  • L'utilisation de la clé API

Réponse de l'API

Les réponses basées sur des jetons incluent généralement des informations d'utilisation :

{
  "usage": {
    "prompt_tokens": 50,
    "completion_tokens": 100,
    "total_tokens": 150
  }
}

Dépenser moins

Alertes de solde bas

Définissez un seuil dans Console → Settings. TokenLab vous envoie un e-mail lorsque le solde tombe en dessous de ce seuil.

Ajouter du solde

Ouvrez Console → Billing, choisissez un montant et utilisez l'un des modes de paiement affichés lors du paiement. Le solde est mis à jour après que le fournisseur de paiement confirme le paiement.

Pendant la durée de l'offre de crédit d'essai, un nouveau compte éligible reçoit un crédit d'essai unique de 0,25 $ pour un maximum de 10 appels. Le crédit d'essai inutilisé expire après 7 jours.

Pour éviter que les requêtes ne s'arrêtent en cas de solde bas, activez Automatic funding dans Billing. Cela ajoute des fonds lorsque le solde tombe en dessous du montant que vous avez défini, jusqu'à une limite mensuelle.

Limites de clé API

Vous pouvez définir une limite de dépenses lors de la création ou de la modification d'une clé API dans Console → API Keys.

Lorsque la limite est atteinte, les requêtes avec cette clé renvoient 402 avec le code quota_exceeded. Augmentez ou supprimez la limite pour continuer.

Aide à la facturation

Contactez hello@tokenlab.sh pour toute question relative à la facturation.

Sur cette page