Nota do autor: este artigo foi elaborado com base na documentação oficial da Anthropic de 2026-11-08 (UTC+8) e no guia de parâmetros de raciocínio do Claude da APIYI (apiyi.com), atualizado em 2026-11-09 às 10:40. A verificação dos critérios foi feita em 2026-11-13, para ajudar você a evitar o erro 400 nos parâmetros thinking do claude-opus-5-5 e do claude-sonnet-5-5.
Se você passar disabled no type do thinking no claude-opus-5-5, a API retorna direto um erro 400 — esse é o critério explicitado na documentação oficial da Anthropic de 2026-11-08 (UTC+8). A APIYI (apiyi.com) já atualizou, em 2026-11-09 às 10:40, o guia de parâmetros de raciocínio do Claude, deixando claro o jeito certo de escrever os IDs dos dois modelos. Este artigo faz uma leitura rápida do impacto dessa mudança para quem chama a API do Claude.
Não é boato: as duas conclusões principais se apoiam na documentação — o claude-opus-5-5 não permite desligar o raciocínio, só reduzir o effort; já no claude-sonnet-5-5, para desligar o raciocínio prévio é preciso usar between_tools.
Valor central: em 3 minutos você entende a forma correta de escrever os dois IDs de modelo, os limites do parâmetro between_tools e como investigar o erro 400.
Visão rápida das informações principais: os critérios de thinking do claude-opus-5-5 e do claude-sonnet-5-5
Primeiro a tabela de conclusões, depois destrinchamos item por item:
| Item | Detalhes |
|---|---|
| Fonte oficial | Documentação oficial da Anthropic, 2026-11-08 (UTC+8) |
| Atualização do guia APIYI | 2026-11-09 10:40, docs.apiyi.com já sincronizado |
| claude-opus-5-5 | Sem passar thinking → pensamento adaptativo; passar disabled retorna 400 |
| claude-sonnet-5-5 | Sem passar thinking também é pensamento adaptativo; para desligar o pensamento prévio, use between_tools |
Valor padrão de effort |
Opus 5.5 é medium, Sonnet 5.5 é high |
| Saída máxima | Ambos os IDs de modelo são 128000, e os tokens de pensamento entram nessa conta |
O critério do claude-opus-5-5 é bem direto. Quando o campo thinking não vai na requisição, o modelo entra em pensamento adaptativo e decide sozinho se pensa naquela chamada e até que profundidade; já se o type de thinking for definido como disabled, a API não ignora silenciosamente — ela retorna 400 na hora. Em outras palavras, esse ID de modelo não tem um interruptor para desligar o pensamento, e o único meio de ajuste previsto na documentação é baixar o effort, cujo nível padrão é medium.
A situação do claude-sonnet-5-5 é um pouco diferente. Ele também suporta o pensamento adaptativo quando thinking não é enviado, mas tem um caminho extra, oficialmente reconhecido, para desligá-lo: definir o type como between_tools, o que desativa o pensamento prévio e mantém apenas as atualizações de progresso entre chamadas de ferramenta. Os limites desse caminho também estão bem documentados — vale conferir a tabela abaixo:
| Item de restrição | O que diz a documentação |
|---|---|
Valores de effort |
Aceita apenas low, medium, high |
| Teto do nível | Não pode ser superior a high |
| Restrição de combinação | Não pode vir junto com display nem com budget_tokens |
| Efeito real | Desliga o pensamento prévio e mantém somente as atualizações de progresso entre chamadas de ferramenta |
Tem ainda um detalhe que costuma passar batido: os tokens de pensamento contam dentro de max_tokens. A saída máxima dos dois IDs de modelo é 128000, então, se a requisição definir um max_tokens muito baixo, o pensamento pode consumir boa parte do orçamento primeiro e o texto final acaba truncado. Ao investigar aquele “respostas que encurtaram do nada”, vale a pena checar antes quanto o pensamento está ocupando.
Nota da ilustração: a cadeia de chamadas mostrada no diagrama usa como exemplo o gateway de formato nativo Anthropic do APIYI apiyi.com. Ao usar o formato Anthropic, o endereço base é https://api.apiyi.com — atenção para não escrevê-lo na forma com /v1.
Análise de impacto: o erro 400 de disabled afeta quais integrações
Essa mudança de regra afeta quem chama a API principalmente em três pontos: tratamento de erros, combinação de parâmetros e planejamento de orçamento. Ver cada ponto separadamente deixa tudo mais claro.
Impacto no código existente: migração do uso de disabled
| Cenário | Sintaxe antiga | Resultado agora | Como fazer certo |
|---|---|---|---|
| claude-opus-5-5 quer desligar o raciocínio | passar disabled em type |
retorna 400 | não há como desligar; só reduzir effort |
| claude-sonnet-5-5 quer desligar o raciocínio prévio | passar disabled em type |
retorna 400 | usar between_tools |
| querer controlar com precisão o orçamento de raciocínio | between_tools junto com budget_tokens |
combinação não é aceita | os dois não podem ser enviados juntos; usar os três níveis de effort |
| receio de que o raciocínio coma o espaço da saída | definir max_tokens muito baixo |
o conteúdo principal é truncado | o raciocínio conta em max_tokens; deixe uma folga |
A primeira consequência é que as restrições de combinação de parâmetros aumentam. between_tools não pode aparecer junto com budget_tokens ou display, o que significa que a ideia de controlar o orçamento de raciocínio com precisão não funciona nesse caminho; resta ajustar indiretamente pelos três níveis low, medium e high. Somando a regra de que “tokens de raciocínio contam em max_tokens“, quem chama a API precisa encontrar um novo equilíbrio entre effort e max_tokens.
A segunda consequência é que a lógica de ramificação precisa ser atualizada. Se o script decide se envia disabled com base no ID do modelo, ao encontrar esses dois IDs ele terá que seguir caminhos diferentes: no primeiro, aceitar a realidade de que “não dá para desligar” e baixar o nível de effort; no segundo, mudar para between_tools. Vale concentrar esse tipo de ramificação em um único ponto de configuração; assim, se a regra mudar de novo, a área de alteração será mínima.
Aproveitando: a mesma página também informa que Fable 5.1 e Fable 5 retornam 400 ao receber disabled, ou seja, também não dá para desligar; já Haiku 5.5 e Opus 5 ainda podem usar disabled quando effort não é superior a high. Se o código atende vários IDs de modelo, a recomendação é manter uma matriz de ativação por modelo, em vez de aplicar a mesma forma para todos.
Impacto na estrutura de custos: tokens de raciocínio e uso
Na tabela geral de preços da APIYI (apiyi.com), o claude-sonnet-5-5 custa $2 por entrada, $10 por saída e $0.1 por leitura de cache. Como os tokens de raciocínio entram em max_tokens, desligar ou não o raciocínio prévio e escolher qual nível de effort usar terá reflexo direto no consumo de tokens. Em cenários de alto volume, essa diferença se amplifica; na hora de alterar o código, vale a pena fazer essa conta.
Legenda da imagem: dados organizados a partir da documentação oficial de 2026-11-08; dá para conferir o texto original no centro de documentação da APIYI apiyi.com.
| ID do modelo | Disponibilidade de disabled |
Regra da documentação |
|---|---|---|
| claude-opus-5-5 | indisponível, retorna 400 | não dá para desligar o raciocínio; só reduzir effort (padrão medium) |
| claude-sonnet-5-5 | indisponível, retorna 400 | usar between_tools (padrão high) |
| Fable 5.1 / Fable 5 | indisponível, retorna 400 | também não dá para desligar |
| Haiku 5.5 / Opus 5 | disponível quando effort não é superior a high |
a forma antiga só vale para esses dois IDs |
Como validar rapidamente o between_tools do claude-sonnet-5-5
Antes de colocar as mudanças em produção, recomenda-se validar as diferenças de comportamento com um volume pequeno de tráfego. Registre-se na APIYI (apiyi.com) e obtenha uma chave API — novos usuários têm cota gratuita de teste. Envie as requisições para https://api.apiyi.com, defina o type de thinking como between_tools no corpo da requisição, escolha um dos três níveis de effort, execute uma primeira rodada e depois compare com o modo adaptativo sem passar thinking, observando mudanças na estrutura da saída e no consumo de tokens.
🚀 Dica de validação rápida: obtenha a cota gratuita de teste pela APIYI apiyi.com, execute os dois modos —
between_toolse adaptativo — com o mesmo conjunto de comandos, confirme as diferenças e só então altere o código existente. A plataforma oferece invocação unificada dos principais modelos, como Claude, OpenAI e Gemini, com interface compatível com OpenAI e cobrança por uso, o que facilita a comparação e a troca entre eles.
FAQ: disabled, between_tools e erro 400
P1: afinal, é possível desativar o raciocínio no claude-opus-5-5?
Não. A documentação oficial de 2026-11-08 é clara: passar `disabled` retorna erro 400, e esse ID de modelo não tem chave para desativar o raciocínio — só é possível reduzir a profundidade do raciocínio via `effort`, cujo nível padrão é `medium`. Se o cenário exigir ausência total de raciocínio, só resta trocar o ID do modelo.
P2: o between_tools do claude-sonnet-5-5 pode ser combinado com budget_tokens?
Não. A documentação deixa claro que `between_tools` não pode ser enviado junto com `display` ou `budget_tokens`; o `effort` correspondente aceita apenas os três níveis `low`, `medium` e `high`, sem poder ultrapassar `high`. Para controlar com precisão o orçamento de raciocínio, só resta voltar ao modo adaptativo ou trocar o ID do modelo.
P3: por que minhas requisições ao Claude passaram a retornar 400 do nada?
Primeiro verifique se você definiu o `type` de `thinking` como `disabled` no corpo da requisição — no claude-opus-5-5 e no claude-sonnet-5-5, essa é a condição de disparo indicada na documentação. Depois de confirmar, siga a tabela comparativa deste artigo: no primeiro modelo, reduza o `effort`; no segundo, mude para `between_tools`. A sintaxe aplicável segue a documentação oficial de 2026-11-08 (UTC+8), e a página da APIYI foi sincronizada em 2026-11-09 às 10:40.
P4: como validar rapidamente o efeito do between_tools no claude-sonnet-5-5?
Registre uma conta na APIYI (apiyi.com) e obtenha uma chave API — novos usuários têm cota gratuita de teste. Envie as requisições para `https://api.apiyi.com`, defina o `type` de `thinking` como `between_tools` e escolha qualquer nível de `effort`; com uma rodada já é possível comparar a diferença em relação ao modo adaptativo.
P5: os tokens de raciocínio consomem o orçamento de saída?
Sim. Os tokens de raciocínio entram na conta de `max_tokens`, e a saída máxima dos dois IDs de modelo é 128000. Se `max_tokens` for definido muito baixo na requisição, o raciocínio pode consumir o orçamento primeiro e o texto ser truncado; recomenda-se reservar espaço suficiente para o conteúdo.
claude-opus-5-5 e claude-sonnet-5-5: pontos-chave (Key Takeaways)
- claude-opus-5-5 não desliga o raciocínio: passar
disabledretorna 400 na hora; só dá para rebaixar o nível viaeffort, cujo padrão émedium. - claude-sonnet-5-5 passou a usar
between_tools: desativa o raciocínio prévio e mantém apenas as atualizações de progresso entre as chamadas de ferramentas. - Três linhas vermelhas de parâmetros:
effortaceita apenaslow,mediumehigh, não pode ser maior quehigh, e é proibido combiná-lo comdisplayebudget_tokens. - Regras de orçamento: os tokens de raciocínio entram na conta de
max_tokens, e o teto dos dois IDs é 128000. - Ponto de verificação: APIYI apiyi.com; a base no formato Anthropic é
https://api.apiyi.com— não adicione/v1.
Resumo: três ações para evitar o 400
O que claude-opus-5-5 e claude-sonnet-5-5 exigem cabe em três frases:
- claude-opus-5-5: passar
disableddá 400, o raciocínio não desliga — só resta reduzir oeffort. - claude-sonnet-5-5: para desativar o raciocínio prévio use
between_tools; são três níveis deeffort, e é proibido combinar comdisplayebudget_tokens. - Orçamento: tokens de raciocínio contam dentro de
max_tokens, com teto de 128000 — deixe folga para o texto principal.
Se você está travado nesse 400, a recomendação é rodar primeiro uma rodada de teste de between_tools na APIYI apiyi.com com a cota gratuita de testes e confirmar o comportamento antes de mexer no código que já existe. Na plataforma, uma única chave API basta para chamar os principais modelos como OpenAI, Claude e Gemini, com cobrança por uso — ideal para comparar e alternar rapidamente.
📚 Referências
- Guia de parâmetros de pensamento (thinking) do Claude da APIYI: como usar corretamente effort e thinking
- Link:
docs.apiyi.com/api-capabilities/claude-effort-thinking.md -
Descrição: versão atualizada em 2026-11-09 às 10:40, principal fonte de fatos deste artigo
-
Atualizações do guia da APIYI: comunicado oficial sobre a sincronização de critérios desta rodada
- Link:
docs.apiyi.com/live/2026-11/claude-thinking-guide-refresh.md -
Descrição: registra o processo de alinhamento com a documentação oficial de 2026-11-08
-
Documentação oficial da Anthropic: definição original do parâmetro thinking
- Link:
docs.anthropic.com - Descrição: recomenda-se a leitura comparativa para confirmar a forma mais recente
Autor: Equipe técnica da APIYI
Contato técnico: fique à vontade para nos contatar pela página inicial do site da APIYI. Mais materiais estão disponíveis no centro de documentação docs.apiyi.com
