Migrar da Anthropic
Converta Messages, autenticação, respostas, streaming e ferramentas para Chat Completions.
Atualizado em 09 de ago. de 2026
A Anthropic Messages API e a HINOW Chat Completions usam contratos diferentes. A migração recomendada é trocar o cliente anthropic pelo cliente openai configurado com a base HINOW, ou chamar diretamente https://api.hinow.ai/v1/chat/completions.
Não é apenas trocar a URL
Autenticação, system prompt, estrutura de ferramentas, blocos de conteúdo, streaming e formato da resposta precisam ser convertidos.
| Anthropic Messages | HINOW Chat Completions |
|---|---|
x-api-key e anthropic-version | Authorization: Bearer $HINOW_API_KEY |
POST https://api.anthropic.com/v1/messages | POST https://api.hinow.ai/v1/chat/completions |
system: "..." no topo | messages[0] com role: "system" |
model da Anthropic | hinow/himax, hinow/hinova ou hinow/higenesis |
response.content[0].text | response.choices[0].message.content |
stop_reason | finish_reason |
usage.input_tokens | usage.prompt_tokens |
usage.output_tokens | usage.completion_tokens |
from anthropic import Anthropic
import os
client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
resposta = client.messages.create(
model="SEU_MODELO_ANTHROPIC",
max_tokens=500,
system="Responda com objetividade.",
messages=[{"role": "user", "content": "Resuma este texto."}],
)
print(resposta.content[0].text)from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["HINOW_API_KEY"],
base_url="https://api.hinow.ai/v1",
)
resposta = client.chat.completions.create(
model="hinow/hinova",
max_tokens=500,
messages=[
{"role": "system", "content": "Responda com objetividade."},
{"role": "user", "content": "Resuma este texto."},
],
)
print(resposta.choices[0].message.content)| Anthropic | HINOW |
|---|---|
tools[].name e tools[].input_schema | tools[].function.name e tools[].function.parameters |
Bloco de resposta tool_use | message.tool_calls[] |
Bloco de entrada tool_result | Mensagem com role: "tool" e tool_call_id |
| Argumentos em objeto | function.arguments em JSON serializado; faça parse e valide |
Não reutilize o parser de eventos da Anthropic. Na HINOW, leia os chunks de Chat Completions e acumule choices[0].delta.content; chamadas de função chegam em deltas próprios.
Para imagens, converta os blocos source da Anthropic para o formato image_url documentado pela HINOW e escolha um modelo cuja modalidade visual esteja publicada em Listar modelos.
- Troque o pacote e a variável de ambiente da chave.
- Converta o system prompt em uma mensagem
system. - Atualize modelo, chamada e leitura da resposta.
- Reescreva o parser de streaming.
- Converta ferramentas e valide todos os argumentos antes de executar.
- Revise imagens e outros blocos de conteúdo.
- Execute testes de comportamento, erros e custo antes de liberar.
Referências do formato de origem: Anthropic Messages API e SDKs da Anthropic.
Valide a integração HINOW
Use a referência técnica e os modelos públicos como contrato do novo código.