Blog

CArouter parle maintenant l'API Messages d'Anthropic

Les applications construites sur un SDK d'Anthropic, et les agents de programmation comme Claude Code, atteignent désormais les modèles de notre catalogue en changeant une seule adresse. La clé, les protections et la facture restent les mêmes.

ProduitPar Flavien BerwickTraduit de l'anglais par une IA.
Nouvelle fonctionnalité : CArouter parle maintenant l'API Messages d'Anthropic, à POST /v1/messages. Une application sur un SDK d'Anthropic change son URL de base, Claude Code change ANTHROPIC_BASE_URL dans ses réglages, et un modèle du catalogue répond. Les prompts, les outils et le code de streaming ne changent pas. Même clé et même facture, mêmes règles de résidence, mêmes outils de confidentialité.

Une application d'IA s'écrit pour l'une de deux interfaces : celle d'OpenAI, que CArouter parle depuis son premier jour, ou l'API Messages d'Anthropic. Une équipe qui avait choisi la seconde devait réécrire ses appels pour nous utiliser. Un outil qui ne parle que celle-là, comme l'agent de programmation Claude Code, ne pouvait pas nous joindre du tout. CArouter répond maintenant aussi à l'API Messages, à l'adresse /v1/messages.

Les modèles qui répondent sont ceux de notre catalogue, servis par des fournisseurs de propriété canadienne à moins que vous n'en décidiez autrement. Cette route n'ajoute pas les modèles Claude. Elle permet aux outils écrits pour eux de fonctionner avec les nôtres.

Une application sur un SDK d'Anthropic se déplace en changeant deux lignes

Si votre application utilise l'un des SDK d'Anthropic, donnez-lui l'adresse de CArouter et une clé CArouter. Les messages, l'invite système, vos propres outils, la réponse diffusée en continu et les erreurs gardent la forme que votre code sait déjà traiter.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://carouter.ai",      # was Anthropic's address
    api_key="$CAROUTER_API_KEY",         # was an Anthropic key
)

message = client.messages.create(
    model="<a chat model from carouter.ai/docs>",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Bonjour!"}],
)
print(message.content[0].text)

C'est utile quand une application déjà en production doit tourner sur un modèle hébergé au Canada, pour un client, un organisme de réglementation ou un projet pilote. L'essai prend un après-midi au lieu d'une réécriture, et le même code continue de fonctionner des deux côtés.

Avant la mise en service, nous avons fait passer le SDK Python officiel d'Anthropic par cette route : une réponse simple, une réponse diffusée en continu, un appel d'outil suivi de son résultat, un décompte de tokens et les erreurs typées du SDK.

Un agent de programmation qui suit vos règles de résidence

Un agent de programmation lit vos fichiers source, votre configuration et parfois vos secrets, puis les envoie à un modèle à chaque étape. Pour une équipe soumise à une exigence de résidence des données, c'est souvent la raison pour laquelle l'agent est tout simplement interdit.

Claude Code accepte une autre adresse dans son fichier de réglages, et cette adresse peut maintenant être celle de CArouter. L'agent tourne toujours sur votre machine, et ce qu'il lit part vers un modèle de notre catalogue, selon les règles de résidence de votre espace de travail. Tant que vous ne les changez pas, elles n'admettent que des fournisseurs de propriété canadienne.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://carouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "<your CArouter key>",
    "ANTHROPIC_MODEL": "<a model that calls tools>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<the same, or a smaller one>"
  }
}

L'onglet Claude Code de notre documentation écrit ce bloc pour votre espace de travail, avec un modèle que vos clés peuvent atteindre et sa vraie fenêtre de contexte, que Claude Code devrait sinon deviner.

Deux choses à savoir avant de vous y fier :

  • Claude Code est écrit pour les modèles Claude, et Anthropic n'offre aucun soutien pour son utilisation avec d'autres. La qualité d'une session dépend du modèle : choisissez-en un qui appelle les outils de façon fiable, et essayez-le d'abord sur votre propre travail. Lors de notre essai avant la mise en service, Claude Code a lu un fichier avec son propre outil et a répondu à partir de son contenu en passant par cette route.
  • Les outils qu'Anthropic exécute sur ses propres serveurs, dont la recherche web, ne sont pas offerts chez nous. Ceux qui s'exécutent sur votre machine, comme la lecture et la modification de fichiers ou l'exécution de commandes, sont transmis au modèle comme n'importe lequel de vos propres outils.

Tout autre outil qui vous laisse indiquer l'adresse d'une API compatible avec celle d'Anthropic peut être dirigé vers CArouter de la même façon, dans les limites décrites plus bas.

Les mêmes protections et la même facture

Une requête qui arrive au format d'Anthropic est traduite dans celui que le reste de CArouter utilise avant que quoi que ce soit d'autre la lise. Tout ce que vous avez déjà réglé s'applique donc, sans rien configurer une seconde fois :

  • Résidence des données : vos autorisations de fournisseurs et vos règles de passage à l'étranger décident de qui peut répondre, comme sur toutes les autres routes.
  • Outils de confidentialité : le filtre de renseignements personnels et le filtre de contenu activés sur une clé API lisent aussi ces requêtes. Une clé qui exige un filtre est toujours refusée quand ce filtre n'est pas disponible.
  • Une clé, une facture : votre clé API actuelle fonctionne, envoyée comme les outils d'Anthropic l'envoient. Chaque requête apparaît dans la page Utilisation sous le nom Messages, avec son coût.
  • Fiabilité : une requête passe à un autre fournisseur quand le premier fait défaut, comme sur la route de chat. Pendant qu'un modèle prépare une longue réponse, la route envoie le signal de maintien que les outils d'Anthropic attendent, pour qu'ils ne coupent pas la connexion.

Ce que la route ne fait pas

  • Les budgets de réflexion et les réglages d'effort sont acceptés, mais ne sont pas transmis. Chaque modèle raisonne selon ses propres réglages par défaut, et son raisonnement revient sous la forme que les outils d'Anthropic savent lire.
  • Refusés, avec un message qui dit pourquoi : les outils qu'Anthropic définit ou exécute elle-même (recherche web, exécution de code, utilisation de l'ordinateur), son connecteur MCP, les documents PDF et les fichiers téléversés chez Anthropic.
  • Les lots de messages et le téléversement de fichiers n'ont pas de route chez nous.

Ouvrir la documentation et son onglet Claude Code. Lire la référence technique de la route.