Eseguire query con l'API Anthropic Messages

Important

L'API Messaggi Anthropic è compatibile solo con i modelli a pagamento per token della fondazione Anthropic e con i modelli esterni. Per un'API unificata che funziona tra provider, usare l'API Open Responses o l'API Completamento chat.

L'API Messaggi Anthropic offre compatibilità nativa con l'SDK Anthropic per i modelli Claude su Azure Databricks. Usare questa API quando sono necessarie funzionalità specifiche di Anthropic o si esegue la migrazione del codice Anthropic SDK esistente.

Note

Per vincolare l'output di Claude a uno schema JSON con l'API Anthropic Messages, si utilizza il format campo di output_config. Questo è supportato per databricks-claude-opus-5-5, databricks-claude-sonnet-5-5, e databricks-claude-haiku-5-5. Questi modelli, e databricks-claude-fable-5-1, non supportano il response_format parametro dell'API Chat Completions, che restituisce un errore HTTP 400 . Per modelli e vincoli supportati, vedi Output strutturati su Azure Databricks.

Tip

Genie Code può farlo per te. Provare questo prompt di esempio:

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.

Requisiti

  • Vedere Requisiti.
  • Installare il anthropic pacchetto sul dispositivo di calcolo.

Esempi di query

Note

I seguenti esempi si basano su Unity Gateway e servizi modello. Se si usa il modello che gestisce gli endpoint anziché i servizi modello, sostituire il nome del servizio modello con un nome di endpoint. Vedi Elenco dettagliato dei modelli supportati dalle API dei modelli di fondazione Databricks per un elenco dei modelli di fondazione disponibili e i loro nomi di servizio modello e endpoint.

I seguenti esempi mostrano come interrogare un servizio modello pay-per-token dell'API Foundation Model utilizzando 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)

REST API

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

Modelli supportati

Modelli di base ospitati da 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

Modelli esterni

  • Fornitore di modelli antropici
  • Fornitore di modelli Bedrock Anthropic

Tipi di input supportati

Anthropic Claude modelli su Azure Databricks accettano input di testo e immagine. Vedere Eseguire query sui modelli di visione per i requisiti di formato e dimensioni delle immagini. Per i tipi di input per modello, vedi Elenco dettagliato dei modelli supportati dalle API dei modelli di fondazione di Databricks.

Risorse aggiuntive

  • Ultimo aggiornamento: