Query avec l'Anthropic Messages API
L'Anthropic Messages API est uniquement compatible avec les modèles de fondation de paiement par jeton Anthropic et les modèles externes. Pour une API unifiée qui fonctionne sur tous les fournisseurs, utilisez l'API Open Responses ou l'API Chat Completions.
L'Anthropic Messages API offre une compatibilité SDK Anthropic native pour les modèles Claude sur Databricks. Utilisez cette API lorsque vous avez besoin de fonctionnalités spécifiques à Anthropic ou que vous migrez du code SDK Anthropic existant.
Pour contraindre la sortie de Claude à un schéma JSON avec l’Anthropic Messages API, utilisez le champ format de output_config. Cela est pris en charge pour databricks-claude-opus-5-5, databricks-claude-sonnet-5-5 et databricks-claude-haiku-5-5. Ces modèles, ainsi que databricks-claude-fable-5-1, ne prennent pas en charge le parameter response_format de l'API Chat Completions, qui renvoie une erreur HTTP 400. Pour les modèles pris en charge et les contraintes, voir Sorties structurées sur Databricks.
Genie Code peut faire cela pour vous. Essayez cet exemple d'invite :
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.
Exigences
- Consultez Exigences.
- Installez le package
anthropicsur votre compute.
Exemples de query
Les exemples suivants s’appuient sur Unity Gateway et les services de modèle. Si vous utilisez des Endpoint de mise en service de modèles au lieu de services de modèle, remplacez le nom du service de modèle par un nom d’Endpoint. Consultez la liste détaillée des modèles pris en charge par les APIs Foundation Model de Databricks pour connaître les modèles de fondation disponibles ainsi que les noms de leurs services de modèle et de leurs Endpoint.
Les exemples suivants montrent comment query un service de modèle de fondation à paiement par jeton à l’aide de l’Anthropic Messages API.
- Python
- REST API
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)
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 fondation hébergés par Databricks
system.ai.claude-opus-5-5system.ai.claude-fable-5-1system.ai.claude-opus-5system.ai.claude-sonnet-5-5system.ai.claude-sonnet-5system.ai.claude-opus-4-8system.ai.claude-opus-4-7system.ai.claude-opus-4-6system.ai.claude-sonnet-4-6system.ai.claude-sonnet-4-5system.ai.claude-haiku-5-5system.ai.claude-haiku-4-5system.ai.claude-opus-4-5system.ai.claude-opus-4-1
Modèles externes
- Fournisseur de modèles Anthropic
- Fournisseur de modèles Bedrock Anthropic
Types d'entrée pris en charge
Les modèles Claude 3.7 d’Anthropic sur Databricks acceptent les entrées de texte et d’image. Consultez Query vision models pour connaître les exigences relatives au format et à la taille des images. Pour connaître les types d’entrée par modèle, consultez la liste détaillée des modèles pris en charge par les APIs Databricks Foundation Model.