Tutorial

API Claude Opus 5.5: guia rápido de curl e Python prontos para executar

Sep 29, 2026

O Claude Opus 5.5 é o mais recente modelo da Anthropic para programação com agentes e raciocínio em contextos longos, e a hiapi concluiu a integração no mesmo dia em que ele foi lançado na plataforma. Diferente dos modelos de imagem, vídeo e áudio da hiapi — que usam o padrão assíncrono POST /v1/tasks → polling —, o Claude Opus 5.5 é um modelo de conversa puramente textual, portanto basta enviar uma requisição síncrona para /v1/chat/completions para chamá-lo. Este guia traz uma chamada curl pronta para executar, a versão em Python da mesma chamada e os detalhes de produção que você precisa conhecer antes de entrar no ar (intensidade de raciocínio, saída em streaming, tratamento de erros).

Preparação

Uma conta hiapi e uma chave de API. Crie-a na página API Keys — todos os modelos hiapi, incluindo o Claude Opus 5.5, compartilham a mesma chave.
Nenhum SDK precisa ser instalado. O Claude Opus 5.5 usa o formato Chat Completions compatível com OpenAI da hiapi, então qualquer cliente HTTP (curl, requests, fetch) funciona imediatamente.

Requisição mínima funcional (curl)

curl -X POST "https://api.hiapi.ai/v1/chat/completions" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Give me three tips for reviewing a Python pull request." }
    ],
    "stream": false
  }'

O id do modelo é passado diretamente — não é necessário sufixo de roteamento nem prefixo identificador do provedor. Uma chamada bem-sucedida retorna o objeto padrão de chat completion:

{
  "id": "msg_...",
  "object": "chat.completion",
  "model": "claude-opus-5-5",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 42,
    "total_tokens": 55,
    "usage_semantic": "openai",
    "usage_source": "anthropic"
  }
}

Leia a resposta em choices[0].message.content — aqui não há output[0].url para consultar por polling, nem id de tarefa para acompanhar.

O mesmo fluxo em Python

import requests

response = requests.post(
    "https://api.hiapi.ai/v1/chat/completions",
    headers={
        "Authorization": "Bearer sk-YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "claude-opus-5-5",
        "messages": [
            {"role": "user", "content": "Give me three tips for reviewing a Python pull request."}
        ],
        "stream": False,
    },
)
response.raise_for_status()
data = response.json()
print(data["choices"][0]["message"]["content"])

Como esse endpoint usa o formato de transporte do OpenAI Chat Completions, a mesma estrutura de corpo de requisição pode ser usada como está em qualquer cliente HTTP de qualquer linguagem — além da URL base e da chave Bearer, não há nada específico da hiapi para aprender.

Intensidade de raciocínio, pensamento e saída em streaming

O pensamento estendido do Claude Opus 5.5 está sempre ativado — não é possível desativá-lo nem especificar manualmente um orçamento de tokens. O que você controla é quanto o modelo raciocina, por meio de output_config.effort:

{
  "model": "claude-opus-5-5",
  "messages": [{ "role": "user", "content": "..." }],
  "output_config": { "effort": "medium" }
}

effort aceita low, medium (o valor padrão quando o campo é omitido), high, xhigh ou max — passando gradualmente de respostas rápidas/baratas para respostas profundas e criteriosas. O message na resposta contém um array reasoning_details que guarda a trajetória interna de pensamento do modelo; para chamadas simples e pontuais, você pode ignorá-lo com segurança e ler apenas message.content.

Para respostas longas, defina "stream": true para obter saída incremental em vez de esperar a resposta completa:

curl -N https://api.hiapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5-5","messages":[{"role":"user","content":"..."}],"stream":true}'

Cada bloco de dados é uma linha data: {...}, no formato chat.completion.chunk, com o texto incremental em choices[0].delta.content. Continue lendo blocos até receber um bloco com finish_reason não vazio (normalmente "stop") — esse é o fim da resposta.

O Claude Opus 5.5 também oferece suporte a chamadas de ferramentas/funções, com janela de contexto de 1 milhão de tokens e saída de até 128 mil tokens, portanto é adequado para bases de código grandes ou tarefas com documentos longos, não apenas para perguntas e respostas curtas.

Considerações para produção

Erros de autenticação retornam 401, não 400. Quando a chave está ausente ou inválida, retorna:
```
{ "error": { "code": "permission_denied", "message": "This API key is invalid...", "type": "hiapi_error", "request_id": "..." } }
```
Verifique especificamente o HTTP 401 e informe o request_id caso precise contatar o suporte — para outras causas desse erro, consulte o guia completo de solução de problemas de chave de API inválida.
Não há opção de callback/Webhook aqui. Esse padrão se aplica aos modelos da hiapi baseados em tarefas assíncronas (imagem, vídeo, áudio); o Chat Completions só oferece requisição/resposta, portanto stream: true é sua única alternativa além de uma chamada bloqueante única.
Esta chamada é naturalmente idempotente — nenhum id de tarefa é criado acidentalmente em duplicidade, então repetir após um timeout é seguro desde que você aceite reexecutar o mesmo prompt.
Atenção aos limites de taxa, especialmente sob cargas de trabalho com alta concorrência; para estratégias de backoff, consulte como tratar erros de limite de taxa 429.
Os preços de tokens (tokens de entrada, saída e cache são cobrados separadamente) são atualizados continuamente na página do modelo Claude Opus 5.5 e na página de preços — não codifique valores fixos na sua lógica de cobrança, leia-os dessas páginas.

Leitura complementar

Página do modelo Claude Opus 5.5 — tabela completa de especificações e preços em tempo real
Guia da API Claude Sonnet 4.6 — uma opção Claude mais leve e rápida no mesmo formato Chat Completions
Criar um proxy compatível com OpenAI em Python — útil se você quiser encaminhar vários modelos de chat por trás de uma única API interna
Gerenciar suas chaves de API

Perguntas frequentes

A API Claude Opus 5.5 suporta saída em streaming? Sim — defina "stream": true e leia os blocos data: {...} como descrito acima.

É necessário uma chave de API para chamar o Claude Opus 5.5 em produção? Sim. Toda requisição deve incluir Authorization: Bearer sk-<your key>; a API de produção não oferece acesso sem chave ou anônimo.

Posso desativar o pensamento do Claude Opus 5.5 para economizar tokens? Não. O pensamento desse modelo está sempre ativado; a única coisa que você pode controlar é o nível de output_config.effort (de low a max), que equilibra velocidade/custo e profundidade.

O Claude Opus 5.5 é chamado via /v1/tasks como os modelos de imagem da hiapi? Não. Apenas os modelos de imagem, vídeo e áudio da hiapi usam o padrão de tarefa assíncrona com polling. O Claude Opus 5.5 é um modelo de texto, usa /v1/chat/completions e retorna a resposta na mesma resposta.

Quais são a janela de contexto e o comprimento máximo de saída? Contexto de 1 milhão de tokens, saída de até 128 mil tokens — suficiente para prompts de repositórios inteiros ou documentos longos.

O Claude Opus 5.5 suporta chamadas de ferramentas/funções? Sim, com suporte a saída em streaming e formato de mensagens compatível com OpenAI.