翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 拒否されたリクエストのフォールバッククレジット (ベータ)
<a name="claude-messages-fallback-credit"></a>

Claude Fable 5 がリクエストを拒否すると、別のモデル (4Claude Opus.8 など) で同じ会話を再試行するお客様は、通常、Fable 5 に既にキャッシュされていた会話プレフィックスのキャッシュ書き込み料金を支払います。フォールバッククレジットは、再試行時に交換できる拒否時に 1 回限りのクレジットトークンを発行することで、この二重請求を排除します。

この機能を使用するには、元のリクエストと再試行の両方の`fallback-credit-2026-06-09``anthropic_beta`配列にベータフラグが必要です。

## サポートされているモデル
<a name="claude-messages-fallback-credit-supported-models"></a>


| **ロール**  | **[Model]** (モデル) | 
| --- | --- | 
| ソース (拒否時にクレジットを発行) | Claude Fable 5 | 
| ターゲット (再試行時にクレジットを引き換えます) | ソースモデルの有効なフォールバックターゲットである必要があります | 

## 仕組み
<a name="claude-messages-fallback-credit-how-it-works"></a>

**ステップ 1: 拒否時にフォールバッククレジットトークンを受け取る**

Claude Fable 5 へのリクエストが戻り、ベータフラグが存在する`stop_reason: "refusal"`場合、 `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`場合です。サーバー側のマイニングの失敗は を生成し`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) 拒否されたレスポンスの部分的な出力を含む 1 つの追加アシスタントメッセージと一致させる必要があります (フォールバックモデルは Fable 5 が中断された時点から継続されます）。 | 
| ターゲットモデル | 拒否されたモデルの有効なフォールバックターゲットである必要があります。 | 

## エラー処理
<a name="claude-messages-fallback-credit-error-handling"></a>

ベータフラグが存在する場合、引き換え検証の失敗は を返します`400 invalid_request_error`。いずれの場合も、復旧パスは なしで再試行します`fallback_credit_token`。障害条件には以下が含まれます。
+ 不正な形式または認識できないトークン
+ 5 分以上経過したトークン
+ リクエスト本文が元の拒否されたリクエストと一致しません
+ ターゲットモデルが有効なフォールバックターゲットではありません
+ トークンは既に引き換えられています

ベータフラグがない場合、 `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`および に加えて `tools`を使用して 4.8 に再試行します`fallback_credit_token`。

1. 再試行は、重複するキャッシュされたプレフィックスに対して割引料金で請求されます。

トークンが `null`、期限切れ、または無効な場合は、トークンなしで通常どおり再試行します。クレジットはコスト最適化であり、再試行を成功させるための機能要件ではありません。