Pular para o conteúdo principal
Última atualização em

Consultar com a APIde Mensagens Anthropic

importante

A API Anthropic Messages é compatível apenas com modelos básicos Anthropic pagos por token e modelos externos. Para uma API unificada que funciona em todos os provedores, use a API de Respostas Abertas ou a API de Conclusão de Chat.

A API Anthropic Messages oferece compatibilidade nativa com o SDK Anthropic para modelos Claude no Databricks. Use esta API quando precisar de um recurso específico Anthropicou estiver migrando código existente SDK Anthropic .

nota

Para restringir a saída do Claude a um esquema JSON com a Anthropic Messages API, use o campo format de output_config. Isso é suportado para databricks-claude-opus-5-5, databricks-claude-sonnet-5-5 e databricks-claude-haiku-5-5. Esses modelos e databricks-claude-fable-5-1 não suportam o parâmetro response_format da API de Conclusões de Chat, que retorna um erro HTTP 400. Para modelos compatíveis e restrições, consulte Saídas estruturadas no Databricks.

prompt

O Genie Code pode fazer isso por você. Experimente este exemplo de prompt:

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​

  • Consulte os Requisitos.
  • Instale o pacote anthropic em seu compute.

Exemplos de consulta​

nota

Os exemplos a seguir são baseados no Unity Gateway e nos serviços de modelo. Se você usar endpoints de servindo modelo em vez de serviços de modelo, substitua o nome do serviço de modelo pelo nome de um endpoint. Consulte Lista detalhada de modelos compatíveis com as APIs do Foundation Model do Databricks para ver uma lista dos modelos de fundação disponíveis e os nomes de seus serviços de modelo e Endpoint.

Os exemplos a seguir mostram como query um serviço de modelo Foundation Model API pay-per-token usando a Anthropic Messages API.

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)

Modelos suportados​

modelos de fundação hospedados no 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​

  • Fornecedor de modelo Anthropic
  • Fornecedor do modelo Anthropic básico

Tipos de entrada suportados​

Os modelos Anthropic Claude no Databricks aceitam entradas de texto e imagem. Consulte query de modelos de visão para obter os requisitos de tamanho e formato de imagem. Para ver os tipos de entrada por modelo, consulte Lista detalhada de modelos suportados pelas APIs do Foundation Model do Databricks.

Recursos adicionais​

Nesta página