Aller au contenu
EN 4 QUESTIONSTrouver mon modèle
Les outils expliqués · guide expert · 15 min de lecture

L'API de Claude : console, prix, effort et cache

La plateforme Claude vend l'accès aux modèles d'Anthropic au nombre de jetons, pour bâtir ses propres applis et agents. Voici comment ouvrir un compte, faire un premier appel, régler l'effort de réflexion et payer moins grâce au cache et au traitement par lots.

Disponible en France

Illustration du dossier Anthropic

La plateforme Claude donne accès aux modèles Claude depuis vos propres programmes. On y paie au jeton, en dollars, indépendamment de tout abonnement à l’appli. Ce guide suit la documentation officielle lue le 17 novembre 2026 : premier appel, prix, effort de réflexion, cache et traitement par lots.

Comment ça marche

Ce qui part dans une requête à l'API Messages et ce qui revient, d'après la documentation de la plateforme Claude lue le 17 novembre 2026.

Votre programme envoie une requête à l’API Messages : le modèle (claude-opus-5-5, par exemple), la conversation, la longueur maximale de la réponse (max_tokens) et, au besoin, l’effort et des marqueurs de cache. La réponse revient avec le texte et le décompte des jetons consommés, que la facture multiplie par le tarif du modèle. Des SDK officiels existent pour Python, TypeScript, C#, Go, Java, PHP et Ruby.

Les modèles actuels ont tous une fenêtre de contexte d’un million de jetons et 128 000 jetons de sortie au plus. Leur réflexion est « adaptative » : le modèle décide quand et combien réfléchir, et l’effort règle cette profondeur. Sur Fable 5.2 et Opus 5.5, la réflexion est toujours allumée ; une requête qui la coupe ou fixe un budget de réflexion (budget_tokens) renvoie une erreur.

Les prix

D’après la page des prix de la documentation, en dollars par million de jetons (MTok) :

Modèle Entrée Sortie Écriture cache 5 min Écriture cache 1 h Lecture cache
Claude Fable 5.2 8 $ 40 $ 10 $ 16 $ 0,20 $
Claude Opus 5.5 4 $ 20 $ 5 $ 8 $ 0,20 $
Claude Sonnet 5.5 2 $ 10 $ 2,50 $ 4 $ 0,10 $
Claude Haiku 5.5 (requête jusqu’à 100 000 jetons) 0,10 $ 0,50 $ 0,125 $ 0,20 $ 0,01 $
Claude Haiku 5.5 (au-delà de 100 000 jetons) 0,50 $ 2,50 $ 0,625 $ 1 $ 0,05 $
Page Pricing de la documentation : tableau Model pricing avec, pour Fable 5.2, Opus 5.5, Sonnet 5.5 et Haiku 5.5, le prix de l'entrée, de la sortie, des écritures de cache à 5 minutes et 1 heure, et des lectures de cache.
Le tableau des prix de la plateforme Claude, en dollars par million de jetons, avec les colonnes du cache (capture du 17 novembre 2026, platform.claude.com).

Les autres règles de la même page :

  • Le traitement par lots (Batch API) divise par deux l’entrée et la sortie, pour des requêtes traitées de façon asynchrone.
  • Le contexte long ne coûte pas plus cher par jeton, sauf sur Haiku 5.5, qui change de tarif au-delà de 100 000 jetons de prompt (cache compris).
  • Le mode rapide (« fast mode ») donne jusqu’à 2,5 fois plus de jetons par seconde en sortie, à prix majoré : 16 $ et 80 $ par million pour Fable 5.2. Il ne se combine pas avec les lots.
  • L’inférence aux États-Unis seulement (inference_geo: "us") multiplie tous les prix par 1,1 ; le routage mondial, par défaut, garde le tarif normal.
  • La recherche web coûte 10 $ les 1 000 recherches, auxquels s’ajoutent les jetons des résultats.

Les abonnés Max, Ultra et Team reçoivent des crédits d’API chaque mois (100 $ pour Max, 200 $ pour Ultra), à réclamer en reliant une organisation de la Console dans « Settings », « Billing ». Pro et la formule gratuite n’y ont pas droit.

Faire un premier appel pas à pas

  1. Créez un compte sur la Console (platform.claude.com) et ajoutez des crédits.
  2. Authentifiez-vous. La documentation conseille l’outil en ligne de commande ant pour le développement local, ou une clé d’API créée dans la Console :
brew install anthropics/tap/ant
ant auth login
  1. Installez le SDK Python dans un environnement neuf :
mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic
  1. Écrivez la requête dans quickstart.py :
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Résume en trois points les avantages d'une pompe à chaleur."}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)
  1. Lancez-la avec python quickstart.py, puis regardez l’usage dans la Console.

Régler l’effort

Le paramètre output_config.effort arbitre entre qualité, vitesse et coût, sur cinq niveaux : low, medium, high, xhigh et max. Il agit sur tous les jetons de la réponse, réflexion et appels d’outils compris : un effort bas donne des réponses plus directes et moins d’appels d’outils.

  • Par défaut : medium sur Opus 5.5 et Haiku 5.5, high sur les autres modèles.
  • xhigh vise les tâches d’agent ou de code de plus de 30 minutes ; max sert surtout à mesurer le plafond du modèle.
  • La documentation conseille de mesurer plusieurs niveaux sur vos propres tests plutôt que de reprendre les réglages d’un ancien modèle. Changer d’effort entre deux requêtes peut invalider le cache ; sur Fable 5.2, un changement par message le préserve.

Dans l’appli Claude, le même réglage se trouve en cliquant sur le nom du modèle à côté du bouton d’envoi, puis sur « Effort ».

Payer moins avec le cache

Le cache garde le début d’une requête (outils, consignes système, messages) pour les appels suivants. Une lecture du cache coûte bien moins que l’entrée normale (0,20 $ au lieu de 4 $ par million de jetons sur Opus 5.5) ; l’écriture coûte un peu plus cher que l’entrée.

  1. Le plus simple : un seul champ cache_control={"type": "ephemeral"} au niveau de la requête, et l’API place elle-même le point de cache au bout de la partie réutilisable, en le déplaçant à mesure que la conversation grandit.
  2. Plus précis : placer cache_control sur des blocs choisis.
  3. La durée : cinq minutes par défaut, prolongées gratuitement à chaque réutilisation ; une heure en option, avec une écriture plus chère. Le compte part du début de la requête, temps de réponse compris.
  4. Le gain : mettez en tête ce qui ne change pas (consignes, documents de référence, définitions d’outils) et en fin ce qui change.

Installer Claude Agent SDK

npm · nouveau projet · TypeScript, nouveau projet (Node.js 18+)

npm init -y
npm pkg set type=module
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

npm · projet existant · TypeScript, projet existant

npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

uv · Python avec uv (Python 3.10+)

uv init
uv add claude-agent-sdk

pip · macOS · Python avec pip, macOS ou Linux

python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk

pip · Windows · Python avec pip, Windows

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install claude-agent-sdk

macOS · macOS, Linux (clé d'API)

export ANTHROPIC_API_KEY=your-api-key

Windows · Windows (PowerShell, clé d'API)

$env:ANTHROPIC_API_KEY = "your-api-key"

D'après code.claude.com, lue le 3 octobre 2026.La fiche de Claude Agent SDK →

Pour un agent complet (outils, fichiers, sous-agents), le SDK Claude Agent reprend la mécanique de Claude Code dans vos programmes.

Disponible en France ?

Oui. La France figure dans la liste des régions ouvertes par Anthropic, dont les services sont fournis dans l’Union européenne par Anthropic Ireland. Les prix sont en dollars.

Limites et précautions

  • Une clé d’API vaut de l’argent. Ne la mettez jamais dans un dépôt de code ni dans une appli publiée ; préférez une variable d’environnement et une date d’expiration.
  • La sortie coûte cinq fois l’entrée sur les modèles actuels : limitez max_tokens et la longueur demandée.
  • L’effort élevé allonge la facture. Il augmente le nombre de jetons produits, réflexion comprise.
  • Les données des requêtes suivent les conditions commerciales d’Anthropic, différentes de celles de l’appli grand public.

Pour aller plus loin

Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.

Tous les guides →

Sources

  1. Claude Platform Docs, Get started with Claude, lue le
  2. Claude Platform Docs, Pricing, lue le
  3. Claude Platform Docs, Models overview, lue le
  4. Claude Platform Docs, Effort, lue le
  5. Claude Platform Docs, Prompt caching, lue le
  6. Claude Platform Docs, Choosing the right model, lue le
  7. Claude Help Center, Change the model, effort, and thinking settings, lue le
  8. Claude Help Center, Monthly API credits for Max and Team plans, lue le
  9. Anthropic, Introducing Claude Haiku 5.5, lue le
  10. Anthropic, Supported Regions Policy, lue le