View a markdown version of this page

拒絕請求的備用額度 (Beta 版） - Amazon Bedrock
支援的模型運作方式兌換規則錯誤處理帳單影響範例工作流程

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

拒絕請求的備用額度 (Beta 版）

當 Claude Fable 5 拒絕請求時，在不同的模型 （例如 Claude Opus 4.8) 上重試相同對話的客戶通常會針對已在 Fable 5 上快取的對話字首重新支付快取寫入率。備用額度可在重試時兌換的拒絕發行一次性額度字符，可消除此雙重收費。

此功能在原始請求和重試時都需要anthropic_beta陣列fallback-credit-2026-06-09中的 Beta 標記。

支援的模型

Role 模型
來源 （對拒絕發出點數） Claude Fable 5
目標 （重試時的兌換點數） 必須是來源模型的有效備用目標

運作方式

步驟 1：在拒絕時收到備用點數字符

當對 Claude Fable 5 的請求傳回 stop_reason: "refusal" 且存在 Beta 標記時，stop_details物件會包含 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 是不透明字串。這是當不符合最低限度條件null時 （原始請求上未讀取快取、模型不符合點數資格，或沒有 Beta 標記）。伺服器端探勘失敗會產生 null，絕不會產生錯誤。

在串流模式下，字符會在最終message_delta事件的 中交付stop_details。

步驟 2：在重試請求上兌換字符

將字符做為重試的頂層參數傳遞至備用模型：

{
  "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>"
}

兌換規則

規則 要求
時段 權杖必須在發出後 5 分鐘內兌換。
平台繫結 在 上開採的字符bedrock-mantle只能在 上兌換bedrock-mantle。
內文比對 system、 messages和 tools 欄位必須完全符合拒絕的請求。依原狀傳送；請勿分割思維區塊。
重試形狀 重試內文必須 (a) 完全符合拒絕的請求 （備用模型會重新產生回應），或 (b) 將其與包含拒絕回應部分輸出的附加輔助訊息相符 （備用模型從 Fable 5 中斷的位置繼續）。
目標模型 必須是拒絕模型的有效備用目標。

錯誤處理

存在 Beta 標記時，任何兌換驗證失敗都會傳回 400 invalid_request_error。每種情況下的復原路徑都是在沒有 的情況下重試fallback_credit_token。失敗條件包括：

  • 格式不正確或無法辨識的權杖

  • 超過 5 分鐘的字符

  • 請求內文不符合原始拒絕的請求

  • 目標模型不是有效的備用目標

  • 字符已兌換

如果沒有 Beta 標記， fallback_credit_token會被拒絕為未知欄位 (400)。參數也會在count_tokens請求時遭到拒絕。

帳單影響

成功兌換備用點數字符時，重試請求會收到快取寫入字符的點數，該字符與拒絕請求的快取字首重疊。客戶只需為重試時的新字符付費，而不是重新快取對話字首。

範例工作流程

  1. 使用 傳送請求至 Claude Fable 5anthropic_beta: ["fallback-credit-2026-06-09"]。

  2. 在 fallback_credit_token中使用 接收拒絕stop_details。

  3. 立即重試具有相同 Claude Opus system、 messages和 的 4.8tools，加上 fallback_credit_token。

  4. 重試會以重疊快取字首的較低費率計費。

如果字符是 null、過期或無效 - 請正常重試而不這樣做。點數是成本最佳化，而不是重試成功所需的功能。