Anthropic SDK

Le SDK officiel Anthropic permet d’appeler l’endpoint Anthropic Messages compatible d’AGTCloud avec une Base URL personnalisée. Ce tutoriel présente l’installation, les requêtes sans streaming et le streaming en Python et TypeScript.

Cette page couvre uniquement Messages. Consultez la Référence API AGTCloud pour la disponibilité des traitements par lots, des fichiers, des interfaces d’administration et des autres ressources Anthropic.

Prérequis

Avant de commencer, vérifiez que vous avez :

• Créé une API Key AGTCloud dans API Keys ;
• Copié dans le catalogue de modèles l’ID complet d’un modèle prenant en charge Anthropic Messages ;
• Préparé un environnement serveur Python 3.9+ ou Node.js 20+.

Cette page utilise MODEL_ID et your-api-key comme valeurs fictives. Ne conservez pas de véritable API Key dans un frontend de navigateur, un package mobile ou un dépôt public.

Installer le SDK

python -m pip install anthropic

Installez de préférence la version stable actuelle et figez la version utilisée dans le fichier de verrouillage des dépendances.

Configurer l’API Key

Enregistrez l’API Key dans une variable d’environnement côté serveur :

export AGTCLOUD_API_KEY="your-api-key"

Les exemples lisent les identifiants depuis AGTCLOUD_API_KEY et les transmettent explicitement au SDK Anthropic. Celui-ci les envoie via x-api-key et ajoute automatiquement le Header anthropic-version requis par Messages.

Créer le client et envoyer une requête

Utilisez l’API Origin affiché ici comme Base URL, sans ajouter /v1 ou /v1/messages. Le SDK ajoute le chemin Messages.

import os

from anthropic import Anthropic

api_key = os.environ["AGTCLOUD_API_KEY"]

client = Anthropic(
    api_key=api_key,
    base_url="https://api.agtcloud.cn",
)

message = client.messages.create(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Présentez-vous en trois phrases.",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Le content d’Anthropic Messages est un tableau de blocs. Vérifiez le type de chaque bloc pour lire le texte, sans supposer que la réponse contient toujours un seul bloc textuel. Les appels d’outils, les images et les autres contenus ont des structures différentes.

Réponse en streaming

import os

from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["AGTCLOUD_API_KEY"],
    base_url="https://api.agtcloud.cn",
)

with client.messages.stream(
    model="MODEL_ID",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Expliquez brièvement la recherche vectorielle.",
        }
    ],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Messages en streaming renvoie des événements SSE. En production, traitez également les interruptions de connexion, les délais, les limites de débit et les flux terminés avant réception d’un contenu complet.

Questions fréquentes

Étapes suivantes

• Consultez Anthropic Messages API Reference pour les Content Blocks, les appels d’outils, la réflexion étendue et tous les champs de réponse.
• Pour un projet utilisant un SDK officiel, suivez Migration depuis les SDK officiels pour remplacer les paramètres et effectuer les tests de régression.
• En cas d’échec, consultez Authentification et API Key et Erreurs et dépannage.