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

# 拒絕請求的備用額度 (Beta 版）
<a name="claude-messages-fallback-credit"></a>

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

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

## 支援的模型
<a name="claude-messages-fallback-credit-supported-models"></a>


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

## 運作方式
<a name="claude-messages-fallback-credit-how-it-works"></a>

**步驟 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>"
}
```

## 兌換規則
<a name="claude-messages-fallback-credit-redemption-rules"></a>


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

## 錯誤處理
<a name="claude-messages-fallback-credit-error-handling"></a>

存在 Beta 標記時，任何兌換驗證失敗都會傳回 `400 invalid_request_error`。每種情況下的復原路徑都是在沒有 的情況下重試`fallback_credit_token`。失敗條件包括：
+ 格式不正確或無法辨識的權杖
+ 超過 5 分鐘的字符
+ 請求內文不符合原始拒絕的請求
+ 目標模型不是有效的備用目標
+ 字符已兌換

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

## 帳單影響
<a name="claude-messages-fallback-credit-billing-impact"></a>

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

## 範例工作流程
<a name="claude-messages-fallback-credit-example-workflow"></a>

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

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

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

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

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