Tutoriel de l'API Claude Sonnet 3.5 : Démarrer avec l'API d'Anthropic

Anthropic a récemment sorti Claude 3.5 Sonnet, un modèle puissant qui a surpassé GPT-4o et Gemini Pro 1.5 dans divers benchmarks.

Les capacités de raisonnement visuel de Claude 3.5 Sonnet sont particulièrement impressionnantes, et vous voudrez peut-être les utiliser dans votre processus de développement via l'API de Claude 3.5 Sonnet.

Dans cet article, je vais vous aider à démarrer avec l'API de Claude 3.5 Sonnet et vous fournir un guide étape par étape pour utiliser Claude 3.5 Sonnet à travers l'API d'Anthropic.

Si vous souhaitez avoir une vue d'ensemble de Claude 3.5 Sonnet, je vous recommande cet article sur Qu'est-ce que Claude 3.5 Sonnet ?.

Qu'est-ce que le sonnet Claude 3.5 ?

Claude 3.5 Sonnet est un grand modèle linguistique développé par Anthropic. Il fait partie de la grande famille Claude 3.5 - Athropic lancera Claude 3.5 Opus et Claude 3.5 Haiku plus tard dans l'année.

Claude 3.5 Sonnet démontre des améliorations notables dans la compréhension et la génération d'images et a montré de fortes performances dans les tests de référence, en particulier dans les tâches de codage et de raisonnement, par rapport à d'autres modèles comme GPT-4o, Gemini 1.5 Pro, ou Llama-400b.

En outre, il introduit une nouvelle fonctionnalité appelée Artifacts, qui permet d'améliorer la gestion des informations dans les conversations. Vous pouvez en savoir plus sur les artefacts dans cet article d'introduction sur Claude Sonnet 3.5.

Claude 3.5 API Sonnet : Comment se connecter à l'API d'Antrophic

Pour commencer à utiliser l'API Claude 3.5 Sonnet, vous devez ouvrir un compte API Anthropic et configurer le client Anthropic. Voyons cela étape par étape.

Obtenir l'accès à l'API

Étape 1 : S'inscrire

Visitez la Console anthropique et créez un compte. Vous devrez fournir des informations de base et vérifier votre adresse électronique.

Étape 2 : Clé API

Une fois que votre compte est configuré, naviguez vers Obtenir des clés API et cliquez sur Créer une clé pour générer votre clé API.

Mise en place de votre environnement

Pour initialiser le client Anthropic, vous devez d'abord installer la bibliothèque anthropic comme suit :

pip install anthropic

Une fois la bibliothèque installée, vous pouvez initialiser le client Anthropic en utilisant votre clé API.

import anthropic
# Create an instance of the Anthropics API client
client = anthropic.Anthropic(api_key='your_api_key_here')  

Avec la bibliothèque anthropic installée et votre client Anthropic initialisé avec votre API, commençons maintenant à explorer les capacités de Claude 3.5 Sonnet.

Claude API : Messages API vs. API sur les compléments de texte

Claude 3.5 L'API de Sonnet offre des fonctionnalités puissantes, en particulier son API Messages, qui est conçue pour créer des interactions riches et dynamiques.

Notez que l'API sur les complétions de texte est désormais considérée comme héritée. Bien qu'elle offre des capacités de complétion de base, elle ne dispose pas des fonctionnalités avancées et de la flexibilité de l'API Messages.

Les utilisateurs sont encouragés à migrer vers l'API Messages pour bénéficier d'une fonctionnalité améliorée et d'une assistance future.

Par ailleurs, les artefacts ne sont actuellement pas accessibles via l'API. Pour interagir avec les Artefacts, vous devez utiliser l'interface web fournie par Claude.aiqui permet d'éditer, de référencer et de télécharger le contenu généré par Claude 3.5 Sonnet.

Claude 3.5 API Sonnet : API Messages

L'API Messages vous permet d'envoyer une liste structurée de messages d'entrée avec un contenu texte ou image, permettant au modèle de générer le message suivant dans la conversation.

Cette API prend en charge à la fois les requêtes simples et les conversations multi-tours sans état.

Pour créer un message, vous pouvez utiliser la bibliothèque Python anthropic et appeler la méthode messages.create avec les paramètres requis. Les paramètres clés comprennent le modèle, les messages et divers paramètres optionnels pour contrôler la sortie.

Paramètres requis

Examinons les paramètres requis :

• model: Le modèle à utiliser (par exemple, "claude-3-5-sonnet-20240620").

• messages: Une liste de messages d'entrée. Chaque message doit avoir un rôle ("utilisateur" ou "assistant") et un contenu.

Au moment de la rédaction de cet article, ces modèles sont disponibles via l'API d'Anthropic :

Paramètres facultatifs

Les paramètres optionnels sont les suivants :

• max_tokens: Le nombre maximum de jetons à générer.
• temperature: Contrôle le caractère aléatoire de la réponse.
• stop_sequences: Séquences de texte personnalisées qui provoquent l'arrêt de la génération du modèle.
• stream: Indique si la réponse doit être diffusée de manière incrémentielle.
• system: Une invite du système fournissant un contexte et des instructions.
• tools: Définitions des outils que le modèle peut utiliser.
• top_k: Ne prélevez que les K premières options pour chaque jeton suivant. Utilisé pour supprimer les réponses à faible probabilité de la "longue traîne".
• top_p: Utilisez l'échantillonnage par noyau pour éliminer les options les moins probables en fonction d'une probabilité cumulative atteignant un seuil spécifié.

Claude 3.5 API Sonnet : Cas d'utilisation

Maintenant que nous comprenons tous les paramètres impliqués, explorons les cas d'utilisation pratiques de l'API Messages à l'aide de Python et de la bibliothèque anthropic:

Demande de message unique

C'est ainsi que nous pouvons faire une demande de message unique :

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, world"}]
)

Conversation à plusieurs voix

Entamons maintenant une conversation à plusieurs tours :

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=512,
    messages=[
        {"role": "user", "content": "Hello there."},
        {"role": "assistant", "content": "Hi, I'm Claude. How can I help you?"},
        {"role": "user", "content": "Can you explain LLMs in plain English?"}
    ]
)

Inclure le contenu des images

À partir des modèles Claude 3, vous pouvez inclure des images dans vos messages.

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=512,
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": "image/jpeg",
                        "data": "media_file"
                    }
                },
                {
                    "type": "text",
                    "text": "What is in this image?"
                }
            ]
        }
    ]
)

Utilisation des invites du système et des séquences d'arrêt

C'est ainsi que nous pouvons utiliser les invites du système et les séquences d'arrêt :

response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Write a short story."}],
    system="You are a creative writing assistant.",
    stop_sequences=["The end."],
    temperature=0.9
)

Définitions des outils

Vous pouvez définir les outils que le modèle doit utiliser lors des interactions. Il s'agit notamment de spécifier le nom de l'outil, sa description et son schéma d'entrée.

# Define the request parameters
model = "claude-3-5-sonnet-20240620"
messages = [{"role": "user", "content": "What's the S&P 500 at today?"}]
tools = [
    {
        "name": "get_stock_price",
        "description": "Get the current stock price for a given ticker symbol.",
        "input_schema": {
            "type": "object",
            "properties": {
                "ticker": {
                    "type": "string",
                    "description": "The stock ticker symbol, e.g., AAPL for Apple Inc."
                }
            },
            "required": ["ticker"]
        }
    }
]
# Create a message with the defined parameters
response = client.messages.create(
    model=model,
    messages=messages,
    tools=tools
)

Conclusion

Dans ce guide, nous avons exploré comment se connecter à l'API d'Anthropic afin d'utiliser le modèle Claude 3.5 Sonnet. Nous avons abordé des aspects clés tels que la configuration, l'authentification et l'utilisation de l'API Messages pour diverses tâches.

Que vous construisiez un chatbot, un générateur de contenu ou toute autre application basée sur l'IA, Claude 3.5 Sonnet pourrait être un bon choix.

Pour en savoir plus sur Claude Sonnet et sur sa comparaison avec ChatGPT, consultez les articles ci-dessous :

• Qu'est-ce que le sonnet Claude 3.5 ?
• Claude vs ChatGPT pour la science des données