View a markdown version of this page

Crédito alternativo para solicitações recusadas (beta) - Amazon Bedrock
Modelos compatíveisComo funcionaRegras de resgateTratamento de errosImpacto no faturamentoExemplo de fluxo de trabalho

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crédito alternativo para solicitações recusadas (beta)

Quando Claude Fable 5 recusa uma solicitação, os clientes que repetem a mesma conversa em um modelo diferente (como Claude Opus 4.8) normalmente pagam novamente as taxas de gravação em cache pelo prefixo da conversa que já estava armazenado em cache no Fable 5. O crédito alternativo elimina essa cobrança dupla ao emitir um token de crédito único em caso de recusa, que pode ser resgatado na nova tentativa.

Esse recurso requer o sinalizador beta fallback-credit-2026-06-09 na anthropic_beta matriz tanto na solicitação original quanto na nova tentativa.

Modelos compatíveis

Perfil Modelo
Fonte (emite crédito em caso de recusa) Claude Fable 5
Target (resgata crédito ao tentar novamente) Deve ser um destino alternativo válido do modelo de origem

Como funciona

Etapa 1: receba um token de crédito alternativo em caso de recusa

Quando uma solicitação para Claude Fable 5 retorna stop_reason: "refusal" e a bandeira beta está presente, o stop_details objeto inclui: fallback_credit_token

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "anthropic.claude-fable-5",
  "content": [],
  "stop_reason": "refusal",
  "stop_details": {
    "type": "refusal",
    "category": "cyber",
    "explanation": "This request triggered restrictions on violative cyber content and was blocked under Anthropic's Usage Policy.",
    "fallback_credit_token": "<opaque token>"
  },
  "usage": {
    "input_tokens": 106,
    "output_tokens": 1
  }
}

fallback_credit_tokenÉ uma corda opaca. É null quando as condições básicas não são atendidas (nenhum cache foi lido na solicitação original, o modelo não é elegível para crédito ou o sinalizador beta está ausente). Server-side falhas na cunhagem produzemnull, nunca, um erro.

No modo de streaming, o token é entregue no message_delta evento finalstop_details.

Etapa 2: resgatar o token em uma solicitação de nova tentativa

Passe o token como um parâmetro de nível superior na nova tentativa para o modelo alternativo:

{
  "anthropic_version": "bedrock-2023-05-31",
  "anthropic_beta": ["fallback-credit-2026-06-09"],
  "model": "anthropic.claude-opus-4-8",
  "max_tokens": 4096,
  "system": "...",
  "messages": [...],
  "tools": [...],
  "fallback_credit_token": "<token from the refusal's stop_details>"
}

Regras de resgate

Regra Requisito
Janela de tempo O token deve ser resgatado em até 5 minutos após a emissão.
Vinculação de plataforma Um token cunhado só bedrock-mantle pode ser resgatado em. bedrock-mantle
Combinação corporal Os tools campos systemmessages, e devem corresponder exatamente à solicitação recusada. Envie-os como estão; não remova os blocos de pensamento.
Tente novamente as formas O corpo da nova tentativa deve (a) corresponder exatamente à solicitação recusada (o modelo de fallback regenera a resposta) ou (b) combiná-la com uma mensagem de assistente anexada contendo a saída parcial da resposta recusada (o modelo de fallback continua de onde o Fable 5 foi interrompido).
Modelo alvo Deve ser um alvo alternativo válido do modelo recusado.

Tratamento de erros

Com o sinalizador beta presente, qualquer falha na validação do resgate retorna um. 400 invalid_request_error O caminho de recuperação em todos os casos é tentar novamente semfallback_credit_token. As condições de falha incluem:

  • Token malformado ou irreconhecível

  • Token com mais de 5 minutos

  • O corpo da solicitação não corresponde à solicitação original recusada

  • O modelo de destino não é um alvo alternativo válido

  • O token já foi resgatado

Sem o sinalizador beta, fallback_credit_token é rejeitado como um campo desconhecido (400). O parâmetro também é rejeitado nas count_tokens solicitações.

Impacto no faturamento

Quando um token de crédito alternativo é resgatado com sucesso, a solicitação de nova tentativa recebe um crédito pelos tokens de gravação em cache que se sobrepõem ao prefixo em cache da solicitação recusada. O cliente paga somente pelos novos tokens líquidos na nova tentativa, não pelo armazenamento em cache novamente do prefixo da conversa.

Exemplo de fluxo de trabalho

  1. Envie uma solicitação para Claude Fable 5 com. anthropic_beta: ["fallback-credit-2026-06-09"]

  2. Receba uma recusa com uma entradafallback_credit_token. stop_details

  3. Tente imediatamente para Claude Opus 4.8 com o mesmosystem,messages, etools, mais o. fallback_credit_token

  4. A nova tentativa é cobrada com taxas reduzidas pelo prefixo em cache sobreposto.

Se o token estiver null expirado ou for inválido, tente novamente normalmente sem ele. O crédito é uma otimização de custos, não um requisito funcional para que a nova tentativa seja bem-sucedida.