Aller au contenu
promptix

API compatible Anthropic

Utilisez Claude Code, les SDK Anthropic et tout client au format Anthropic avec Promptix : pointez-les vers https://promptix.tn/api et payez en TND.

En plus de l'endpoint chat completions compatible OpenAI, Promptix parle l'API Messages d'Anthropic. Tout ce qui est conçu pour Claude fonctionne sans modification : Claude Code, les SDK officiels Anthropic, Cursor, Cline, Zed, l'intégration Anthropic de LangChain et les clients HTTP classiques. Seuls l'URL de base et la clé changent, et la facture arrive en dinars.

POST/api/v1/messages

Claude Code

Claude Code ajoute lui-même /v1/messages à l'URL de base : pointez-le vers https://promptix.tn/api et donnez votre clé Promptix comme jeton d'authentification. Définissez les variables de modèle pour que les niveaux « sonnet », « opus » et « haiku » correspondent à des modèles du catalogue Promptix.

Shellbash
# Claude Code reads these from the environment (or ~/.claude/settings.json)export ANTHROPIC_BASE_URL="https://promptix.tn/api"export ANTHROPIC_AUTH_TOKEN="sk_your_promptix_key"export ANTHROPIC_API_KEY="" # Which Promptix model each Claude Code tier usesexport ANTHROPIC_MODEL="anthropic/claude-sonnet-5.5"export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-5.5"export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-5.5"export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5" claude

Pour conserver la configuration d'une session à l'autre, placez les mêmes variables dans ~/.claude/settings.json (ou le .claude/settings.json du projet) :

~/.claude/settings.jsonJSON
{  "env": {    "ANTHROPIC_BASE_URL": "https://promptix.tn/api",    "ANTHROPIC_AUTH_TOKEN": "sk_your_promptix_key",    "ANTHROPIC_API_KEY": "",    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-5.5",    "ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-5.5",    "ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-5.5",    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5"  }}

Coûts

Chaque tour de Claude Code apparaît dans votre journal d'utilisation avec ses tokens et son prix en TND. Fixez une limite mensuelle sur la clé donnée à Claude Code pour plafonner ce qu'une longue session peut dépenser.

SDK Anthropic

Avec les paquets officiels anthropic, définissez base_url / baseURL et la clé API. La clé est acceptée aussi bien en x-api-key (ce qu'envoient les SDK) qu'en Authorization: Bearer.

curl https://promptix.tn/api/v1/messages \  -H "x-api-key: $PROMPTIX_API_KEY" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "anthropic/claude-sonnet-5.5",    "max_tokens": 1024,    "messages": [{ "role": "user", "content": "Summarize the Tunisian startup act in three bullet points." }]  }'

Streaming

Passez stream: true, ou utilisez les helpers de streaming du SDK. Promptix transmet les événements server-sent d'Anthropic (message_start, content_block_delta, message_delta, message_stop) sans les modifier : text_stream et les événements d'appel d'outils fonctionnent comme documenté par Anthropic.

stream.pyPython
with client.messages.stream(    model="anthropic/claude-sonnet-5.5",    max_tokens=1024,    messages=[{"role": "user", "content": "Write a short poem about Djerba."}],) as stream:    for text in stream.text_stream:        print(text, end="", flush=True)

Modèles

Utilisez n'importe quel identifiant du catalogue, Claude ou non. Les modèles GPT, Gemini, Llama, Mistral et DeepSeek acceptent la même forme de requête : une session Claude Code ou une application basée sur le SDK Anthropic change de fournisseur en modifiant une seule chaîne :

Corps de la requêteJSON
{  "model": "openai/gpt-6-luna",  "max_tokens": 512,  "messages": [{ "role": "user", "content": "Hello from the Anthropic format!" }]}

Les fonctionnalités communes aux deux formats passent telles quelles : prompts système, images, appels d'outils, réflexion étendue (sur les modèles qui la prennent en charge) et cache de prompt avec des points d'arrêt cache_control. Les en-têtes anthropic-version et anthropic-beta sont transmis tels que vous les envoyez.

Facturation et erreurs

  • Les requêtes sont facturées comme toute requête Promptix : le prix du fournisseur converti en TND, prélevé sur votre solde, avec le détail complet dans le tableau de bord. Voir Facturation.
  • Les erreurs utilisent l'enveloppe d'Anthropic ({ "type": "error", "error": { "type", "message" } }) : authentication_error pour une clé invalide, billing_error (402) pour un solde vide ou une limite de clé, not_found_error pour un modèle inconnu, overloaded_error quand le fournisseur est saturé.
  • Clés, limites de débit et plafonds de dépense sont les mêmes que pour l'endpoint compatible OpenAI. Voir Authentification et Erreurs et limites.