Claude Fable 5.2 API エラー:よくある12の問題とその修正方法
Claude Fable 5.2のエラーをトラブルシューティングする:適応的思考、強制ツール、サンプリングパラメータ、思考ブロック、コンピュータ使用、制限と再試行に関するもの。

Claude Fable 5.2の統合失敗のほとんどは、3つのグループに分類されます。サポートされていないリクエストフィールド、無効なマルチターン状態、または一時的なプラットフォーム状態です。これら3つすべてを指数バックオフで再試行するのは誤りです。設定エラーは繰り返し失敗します。状態エラーは会話の修復が必要です。自動再試行に値するのは通常、一時的な失敗のみです。
すべての調査は、HTTPステータス、error.type、完全なメッセージ、リクエストID、モデル、プラットフォーム、SDKバージョン、および編集済みのリクエスト形状を記録することから始めてください。
1. 強制ツール選択が400を返す
症状: tool_choice: このモデルでは type "tool" と "any" はサポートされていません。
原因: Fable 5.2 は tool_choice の値 any または名前付き tool をサポートしていません。
修正: スキーマ検証ツールの入力には auto と strict: true を、構造化された最終応答には JSON 出力を使用してください。ツールを無効にする必要がある場合、none は引き続きサポートされます。
2. 手動思考設定が400を返す
症状: thinking: を送信する際の無効なリクエスト {"type":"有効"}budget_tokensまたはthinking を使用する場合 {"type":"無効"}.
原因: アダプティブ思考が常にオンになっています。
修正: thinking を省略するか、サポートされているアダプティブ設定を使用してください。努力で深さを制御します。
3. サンプリングパラメータが400を返す
症状: 古いモデルで動作していたリクエストが、temperature、top_p、または top_k を含むと失敗する。
原因: Fable 5.2 はそれらのサンプリング制御を受け付けません。
修正: 削除してください。プロンプト、労力、スキーマ、検証を通じて動作を制御します。
4. 古いコンピュータ使用ツールタイプは拒否されます
症状: エラー名 computer_20251124 またはその他のサポートされていないタイプ。
原因: Claude APIおよびほとんどのサポート対象プラットフォームでは、Fable 5.2はcomputer_toolset_20260801ツールセットを使用します。Amazon Bedrockには、ベータヘッダーを使用した以前のツールに関する互換性の例外が文書化されています。
修正: ツール宣言とエージェントループを移行します。Bedrockの例外が他の場所にも適用されると想定しないでください。
5. 思考ブロックでプレフィックスチェックが失敗する
症状: マルチターン会話を再生する際に400エラーが発生します。
原因: 思考ブロックが作成された後に、以前のシステムプロンプト、ツール定義、メッセージ、ファイル、またはツール結果が変更されました。
修正: 履歴を追記専用に保ち、アシスタントブロックを変更せずに戻すか、新しいブランチを開始します。サポートされている場合は、バインディング制御診断を使用します。
6. 思考ブロックがアカウント間で消える
症状: 再生されたブロックがドロップされるか、会話に影響を与えなくなります。
原因: Fable 5.2 の思考ブロックは、それを生成したアカウントまたはリンクされたアカウントにバインドされています。
修正: 保存された思考をポータブルアプリケーションデータとして転送しないようにします。代わりに、基礎となるユーザー可視状態と検証済みアーティファクトを共有します。
7. アドバイザーモデルと実行者モデルは互換性がありません
症状: エグゼキュータをFable 5.2にアップグレードした後、アドバイザーツールのリクエストが失敗します。
原因: Fable 5.2 エグゼキューターは Fable 5.2 または Mythos 5.2 アドバイザーを受け入れますが、以前の設定で受け入れられていた古い Fable や Opus アドバイザーは受け入れません。
修正: アドバイザーモデルをエグゼキューターと一緒にアップグレードし、ワークフロー評価を再実行します。
8. 構造化出力スキーマが400を返す
症状: API が output_config.format または厳密なツールスキーマを拒否します。
原因: スキーマが、再帰、外部参照、特定の数値/文字列制約、複雑な正規表現、または false 以外の additionalProperties などのサポートされていない機能を使用しています。また、顧客管理の暗号化キーを使用する組織は、Fable 5.2 で構造化出力を使用できません。
修正: 現在サポートされている機能に基づいてスキーマを簡素化するか、アカウント設定でStructured Outputsが除外されている場合にローカルで検証します。
9. リクエストが大きすぎます: 413
症状: モデル処理前に request_too_large が発生します。
原因: ファーストパーティのメッセージまたはトークンカウントリクエストが128 MBを超えている。バッチリクエストが256 MBを超えている。Files APIのアップロードがそれぞれの制限を超えている。
修正: 適切なAPIを通じてファイルをアップロードし、コンテンツを圧縮または分割し、重複したエンコーディングを削除するか、検索を使用してください。100万トークンのコンテキストウィンドウは、バイトサイズの制限を上書きしません。
10. 認証またはアクセスに失敗: 401/403/404
症状: 認証、権限、または未検出エラー。
原因: 不正な形式、期限切れ、失効、またはプロジェクトが間違っているキー;ワークスペース/モデルへのアクセス権限不足;エンドポイントまたはモデルIDの誤り;またはクラウド固有のID問題。
修正: キーと組織を確認し、選択したプラットフォームのドキュメントに記載されたモデルIDを使用し、リージョンと権限を確認してください。完全なシークレットをログに出力しないでください。
11. レート制限または過負荷: 429/529
症状: レート制限応答または overloaded_error。
原因: アカウント制限、急なトラフィック、またはプラットフォーム全体の負荷。
修正: retry-after を尊重し、ジッター付きの制限付き指数バックオフを使用し、同時実行を制御し、サーキットブレーカーを追加します。Anthropic の公式 SDK は、多くの一時的な接続、レート制限、5xx エラーをデフォルトで 2 回再試行します。アプリケーションの再試行を調整して、それらが増加しないようにします。
12. タイムアウトまたはストリーム途中の障害
症状: 初期のHTTP 200応答の後、504 timeout_error、接続失敗、またはSSEエラーが発生します。
原因: リクエストの長時間化、ネットワークの中断、ツールの遅延、またはストリーミングの失敗。
修正: 長時間リクエストのストリーミング、SSEエラーイベントの処理、外部アクションに対するアプリケーション層での冪等性の使用、そしてワークフローが既に完了したことを証明できる箇所からのみ再開します。
リトライマトリックス
| 失敗 | 再試行は変更なし? | 正しい応答 | |---|---|---| | 無効なパラメータ / スキーマ | いいえ | リクエストを修正 | | 思考プレフィックスの不一致 | いいえ | 修復またはブランチ状態 | | 認証 | いいえ | 認証情報のローテーション/修正 | | レート制限 | はい、制限あり | 遅延を尊重し負荷を軽減 | | 過負荷 / サーバー5xx | はい、制限あり | バックオフ、承認されればフォールバック | | 拒否 | 盲目的な再試行なし | より安全な支援または人間による確認 | | タイムアウト | 場合によっては | ストリーム、副作用の検査、安全な再試行 |
本番ログ出力チェックリスト
- リクエストIDとプラットフォームリクエストID
- タイムスタンプとモデルID
- SDK/バージョンとエンドポイント
- ステータス、エラータイプ、および編集済みメッセージ
- 試行回数とバックオフ
- ツールまたは外部の副作用が完了しました
- シークレットを含まないプロンプト/スキーマバージョン
- 最終復旧パス
プロバイダーの問題をエスカレーションする際には、リクエストIDが不可欠です。機密性の高いプロンプト内容を不必要に記録することなく、それらを保持してください。
よくある質問
すべての400エラーは再試行すべきですか?
いいえ。400は通常、リクエストや状態の問題を示します。変更せずに再試行すると、コストとノイズが増加します。
HTTP 200 の後にストリーミングが失敗するのはなぜですか?
SSEストリームが開始されると、その後のエラーは新しい標準のHTTPエラーレスポンスではなく、ストリームイベントとして配信されます。
なぜ古いClaudeのリクエストがFable 5.2で中断したのですか?
モデル固有の思考、サンプリング、ツール、コンピュータ使用、および保存状態のルールは異なる場合があります。Fable 5.2の移行およびエラードキュメントに照らしてリクエストを検証してください。


















































































































