Compatibilidade com SDK OpenAI (beta)

​

Antes de começar

Esta camada de compatibilidade destina-se a testar e comparar as capacidades do modelo com esforço mínimo de desenvolvimento e não é considerada uma solução de longo prazo ou pronta para produção para a maioria dos casos de uso. Para a melhor experiência e acesso ao conjunto completo de recursos da API Anthropic (processamento de PDF, citações, pensamento estendido e cache de prompts), recomendamos usar a API Anthropic nativa.

​

Começando com o SDK OpenAI

Para usar o recurso de compatibilidade do SDK OpenAI, você precisará:

1. Usar um SDK OpenAI oficial
2. Alterar o seguinte
   • Atualizar sua URL base para apontar para a API da Anthropic
   • Substituir sua chave de API por uma chave de API Anthropic
   • Atualizar o nome do seu modelo para usar um modelo Claude
3. Revisar a documentação abaixo para saber quais recursos são suportados

​

Exemplo de início rápido

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # Sua chave de API Anthropic
    base_url="https://api.anthropic.com/v1/"  # Endpoint da API Anthropic
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Nome do modelo Anthropic
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"}
    ],
)

print(response.choices[0].message.content)

​

Limitações importantes de compatibilidade com OpenAI

​

Comportamento da API

Aqui estão as diferenças mais substanciais em relação ao uso da OpenAI:

• O parâmetro strict para chamada de função é ignorado, o que significa que o JSON de uso da ferramenta não é garantido que siga o esquema fornecido.
• A entrada de áudio não é suportada; ela será simplesmente ignorada e removida da entrada
• O cache de prompts não é suportado, mas é suportado no SDK da Anthropic
• Mensagens de sistema/desenvolvedor são elevadas e concatenadas no início da conversa, já que a Anthropic suporta apenas uma única mensagem de sistema inicial.

A maioria dos campos não suportados são silenciosamente ignorados em vez de produzir erros. Todos estes estão documentados abaixo.

​

Considerações sobre qualidade de saída

Se você fez muitos ajustes em seu prompt, é provável que ele esteja bem ajustado especificamente para a OpenAI. Considere usar nosso aprimorador de prompts no Console Anthropic como um bom ponto de partida.

​

Elevação de mensagens de sistema / desenvolvedor

A maioria das entradas para o SDK OpenAI mapeia diretamente para os parâmetros da API da Anthropic, mas uma diferença distinta é o tratamento de prompts de sistema / desenvolvedor. Esses dois prompts podem ser colocados ao longo de uma conversa de chat via OpenAI. Como a Anthropic suporta apenas uma mensagem de sistema inicial, pegamos todas as mensagens de sistema/desenvolvedor e as concatenamos com uma única quebra de linha (\n) entre elas. Essa string completa é então fornecida como uma única mensagem de sistema no início das mensagens.

​

Suporte a pensamento estendido

Você pode habilitar recursos de pensamento estendido adicionando o parâmetro thinking. Embora isso melhore o raciocínio do Claude para tarefas complexas, o SDK OpenAI não retornará o processo de pensamento detalhado do Claude. Para recursos completos de pensamento estendido, incluindo acesso ao resultado do raciocínio passo a passo do Claude, use a API Anthropic nativa.

response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​

Limites de taxa

Os limites de taxa seguem os limites padrão da Anthropic para o endpoint /v1/messages.

​

Suporte detalhado à API compatível com OpenAI

​

Campos de solicitação

​

Campos simples

​

Campos tools / functions

​

Campos do array messages

​

Campos de resposta

​

Compatibilidade de mensagens de erro

A camada de compatibilidade mantém formatos de erro consistentes com a API OpenAI. No entanto, as mensagens de erro detalhadas não serão equivalentes. Recomendamos usar as mensagens de erro apenas para registro e depuração.

​

Compatibilidade de cabeçalho

Embora o SDK OpenAI gerencie automaticamente os cabeçalhos, aqui está a lista completa de cabeçalhos suportados pela API da Anthropic para desenvolvedores que precisam trabalhar diretamente com eles.