Zapytania do interfejsu API Anthropic Messages

Ważne

Interfejs API Anthropic Messages jest zgodny tylko z modelami bazowymi Anthropic płacącymi za token oraz modelami zewnętrznymi. Aby skorzystać z ujednoliconego API działającego u różnych dostawców, użyj interfejsu Open Responses API lub Chat Completions API.

Interfejs API Anthropic Messages zapewnia natywną zgodność SDK Anthropic dla modeli Claude na platformie Azure Databricks. Użyj tego interfejsu API, gdy potrzebujesz funkcji specyficznych dla języka antropicznego lub migrujesz istniejący kod zestawu SDK antropicznego.

Note

Aby ograniczyć dane wyjściowe Claude'a do schematu JSON za pomocą interfejsu Anthropic Messages API, użyj pola formatoutput_config. Jest to obsługiwane dla databricks-claude-opus-5-5, databricks-claude-sonnet-5-5 oraz databricks-claude-haiku-5-5. Te modele oraz databricks-claude-fable-5-1 nie obsługują parametru response_format interfejsu Chat Completions API, co skutkuje błędem HTTP 400. Obsługiwane modele i ograniczenia można znaleźć w artykule Structured outputs on Azure Databricks.

Tip

Genie Code może to zrobić za Ciebie. Wypróbuj ten przykładowy monit:

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.

Wymagania

  • Zobacz Wymagania.
  • Zainstaluj pakiet anthropic na swoim komputerze.

Przykłady zapytań

Note

Poniższe przykłady opierają się na Unity Gateway i usługach modelowych. Jeśli używasz modelu obsługującego punkty końcowe zamiast usług modelu, zastąp nazwę usługi modelu nazwą punktu końcowego. Zobacz Szczegółową listę modeli obsługiwanych przez interfejsy API modeli bazowych Databricks, aby wyświetlić listę dostępnych modeli bazowych oraz nazwy usług modeli i punktów końcowych.

Poniższe przykłady pokazują, jak wysyłać zapytania do usługi modelu Foundation Model API pay-per-token za pomocą interfejsu 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)

interfejs 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

Obsługiwane modele

Modele bazowe hostowane przez 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

Modele zewnętrzne

  • Dostawca modelu antropotycznego
  • Dostawca modelu antropicznego Bedrock

Obsługiwane typy danych wejściowych

Anthropic Claude modele na Azure Databricks akceptują dane wejściowe tekstu i obrazu. Zobacz Modele przetwarzania obrazów zapytań , aby uzyskać informacje o wymaganiach dotyczących formatu i rozmiaru obrazu. Aby sprawdzić typy danych wejściowych dla poszczególnych modeli, zobacz Szczegółową listę modeli obsługiwanych przez interfejsy API Databricks Foundation Model.

Dodatkowe zasoby

  • Ostatnia aktualizacja o