Format Anthropic

CloudZIR expose une seconde surface au format Anthropic Messages. Le SDK anthropic, Claude Code et tous les outils écrits pour ce format fonctionnent sans modification : seule l'URL de base change.

Configuration#

# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    api_key="zir_ai_...",
    base_url="https://api.cloudzir.com/anthropic",
)

message = client.messages.create(
    model="mina-full",
    max_tokens=1024,
    system="Tu es un assistant utile, en français.",
    messages=[{"role": "user", "content": "Explique la différence entre TCP et UDP."}],
)

print(message.content[0].text)
print(message.usage.input_tokens, message.usage.output_tokens)

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.CLOUDZIR_API_KEY,
  baseURL: "https://api.cloudzir.com/anthropic",
});

const message = await client.messages.create({
  model: "mina-full",
  max_tokens: 1024,
  system: "Tu es un assistant utile, en français.",
  messages: [{ role: "user", content: "Explique la différence entre TCP et UDP." }],
});

console.log(message.content[0].text);

curl https://api.cloudzir.com/anthropic/v1/messages \
  -H "x-api-key: $CLOUDZIR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "mina-full",
    "max_tokens": 1024,
    "system": "Tu es un assistant utile, en français.",
    "messages": [{"role": "user", "content": "Explique la différence entre TCP et UDP."}]
  }'

Modèles Mina disponibles#

Choisissez un identifiant Mina : mina-flash, mina-low ou mina-full. La liste des modèles activés pour votre clé est renvoyée par GET /anthropic/v1/models.

Champs supportés#

Outils#

message = client.messages.create(
    model="mina-full",
    max_tokens=1024,
    tools=[{
        "name": "stock_produit",
        "description": "Stock disponible d'un produit.",
        "input_schema": {
            "type": "object",
            "properties": {"reference": {"type": "string"}},
            "required": ["reference"],
        },
    }],
    messages=[{"role": "user", "content": "Reste-t-il des DEMO-001 ?"}],
)

if message.stop_reason == "tool_use":
    bloc = next(b for b in message.content if b.type == "tool_use")
    resultat = stock_produit(**bloc.input)
    suite = client.messages.create(
        model="mina-full",
        max_tokens=1024,
        messages=[
            {"role": "user", "content": "Reste-t-il des DEMO-001 ?"},
            {"role": "assistant", "content": message.content},
            {"role": "user", "content": [{
                "type": "tool_result",
                "tool_use_id": bloc.id,
                "content": str(resultat),
            }]},
        ],
    )

Streaming#

La séquence d'événements suit la spécification Anthropic :

event: message_start        → enveloppe du message (id, modèle, usage initial)
event: content_block_start  → début d'un bloc (text ou tool_use)
event: content_block_delta  → text_delta / input_json_delta
event: content_block_stop   → fin du bloc
event: message_delta        → stop_reason + usage.output_tokens
event: message_stop         → fin
event: ping                 → maintien de connexion pendant l'attente

with client.messages.stream(
    model="mina-low",
    max_tokens=512,
    messages=[{"role": "user", "content": "Compte de 1 à 10."}],
) as flux:
    for texte in flux.text_stream:
        print(texte, end="", flush=True)

Erreurs#

Le format d'erreur est celui d'Anthropic :

{"type": "error", "error": {"type": "rate_limit_error", "message": "Limite de débit atteinte…"}}

Correspondance complète : Codes d'erreur. Les types renvoyés sont invalid_request_error, authentication_error, permission_error, not_found_error, rate_limit_error, api_error, overloaded_error.

Quelle surface choisir ?#

Les deux surfaces partagent la même clé, le même portefeuille, les mêmes tarifs et les mêmes limites.