← Tous les articles

API Claude : clé, point de terminaison /v1/messages et choix d'une version du modèle

Une clé d'accès numérique lumineuse à côté de blocs de texte volumétriques flottants sur un fond sombre

L'API Claude vous permet d'appeler les modèles Claude à partir de votre propre code au lieu d'une fenêtre de discussion : un bot de support sur votre site, un script qui trie les tickets, la complétion du code dans un éditeur, une intégration CRM. Sur NeuralSpace une clé est créée dans votre tableau de bord en une minute environ, les requêtes vont au compatible Anthropic POST /v1/messages point de terminaison, et vous payez à partir d’un solde symbolique sans abonnement. Vous trouverez ci-dessous un guide étape par étape : comment obtenir une clé, à quoi ressemble votre premier appel et comment choisir une version de modèle : Haiku, Sonnet, Opus ou Fable.

Qu'est-ce que l'API Claude et en quoi elle diffère du chat

Claude est la famille de modèles linguistiques d'Anthropic. Dans une fenêtre de discussion, vous parlez manuellement au modèle ; via l'API, votre code fait la même chose : il envoie un tableau de messages, obtient une réponse générée et l'utilise dans votre produit - la montre à l'utilisateur, la stocke, la traite davantage. Cas d'utilisation typiques : soutenir des robots, résumer des e-mails et des documents, extraire des données structurées, rédiger du contenu, automatiser le travail de routine dans des scripts. La principale différence avec le chat est la prévisibilité : vous définissez vous-même l'instruction système, la limite de réponse et la version du modèle, et vous voyez les dépenses en jetons.

Étape 1. Obtenez une clé

  1. Inscrivez-vous à NeuralSpace avec votre e-mail – cela prend moins d'une minute. Les nouveaux utilisateurs reçoivent des jetons de démarrage crédités, suffisamment pour les premières demandes sans recharge.
  2. Ouvrez le Page des clés API dans votre tableau de bord, saisissez un nom de clé (par exemple, « Mon bot ») et cliquez sur Créer.
  3. La clé ressemble à nsk-… et n'est affiché qu'une seule fois : copiez-le directement dans un gestionnaire de mots de passe ou une variable d'environnement, pas dans le code de votre référentiel.
  4. Vérifiez votre solde : les modèles de texte nécessitent au moins 50 tokens sur le compte. Les recharges s'effectuent dans le tableau de bord, sans frais d'abonnement.
La page des clés de l'API NeuralSpace : création d'une clé et démarrage rapide de Claude

Étape 2. Votre premier appel à /v1/messages

Les modèles de texte Claude en direct sur le compatible Anthropic POST https://neuralspace.pro/v1/messages point final. Le corps porte le modèle, un messages tableau avec user/assistant rôles, la limite de réponse max_tokens (1 à 32000) et un en option system instruction. Une demande de curl minimale :

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "You answer technical questions briefly.",
    "messages": [{"role": "user", "content": "How is streaming different from a regular response?"}]
  }'

La réponse revient au format Anthropique : le texte est en content[0].text et les dépenses réelles sont dans usage champ. Authentifiez-vous auprès du x-api-key: nsk-… en-tête ; les clients qui parlent uniquement Bearer peuvent utiliser Authorization: Bearer nsk-… plutôt.

Étape 3. Branchez le SDK Anthropic

Si vous avez déjà du code sur le SDK Anthropic officiel, vous modifiez exactement deux valeurs : base_url et la clé :

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-your_key",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="You answer technical questions briefly.",
    messages=[{"role": "user", "content": "Suggest three names for a channel about AI"}],
)
print(resp.content[0].text)

Pour les interfaces de chat, le streaming aide : ajoutez "stream": true et la réponse arrive en morceaux via les événements envoyés par le serveur, de sorte que l'utilisateur voit les premiers mots avant la fin de la génération.

Quelle version de modèle choisir

Le catalogue public NeuralSpace comporte quatre versions Claude, et la différence entre elles réside dans l'équilibre entre la vitesse et le prix et la profondeur du raisonnement. Les prix ci-dessous sont en jetons de site par million de jetons API, avec entrée et sortie facturées séparément (au moment de la rédaction ; les tarifs sont flottants) :

  • Claude Haïku 4.5 (claude-haiku-4-5) — 41 / 213. Le plus rapide et le moins cher : classification, réponses courtes, traitement de texte en masse, étiquetage approximatif.
  • Claude Sonnet5 (claude-sonnet-5) — 152,5 / 767. Le cheval de bataille : code, instructions longues, dialogues riches en contexte. Un défaut judicieux.
  • Claude Opus 5 (claude-opus-5) — 359 / 1794.5. Pour les tâches difficiles : raisonnement en plusieurs étapes, analyse de documents volumineux, logique subtile.
  • Claude Fable 5 (claude-fable-5) — 718 / 3589,5. Le produit phare pour les scénarios les plus exigeants, où la qualité compte plus que le prix.

Une règle pratique : commencer par Haiku ou Sonnet et passer sélectivement à Opus et Fable, uniquement là où les deux premiers échouent vraiment. La version est définie par un seul model dans la demande, afin que vous puissiez les comparer sur la même invite.

Streaming, limites et points de terminaison de service

Deux limites font trébucher les gens plus tôt : 60 requêtes par minute et par clé et un solde minimum de 50 jetons pour les modèles de texte. Votre solde actuel provient de GET /v1/balance, et une liste de modèles lisible par machine avec les prix en direct de GET /v1/models. Les deux nécessitent une clé. Les tarifs en vigueur sont toujours indiqués dans le tableau sur le Page de documentation de l'API.

Claude API et MCP : le connecter à Claude Code

La même clé connecte NeuralSpace aux agents IA en tant que serveur MCP : l'agent appelle lui-même la génération de chat, d'images, de vidéos et de musique au nom de votre compte. Pour Claude Code, il s'agit d'une seule commande :

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

Si vous n'avez pas encore besoin de l'API, les mêmes modèles sont disponibles dans l'interface — en chat vous pouvez choisir Claude et parler sans code, et le solde est partagé entre le chat et l'API.

FAQ

Ai-je besoin d’un compte Anthropic ou d’une carte étrangère ?

Non. La clé est émise dans votre tableau de bord NeuralSpace et vous payez avec des jetons de compte – pas d'abonnement ni de configuration de facturation cloud.

En quoi /v1/messages est-il différent de /v1/chat/completions ?

Ce sont deux formats de la même API. /v1/messages reflète l'API Anthropic Messages (champs model, messages, system, max_tokens) et convient aux modèles Claude et au SDK Anthropic. /v1/chat/completions est le format OpenAI pour les modèles de chat GPT et Grok. Seules l'adresse et la structure du corps changent.

Combien coûte un appel API Claude ?

Uniquement pour les jetons que vous utilisez réellement : Claude Sonnet 5 au moment de la rédaction de cet article représente 152,5 jetons par million d'entrée et 767 par million de sortie. Une demande de quelques milliers de jetons coûte environ 0,01 $. Les prix actuels sont en GET /v1/models et dans le tableau de documentation.

Existe-t-il un niveau gratuit ?

Il n’y a pas de générations gratuites sur la plateforme. Les nouveaux utilisateurs reçoivent des jetons de démarrage, suffisants pour les premières exécutions ; après cela, vous payez par jeton sans frais d'abonnement.