Nota do autor: este texto explica a diferença entre o effort padrão Medium do Fable no Claude Code e o padrão high do Fable 5.2 quando a API é chamada sem o parâmetro effort. Também mostra como alinhar o consumo dos dois lados nas chamadas de API.
Muita gente começa usando o Fable 5.2 no Claude Code para escrever código e acha o consumo de tokens bem controlado. Depois passa a chamar o mesmo ID de modelo pela API, vê o uso subir de forma clara em tarefas parecidas e desconfia que os dois lados não estão rodando o mesmo modelo. Aqui vai a conclusão: o effort padrão do app do Claude e do Claude Code é Medium, e na Claude API, quando você não informa o effort, o padrão do Fable 5.2 é high.
Não são dois modelos diferentes, e também não há erro de cobrança. A diferença vem do valor padrão de um mesmo parâmetro em cada ponto de entrada. A Anthropic deixa isso explícito no post de lançamento de 2026-11-09, na página do modelo na plataforma Claude e na documentação de Effort.
Valor principal: ao terminar a leitura, você vai entender por que o uso do Claude Code e o da API não batem, e vai saber definir o effort explicitamente na requisição de API, para que a comparação de custo entre os dois lados use o mesmo nível.
No Claude Code, Fable usa Medium por padrão; na API, o padrão é high: o que você precisa saber
Vamos começar com uma tabela que mostra a diferença entre as duas formas de acesso. Todas as informações aqui vêm do post oficial de lançamento, da página do modelo e da documentação de Effort.
| Ponto-chave | Explicação | O que muda para você |
|---|---|---|
| Claude Code usa Medium por padrão | O post oficial de lançamento diz que o esforço Medium é o padrão no aplicativo Claude e no Claude Code | O consumo que você vê no Claude Code é o consumo do nível Medium |
| A API usa high por padrão | Na tabela comparativa da página do modelo, o Default effort do Fable 5.2 é high, e isso se refere ao valor padrão do parâmetro effort na API do Claude | Se a requisição à API não informar effort, o modelo roda em high |
| Mesmo modelo | Os dois lados chamam o Fable 5.2; a diferença está só no nível de effort | Não interprete a diferença de consumo como versões diferentes do modelo |
| Níveis disponíveis | O Fable 5.2 suporta low, medium, high, xhigh e max | Na API, você pode definir medium explicitamente para ficar alinhado com o Claude Code |
Por que o consumo do Fable no Claude Code é diferente do consumo via API
O parâmetro effort controla quanto raciocínio e quanta saída o modelo investe em uma tarefa. Quanto mais alto o nível, mais o modelo tende a pensar e a detalhar a resposta, e o consumo de tokens também tende a ser maior. Quanto mais baixo o nível, mais o modelo tende a responder de forma rápida e econômica. O Claude Code é voltado para a interação diária de programação, e escolhe Medium como padrão para equilibrar qualidade e consumo.
A API do Claude é a interface para desenvolvedores integrarem diretamente. Nela, o valor padrão de effort do Fable 5.2 é high, ou seja, se o corpo da requisição não tiver o parâmetro effort, o servidor processa tudo como high. Muita gente que migra do Claude Code para a API troca só o base_url e o ID do modelo, sem incluir o effort, e aí o nível real de execução sobe de Medium para high.
O que a documentação oficial diz sobre o Fable 5.2 no padrão Medium
No post de lançamento de 2026-11-09, a Anthropic menciona que, no nível padrão Medium, o Fable 5.2 usa menos tokens que o 5.1 para concluir tarefas difíceis. Isso é um dado informado pela própria empresa, não uma conclusão de testes independentes. A frase mostra a eficiência do nível Medium, mas não dá um múltiplo único de quanto o high consome a mais que o Medium.
Por isso, não trate “high custa X vezes mais que Medium” como um número fixo. A complexidade da tarefa, o tamanho do contexto e o tamanho da saída influenciam a diferença real. A única forma confiável é rodar medium e high nas suas próprias tarefas e comparar o campo usage.
Fable 5.2: níveis de effort e o padrão Medium do Claude Code
A tabela abaixo mostra os cinco níveis que o Fable 5.2 suporta e como eles se relacionam com o valor padrão de cada ponto de acesso. A tendência de cada nível descreve o significado geral do parâmetro effort; o comportamento real depende do que a sua tarefa efetivamente retornar.
| Nível de effort | É o padrão de algum ponto de acesso? | Tendência geral | Tarefas indicadas |
|---|---|---|---|
low |
Não | Mais rápido e mais econômico, com pouco investimento em raciocínio | Reescritas simples, conversão de formato, classificação |
medium |
Padrão do app do Claude e do Claude Code | Equilíbrio entre qualidade e consumo | Programação do dia a dia, perguntas e respostas comuns, processamento em lote |
high |
Padrão da API do Claude (quando o parâmetro não é informado) | Raciocínio mais completo, com tendência a consumir mais | Depuração complexa, análise de arquitetura |
xhigh |
Não | Investe mais do que o high |
Raciocínio de vários passos de dificuldade mais alta |
max |
Não | Investimento máximo | Poucas tarefas críticas, com exigência altíssima de qualidade |
O ponto principal desta tabela está nas duas linhas do meio. A impressão de consumo que você formou usando o Claude Code vem do medium, enquanto a API, quando você não passa o parâmetro, roda no high. Se o objetivo é reproduzir a experiência e o custo do Claude Code, a requisição à API deve declarar o medium explicitamente.
Como fazer o Fable 5.2 ficar alinhado com o Medium padrão do Claude Code via API
Os passos abaixo não envolvem blocos de código, então é só ir conferindo na ordem. Como o campo effort deve ser escrito no corpo da requisição? Isso você confere na documentação de Effort da plataforma Claude e na documentação de interface da plataforma que você estiver usando.
Passo 1: confirme o ID do modelo e o endereço de acesso
- Na página de preços de modelos da APIYI, docs.apiyi.com/models, procure o ID do modelo Fable 5.2:
claude-fable-5-2 - Para o endereço da interface, use o base_url compatível com a OpenAI:
https://api.apiyi.com/v1 - Uma única chave API já dá acesso à invocação do modelo, sem precisar abrir uma conta separada na Claude
Passo 2: preencha o parâmetro effort explicitamente
- Quer manter o mesmo comportamento do Claude Code? Defina effort como
medium - Precisa de um raciocínio mais forte? Use
high, que também é o valor padrão quando o campo não é preenchido - Está fazendo só conversões simples? Vale testar
lowpara reduzir o consumo - Não dependa do valor padrão: se você não preencher, os logs não mostram em qual nível aquela requisição rodou
Passo 3: compare o uso dos dois níveis pelo campo usage
- Escolha o mesmo conjunto de tarefas e rode uma vez com
mediume outra comhigh - Anote os tokens de entrada, os tokens de saída e os tokens de leitura de cache retornados em cada chamada
- Converta para custo usando o preço unitário e descubra a diferença real no seu caso, em vez de aplicar um multiplicador fixo
🚀 Início rápido: se você quer primeiro validar como o nível de effort afeta o consumo, use o crédito gratuito de teste para novos usuários da APIYI (apiyi.com) e rode uma comparação entre medium e high. Na plataforma, uma única chave funciona com Claude, OpenAI, Gemini e outros modelos, então trocar de modelo para comparar depois não exige mudar a forma de integração.
Relação entre o preço da API do Fable 5.2 e o uso de effort
O effort em si não muda o preço unitário. O que ele afeta é quantos tokens uma requisição consome. Por isso, a diferença de custo é a diferença na quantidade de tokens multiplicada pelo preço unitário. A tabela abaixo traz os dados da página de preços da APIYI em 2026-11-11.
| ID do modelo | Entrada | Saída | Leitura de cache | Grupo | Data dos dados |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | Inclui ClaudeCode | 2026-11-11 |
Para conferir a unidade de preço e os valores mais recentes, consulte sempre as indicações em tempo real da página de preços da APIYI, em docs.apiyi.com/models. Pela tabela, dá para ver que o preço unitário da saída é 5 vezes o da entrada. Quando você sobe o nível de effort, o modelo tende a gerar mais raciocínio e mais conteúdo na resposta, e como o token de saída é o mais caro, o custo extra do nível high vem principalmente da parte de saída.
O preço unitário da leitura de cache é bem menor que o da entrada. Se as suas requisições têm muitos comandos de sistema repetidos ou um contexto fixo, ativar o cache reduz de forma clara o custo do lado da entrada. Só que o cache afeta apenas a entrada e não compensa o aumento de saída causado por um effort mais alto.
O jeito certo de estimar o custo do Fable 5.2
Na hora de estimar o custo, não use a regra “o high custa X vezes mais que o Medium” para montar o orçamento. A documentação oficial só informa os valores padrão dos dois pontos de entrada e a conclusão, autodeclarada pelo oficial, de que no nível Medium o Fable 5.2 gasta menos tokens que o 5.1. Não existe uma razão de conversão única entre high e Medium.
O caminho mais seguro é pegar de 20 a 50 tarefas reais e representativas, rodar cada uma nos dois níveis e calcular a média de tokens de entrada, saída e leitura de cache. Depois, use os preços unitários da tabela acima para calcular o custo médio por tarefa. Assim você chega a números que valem para o seu próprio negócio.
Fable 5.2: roteiro de verificação quando o consumo não bate
Se você notar uma diferença grande entre o consumo da API e o do Claude Code, vá conferindo os itens da tabela abaixo, um por um.
| Sintoma | Causa provável | Como resolver |
|---|---|---|
| O consumo da API é bem maior que o do Claude Code | A requisição não define o effort e roda no padrão high |
Defina medium explicitamente e compare de novo |
| Você definiu o effort, mas o consumo não mudou | O campo está na posição errada ou com nome fora do exigido pela interface, então foi ignorado | Confira a escrita do campo na documentação de Effort e na documentação da interface da plataforma |
| A requisição retorna erro de parâmetro | O valor de effort está fora do intervalo suportado | Use apenas low, medium, high, xhigh ou max |
| Erro no nome do modelo | O ID do modelo está escrito errado | Confira claude-fable-5-2 na página de preços da APIYI |
| Os dois lados estão em medium, mas o consumo ainda é diferente | O tamanho do contexto, as chamadas de ferramentas e os acertos de cache são diferentes | Fixe o conteúdo de entrada antes de comparar e olhe separadamente os tokens de leitura de cache |
A última linha é fácil de passar batido. Durante a programação, o Claude Code inclui automaticamente o conteúdo dos arquivos e o histórico da conversa, enquanto a requisição de API que você escreve por conta própria pode não carregar tanto contexto. Mesmo com o effort igual, os tokens de entrada podem ser diferentes. Por isso, na hora de comparar, o ideal é fixar a entrada.
Perguntas frequentes (FAQ)
Q1: O Fable do Claude Code e o Fable 5.2 da API são o mesmo modelo?
São o mesmo modelo. A diferença está no valor padrão do parâmetro effort: o app do Claude e o Claude Code usam Medium por padrão, enquanto na API do Claude, se você não informar o effort, o Fable 5.2 roda em high.
Q2: O que acontece se eu não informar o effort na API?
O servidor vai rodar com o valor padrão do Fable 5.2 na API do Claude, que é high. É por isso que muita gente sente que o consumo aumentou ao sair do Claude Code e passar para a API.
Q3: O high custa quantas vezes mais que o Medium?
A documentação oficial não dá um multiplicador único. O effort não muda o preço unitário, só afeta o consumo de tokens, e a diferença de consumo depende da dificuldade da tarefa, do contexto e do tamanho da saída. O ideal é rodar os dois níveis nas suas próprias tarefas e calcular a diferença com os dados de usage.
Q4: Quais níveis de effort o Fable 5.2 suporta?
De acordo com a documentação de Effort, o Fable 5.2 suporta cinco níveis: `low`, `medium`, `high`, `xhigh` e `max`. Para programação no dia a dia, `medium` costuma bastar; para raciocínios mais complexos, vale considerar níveis mais altos.
Q5: Como chamar o Fable 5.2 pela API e configurar o effort?
Siga estes três passos:
1. Crie uma conta no APIYI (apiyi.com) e pegue sua chave API; novos usuários ganham créditos gratuitos para testar
2. Use `https://api.apiyi.com/v1` como base_url e `claude-fable-5-2` como ID do modelo
3. Informe o effort explicitamente na requisição; o nome do campo segue o que está na documentação de Effort e na documentação da interface da plataforma
Q6: Quanto custa o Fable 5.2 no APIYI?
Segundo a tabela de preços de 2026-11-11, o `claude-fable-5-2` custa $8 na entrada, $40 na saída e $0,2 na leitura de cache, e o grupo inclui ClaudeCode. Os preços podem mudar, então confira os dados em tempo real na página de preços do APIYI antes de fechar o pedido.
Q7: No nível Medium, o Fable 5.2 gasta menos tokens que o 5.1. Dá para confiar nisso?
Essa informação é uma autodeclaração oficial da Anthropic, publicada em 2026-11-09, e descreve o desempenho geral em tarefas difíceis. Ela não traz números comparando high e Medium. Se custo é uma preocupação para você, o melhor é validar com os dados das suas próprias tarefas.
Q8: Devo mudar todas as requisições da API para medium?
Não necessariamente. Para reproduzir a experiência e o custo do Claude Code, `medium` resolve. Em depurações complexas ou análises críticas, você pode manter `high`, e tarefas simples podem descer para `low`. O importante é informar o nível explicitamente, em vez de deixar o valor padrão decidir por você.
Principais pontos: Fable com Medium padrão no Claude Code vs. high padrão na API
- Mesmo modelo, padrões diferentes: o Claude Code usa Medium por padrão, enquanto na API o Fable 5.2 usa high quando você não informa o effort
- Sem parâmetro, roda em high: ao migrar para a API sem levar o effort junto, é essa a causa mais comum do aumento de consumo
- Cinco níveis disponíveis: o Fable 5.2 suporta low, medium, high, xhigh e max
- Sem multiplicador fixo: a documentação oficial não traz uma proporção única de conversão entre high e Medium, então você precisa calcular com os dados das suas próprias tarefas
- O custo está na saída: o preço unitário de saída é 5 vezes o de entrada, e o aumento causado por um effort maior vem principalmente dos tokens de saída
- Caminho simples para começar: use a interface compatível com OpenAI da APIYI e o ID de modelo
claude-fable-5-2para comparar os níveis
Resumo
Sobre o Fable ter Medium como padrão no Claude Code e high como padrão na API quando nada é informado, guarde três pontos:
- Os padrões são diferentes: o app do Claude e o Claude Code usam Medium por padrão, e na API do Claude o Fable 5.2 usa high por padrão
- Defina o effort explicitamente: se quiser o mesmo comportamento do Claude Code, escreva
mediumna requisição da API - Estime o custo com dados: não aplique um multiplicador fixo; use o campo usage e os preços unitários para calcular a diferença real no seu caso
Como próximo passo, sugiro escolher um lote de tarefas reais e rodar cada uma com medium e com high, registrando os resultados no seu modelo de custos. Você pode fazer essa comparação primeiro em apiyi.com, usando a cota gratuita da APIYI, e só depois decidir o nível padrão do ambiente de produção.
📚 Referências
- Post de lançamento da Anthropic: notas de lançamento do Fable e do Mythos 5.2, 09/11/2026
- Link:
anthropic.com/claude-fable-and-mythos-5-2 -
Observação: é a fonte de que o nível Medium de effort é o padrão no app do Claude e no Claude Code, além do dado oficial, informado pela própria Anthropic, de que o Medium gasta menos tokens que o 5.1
-
Página do modelo Fable 5.2: tabela comparativa de parâmetros do modelo
- Link:
platform.claude.com/docs/en/models/fable-5-2/overview -
Observação: o Default effort é high, ou seja, o valor padrão do parâmetro effort na API do Claude
-
Documentação do Effort: explicação do parâmetro effort
- Link:
platform.claude.com/docs/en/build-with-claude/effort -
Observação: os níveis suportados pelo Fable 5.2 e o valor padrão da API
-
Tabela de preços de modelos da APIYI: ID do modelo e preços
- Link:
docs.apiyi.com/models - Observação: preços de entrada, saída e leitura de cache do
claude-fable-5-2, além das informações de grupo, com dados de 11/11/2026
Autor: equipe técnica da APIYI
Fale com a gente: se tiver dúvidas sobre a configuração do effort ou sobre a comparação de consumo, é só entrar em contato pela página inicial do site da APIYI.
