Pour un guide de migration plus direct vers le code, consultez notre guide de migration de référence de l’API.

Alors que nous continuons à améliorer et à étendre nos capacités d’IA, nous sommes ravis de présenter notre nouvelle API Messages, qui offre plusieurs avantages par rapport à notre ancienne API Text Completions.

Ce guide vous aidera à migrer vos applications existantes de l’API Text Completions vers l’API Messages, assurant une transition en douceur et déverrouillant l’accès à nos dernières fonctionnalités et améliorations.

​
Pourquoi passer à l’API Messages ?

L’API Messages offre plusieurs avantages clés :

  1. Traitement d’images : L’API Messages est le seul moyen de traiter des images avec Claude, vous permettant de tirer parti de nos capacités avancées de vision par ordinateur pour des tâches telles que la classification d’images, la détection d’objets, et plus encore.
  2. Construire avec les modèles Claude 3 : Nos derniers et plus puissants modèles Claude 3 (Haiku, Sonnet et Opus) ne peuvent être appelés que via l’API Messages. En mettant à niveau, vous pourrez profiter de leurs performances et capacités améliorées.
  3. Gestion des erreurs améliorée : L’API Messages nous permet de renvoyer des messages d’erreur plus informatifs et utiles, ce qui vous permet de diagnostiquer et de résoudre plus facilement les problèmes dans vos requêtes.
  4. Meilleure validation des requêtes : Avec l’API Messages, nous pouvons valider vos requêtes d’API plus efficacement, en veillant à ce que vous receviez les résultats de la plus haute qualité et les meilleures performances possibles de nos modèles.

​
Comment passer à l’API Messages

La façon la plus simple de passer de l’API Text Completions à l’API Messages est d’utiliser notre Console web pour convertir vos prompts. En utilisant la Console, vous pouvez rapidement et facilement migrer vos prompts et requêtes vers l’API Messages sans avoir à réécrire manuellement votre code.

Il vous suffit de suivre ces étapes :

​
1. Accédez à la Console et sélectionnez le modèle que vous souhaitez utiliser

Dans la Console, il y a un panneau de paramètres de modèle en bas à droite de la zone de messages. Ce panneau contient un menu déroulant où vous pouvez sélectionner le modèle approprié pour votre prompt migré.

C’est également là que vous pouvez ajuster tous les paramètres supplémentaires si nécessaire, tels que la température et le nombre maximum de tokens à échantillonner. Pour plus d’informations sur nos paramètres, consultez la documentation de l’API Messages.

​
2. Transférez votre prompt dans les champs de message appropriés de la Console

Les prompts de l’API Text Completions sont des chaînes multiligne qui englobent toutes les parties d’un prompt, comme le prompt système et le tour de l’utilisateur. L’API Messages divise les différentes parties d’un prompt, comme le prompt système et le tour de l’utilisateur, en champs séparés.

Par exemple, prenons ce prompt de l’API Text Completions :

Text
Aujourd'hui, nous sommes le 4 mars 2024.

H: Quelles sont les 3 façons de cuisiner des pommes ?

A:

Sans utiliser la Console, la transition de ce prompt nécessiterait de réécrire entièrement votre code dans l’API Messages. Cependant, en déposant les différentes parties de votre prompt (prompt système et prompt utilisateur) dans les champs correspondants de la Console, vous pouvez extraire du code pré-formaté correct prêt à l’emploi.

Dans la Console, le prompt ci-dessus ressemblerait à ceci :

Notez qu’il n’y a pas de texte Human: ou Assistant:, et que le prompt système et le prompt utilisateur appartiennent à des champs de message différents.

​
3. Copiez le code pré-formaté

Une fois que toutes les parties de votre prompt sont en place et que les paramètres ont été ajustés, cliquez sur le bouton </> Get Code en haut à droite pour afficher et copier l’extrait de code correspondant de l’API Messages, pour Python et TypeScript.

Pour notre exemple de prompt, la sortie Python automatisée du menu </> Get Code serait :

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Aujourd'hui, nous sommes le 4 mars 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Quelles sont les 3 façons de cuisiner des pommes ?"
                }
            ]
        }
    ]
)
print(message.content)

Remarque : La Console ne permet pas encore de pré-remplir la réponse de Claude (c’est-à-dire pré-remplir du texte dans le tour Assistant), mais l’API Messages sous-jacente le permet. Consultez notre guide sur le pré-remplissage de la réponse de Claude pour des exemples sur la façon de formater une requête d’API Messages avec cette technique.

​
Migration depuis d’autres modèles

Si vous utilisez actuellement une autre plateforme ou un autre modèle d’IA et que vous souhaitez passer à Claude avec l’API Messages, nous avons créé un guide complet pour vous aider dans ce processus. Consultez la migration depuis d’autres modèles pour obtenir des instructions détaillées sur la façon d’adapter vos prompts et votre code à notre plateforme.

​
Documentation de l’API

Pour plus d’informations sur l’API Messages et ses capacités, veuillez consulter notre documentation d’API :

Si vous avez des questions ou avez besoin d’une assistance supplémentaire pour passer à l’API Messages, n’hésitez pas à contacter notre équipe d’assistance. Nous sommes là pour vous aider à tirer le meilleur parti de nos capacités d’IA et à assurer une transition en douceur vers Claude.

Migration depuis d'autres modèlesAperçu