サポートされているモデル仕組み引き換えルールエラー処理請求への影響ワークフローの例

拒否されたリクエストのフォールバッククレジット (ベータ)

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

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

サポートされているモデル

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

仕組み

ステップ 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>"
}

引き換えルール

ルール	要件
時間枠	トークンは発行後 5 分以内に交換する必要があります。
プラットフォームバインディング	に発行されたトークンは、でのみ交換`bedrock-mantle`できます`bedrock-mantle`。
本文の一致	`system`、`messages`、および `tools`フィールドは、拒否されたリクエストと完全に一致する必要があります。そのまま送信します。思考ブロックは削除しないでください。
シェイプを再試行する	再試行本文は、(a) 拒否されたリクエストと正確に一致 (フォールバックモデルがレスポンスを再生成) するか、(b) 拒否されたレスポンスの部分的な出力を含む 1 つの追加アシスタントメッセージと一致させる必要があります (フォールバックモデルは Fable 5 が中断された時点から継続されます）。
ターゲットモデル	拒否されたモデルの有効なフォールバックターゲットである必要があります。

エラー処理

ベータフラグが存在する場合、引き換え検証の失敗はを返します400 invalid_request_error。いずれの場合も、復旧パスはなしで再試行しますfallback_credit_token。障害条件には以下が含まれます。

不正な形式または認識できないトークン
5 分以上経過したトークン
リクエスト本文が元の拒否されたリクエストと一致しません
ターゲットモデルが有効なフォールバックターゲットではありません
トークンは既に引き換えられています

ベータフラグがない場合、 fallback_credit_tokenは不明フィールド (400) として拒否されます。パラメータはcount_tokensリクエストでも拒否されます。

請求への影響

フォールバッククレジットトークンが正常に引き換えられると、再試行リクエストは拒否されたリクエストのキャッシュされたプレフィックスと重複するキャッシュ書き込みトークンのクレジットを受け取ります。顧客は、会話プレフィックスを再キャッシュするのではなく、再試行の新しいトークンに対してのみ支払います。

ワークフローの例

を使用して Claude Fable 5 にリクエストを送信しますanthropic_beta: ["fallback-credit-2026-06-09"]。
fallback_credit_token でを使用して拒否を受け取りますstop_details。
すぐに、同じ Claude Opus system、、messagesおよびに加えて toolsを使用して 4.8 に再試行しますfallback_credit_token。
再試行は、重複するキャッシュされたプレフィックスに対して割引料金で請求されます。

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

ドキュメントの表記規則

圧縮

会話中のシステムメッセージ