Consulta con el Anthropic Messages API

Important

La API de Mensajes de Anthropic solo es compatible con los modelos fundacionales de pago por token de Anthropic y con modelos externos. Para una API unificada que funcione entre proveedores, use open Responses API o la API de finalizaciones de chat.

La API de mensajes antrópicos proporciona compatibilidad nativa del SDK antrópico para los modelos de Claude en Azure Databricks. Utilice esta API cuando necesite características específicas de Anthropic o cuando migre el código del SDK Anthropic existente.

Nota

Para restringir la salida de Claude a un esquema JSON con la API Anthropic Messages, utilice el format campo de output_config. Esto está soportado para databricks-claude-opus-5-5, databricks-claude-sonnet-5-5, y databricks-claude-haiku-5-5. Estos modelos, y databricks-claude-fable-5-1, no admiten el parámetro response_format de la API Chat Completions, que devuelve un error HTTP 400. Para modelos y restricciones soportados, consulte Salidas estructuradas en Azure Databricks.

Tip

Genie Code puede hacer esto por ti. Pruebe esta indicación de ejemplo:

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.

Requisitos

  • Vea Requisitos.
  • Instale el paquete anthropic en su computadora.

Ejemplos de consultas

Nota

Los siguientes ejemplos se basan en Unity Gateway y servicios modelo. Si utiliza puntos de conexión de servicio de modelos en lugar de servicios de modelos, sustituya el nombre del servicio de modelo por el nombre de un punto de conexión. Consulte la lista detallada de modelos compatibles con las APIs de modelos fundacionales de Databricks para ver una lista de los modelos fundacionales disponibles y los nombres de sus servicios de modelos y puntos de conexión.

Los ejemplos siguientes muestran cómo consultar un servicio de modelo de pago por token de la API de Foundation Model mediante la API de 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

Modelos compatibles

Modelos de base hospedados en 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

Modelos externos

  • Proveedor de modelos antropológicos
  • Proveedor de modelos Bedrock Anthropic

Tipos de entrada admitidos

Modelos Anthropic Claude de Azure Databricks aceptan entradas de texto e imagen. Consulte los modelos de visión de consulta para conocer los requisitos de formato y tamaño de imagen. Para tipos de entrada por modelo, véase Lista detallada de modelos soportados por las APIs de modelos de Fundación de Databricks.

Recursos adicionales

  • Última actualización el