Abfrage mit der Anthropic Messages-API

Von Bedeutung

Die Anthropic Messages-API ist nur mit Anthropic Pay per Token Foundation-Modellen und externen Modellen kompatibel. Verwenden Sie für eine einheitliche API, die anbieterübergreifend funktioniert, die Api für offene Antworten oder die Chatabschluss-API.

Die Anthropic Messages-API bietet native Anthropic SDK-Kompatibilität für Claude-Modelle auf Azure Databricks. Verwenden Sie diese API, wenn Sie anthropic-spezifische Features benötigen oder vorhandene Anthropic SDK-Code migrieren.

Notiz

Um die Claude-Ausgabe mit der Anthropic Messages API auf ein JSON-Schema zu beschränken, verwendet man das format Feld von output_config. Dies wird für databricks-claude-opus-5-5, databricks-claude-sonnet-5-5, und databricks-claude-haiku-5-5unterstützt. Diese Modelle und databricks-claude-fable-5-1 unterstützen den response_format-Parameter der Chat Completions API nicht; bei seiner Verwendung wird ein HTTP-Fehler 400 zurückgegeben. Für unterstützte Modelle und Einschränkungen siehe Strukturierte Ausgaben auf Azure Databricks.

Tip

Genie Code kann das für dich übernehmen. Probieren Sie diese Beispielaufforderung aus:

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.

Anforderungen

  • Siehe Anforderungen.
  • Installieren Sie das anthropic Paket auf Ihrem Computer.

Abfragebeispiele

Notiz

Die folgenden Beispiele basieren auf Unity Gateway und Modelldiensten. Wenn Sie anstelle von Modelldiensten Endpunkte für die Modellbereitstellung verwenden, ersetzen Sie den Modelldienstnamen durch einen Endpunktnamen. Siehe Detaillierte Liste der von Databricks Foundation Model APIs unterstützten Modelle für eine Liste verfügbarer Foundation-Modelle sowie deren Modell-Service- und Endpunktnamen.

Die folgenden Beispiele zeigen, wie man einen Foundation Model API Pay-per-Token-Modelldienst mit der Anthropic Messages API abfragen kann.

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

Unterstützte Modelle

Von Databricks gehostete Foundation-Modelle

  • system.ai.claude-fable-5-2
  • 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

Externe Modelle

  • Anbieter anthropischer Modelle
  • Bedrock Anthropic-Modellanbieter

Unterstützte Eingabetypen

Anthropic Claude-Modelle auf Azure Databricks können Text- und Bildeingaben akzeptieren. Siehe Abfrage-Vision-Modelle für Bildformat- und Größenanforderungen. Für Eingabetypen pro Modell siehe Detaillierte Liste der von Databricks Foundation Model APIs unterstützten Modelle.

Weitere Ressourcen