Interroger avec l’API Messages Anthropic

Important

L'API Anthropic Messages est uniquement compatible avec les modèles de base Anthropic à paiement par jeton et les modèles externes. Pour une API unifiée compatible avec plusieurs fournisseurs, utilisez l’API Open Responses ou l’API Chat Completions.

L’API Messages anthropices fournit une compatibilité native du SDK Anthropic pour les modèles Claude sur Azure Databricks. Utilisez cette API lorsque vous avez besoin de fonctionnalités spécifiques à Anthropic ou que vous migrez du code sdk anthropic existant.

Note

Pour contraindre la sortie Claude à un schéma JSON avec l’API Anthropic Messages, utilisez le format champ de output_config. Cela est supporté pour databricks-claude-opus-5-5, databricks-claude-sonnet-5-5, et databricks-claude-haiku-5-5. Ces modèles, et databricks-claude-fable-5-1, ne prennent pas en charge le response_format paramètre de l’API Chat Completions, qui renvoie une erreur HTTP 400 . Pour les modèles et contraintes pris en charge, voir Sorties structurées sur Azure Databricks.

Tip

Genie Code peut faire ça pour vous. Essayez cet exemple d’invite suivant :

Query the system.ai.claude-sonnet-4-5 model using the Anthropic Messages API with Bearer token auth and the workspace's anthropic base URL. Send a user message and print the response text.

Spécifications

  • Consultez Spécifications.
  • Installez le anthropic package sur votre calcul.

Exemples de requêtes

Note

Les exemples suivants sont basés sur Unity Gateway et les services modèles. Si vous utilisez des points de terminaison de service de modèle au lieu des services de modèle, remplacez le nom du service de modèle par un nom de point de terminaison. Voir la liste détaillée des modèles pris en charge par les API de modèles de fondation Databricks pour une liste des modèles de fondation disponibles ainsi que leurs noms de service de modèles et de points de terminaison.

Les exemples suivants montrent comment interroger un service de modèle à paiement par jeton de la Foundation Model API en utilisant l’API Anthropic Messages.

Python

import anthropic
import os

DATABRICKS_TOKEN = os.environ.get('DATABRICKS_TOKEN')

client = anthropic.Anthropic(
    api_key="unused",
    base_url="https://example.staging.cloud.databricks.com/ai-gateway/anthropic",
    default_headers={
        "Authorization": f"Bearer {DATABRICKS_TOKEN}",
    },
)

message = client.messages.create(
    model="system.ai.claude-sonnet-4-5",
    max_tokens=256,
    messages=[
        {"role": "user", "content": "What is a mixture of experts model?"},
    ],
)

print(message.content[0].text)

API REST

curl \
-u token:$DATABRICKS_TOKEN \
-X POST \
-H "Content-Type: application/json" \
-d '{
  "model": "system.ai.claude-sonnet-4-5",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "What is a mixture of experts model?"
    }
  ]
}' \
https://<workspace_host>.databricks.com/ai-gateway/anthropic/v1/messages

Modèles pris en charge

Modèles de base hébergés par Databricks

  • system.ai.claude-opus-5-5
  • system.ai.claude-fable-5-1
  • system.ai.claude-opus-5
  • system.ai.claude-sonnet-5-5
  • system.ai.claude-sonnet-5
  • system.ai.claude-opus-4-8
  • system.ai.claude-opus-4-7
  • system.ai.claude-opus-4-6
  • system.ai.claude-sonnet-4-6
  • system.ai.claude-sonnet-4-5
  • system.ai.claude-haiku-5-5
  • system.ai.claude-haiku-4-5
  • system.ai.claude-opus-4-5
  • system.ai.claude-opus-4-1

Modèles externes

  • Fournisseur de modèles anthropices
  • Fournisseur de modèles Bedrock Anthropic

Types d’entrée pris en charge

Les modèles Anthropic Claude sur Azure Databricks acceptent des entrées de texte et d'image. Consultez les modèles vision de requête pour connaître les exigences de format et de taille de l’image. Pour les types d’entrée par modèle, voir Liste détaillée des modèles pris en charge par les API de modèles de fondation Databricks.

Ressources supplémentaires

  • Dernière mise à jour :