Claude Fable 5.2の使い方：APIセットアップ、エフォートレベル、コスト

Claude Fable 5.2はAnthropicによるFable 5.1の後継モデルであり、執筆時点ではArtificial Analysis Intelligence Index v5.0.1のトップモデルです。OrcaRouterではanthropic/claude-fable-5.2として、入力100万トークンあたり$8.00、出力100万トークンあたり$40.00で、他のすべてのモデルと同じキーを通じて提供されています。Claude Fable 5.2 APIページには最新の数値が掲載されています。セットアップは短時間で済みます。人々を驚かせるのは、思考の挙動、エフォートダイヤル、そしてキャッシュの経済性です。そのため、このガイドはそこに紙幅を割いています。

モデルが受け入れるものと、返すもの

100万トークンのコンテキストウィンドウ。しかも最大値が、明示的に有効化するものではなくデフォルトでもあります。1回の応答で最大128Kの出力トークン。入力はテキスト、画像、ドキュメントで、出力はテキストです。ネイティブのツール使用と構造化JSON出力をサポートします。難しいタスクは単一のターン内で数分間実行されることがあり、これはマルチステップエージェントにとっては利点であり、同期リクエストのタイムアウトを伴うものにとっては罠です。

思考は常に有効です。モデルはリクエストごとに適応的に推論し、深さは low から max までの努力レベルで制御できます。生の思考の連鎖は決して返されません — 返されるのは要約、または空の thinking フィールドです。オブザーバビリティはトランスクリプトではなく要約を中心に設計してください。

エンドポイント1:OpenAI互換のパス

ゲートウェイ上の他のどのモデルとも同じ3行です。ベースURL https://api.orcarouter.ai/v1、環境変数から取得するあなたのキー、そしてモデルIDです。すでに別ベンダー向けの動作するクライアントがあるなら、変更は1行だけで、ガイドの残りはその調整についてです。

エンドポイント2：Anthropic Messages API

Fable 5.2 は /v1/messages でもネイティブに応答します。ここで多くの人が誤解している点を説明します。ネイティブパスのベース URL は https://api.orcarouter.ai で、/v1 サフィックスは付きません。OpenAI 互換パスでは /v1 が必要です。これは Chat Completions が従う慣例だからであり、Messages パスはそうではありません。2 つのサンプル間でベース URL をコピーすることが、ルーティング障害のように見える 404 の最も一般的な原因です。

実践におけるエフォートレベル

サポートされているパラメータの一覧は include_reasoning、max_completion_tokens、max_tokens、reasoning、reasoning_effort、response_format、stop、structured_outputs、tools、verbosity です。ここで実際に重要な役割を果たすのは2つです：reasoning_effort はモデルがどれだけ深く考えるかを設定し、verbosity は回答時にどれだけ多くを話すかを設定します。これらは独立しており、混同することが一部のチームがモデルを遅いと結論づける理由です。

実用的な開始ポリシー：分類、抽出、ルーティングには低エフォートを使う。ここでは回答が短く、難しさは入力側にある。コードレビューと文書分析には中。誤った回答のコストがレイテンシより大きいと測定できたタスクに限り、高または最大を使う。思考はすべてのリクエストで有効なので、最初のトークンまでの時間を左右する唯一の調整弁はエフォートだ。グローバルではなく、ルートごとに設定すること。

リクエストにかかるコスト

入力は100万トークンあたり$8.00、出力は100万トークンあたり$40.00で、キャッシュ読み取りは$0.200、キャッシュ書き込みは100万トークンあたり$10.00です。40,000トークンの文書と2,000トークンの回答で、入力$0.32、出力$0.08の請求となり、キャッシュを使わない場合で1リクエスト40セントです。

キャッシュは計算が面白くなるところであり、書き込みに課金されるため、適切に行う価値があります。40,000トークンのプレフィックスをキャッシュに書き込むには0.40ドルかかり、その後読み取るたびに0.008ドルかかります。キャッシュなしの1回のパスは0.32ドルかかります。したがって、キャッシュされたプレフィックスは2回目の読み取りで元が取れ、それ以降は劇的に安くなります — ただし、1回しか読まないコーパスはまったくキャッシュすべきではありません。

参考までに、Fable 5.1 は入力 $10.00／出力 $50.00、Opus 4.7 は入力 $5.00／出力 $25.00 です。Fable 5.2 が前世代より入力・出力の両方で 20 パーセント安いことが、古い id を使い続けずに既存のプロンプトセットを移行するべき理由そのものです。

レイテンシーと失敗率

OrcaRouterの過去7日間の実トラフィックでは、最初のトークンまでのp50時間は8.09秒、p95は10.00秒、出力速度は毎秒101トークンで、3,560万トークン以上が提供されました。エラー率は、全上流プロバイダーを通じて非2xxを返したリクエストの10.8パーセントでした。これは、フォールバックなしの同期UIの背後に配置する前に知っておく価値があります。

8.09秒は、Artificial Analysisが最初のトークンまでの時間として報告している267秒と同じ測定ではありません。AAのハーネスは、9つの難しいベンチマークでモデルに最大の努力で思考させます。一方、ゲートウェイの数値は、呼び出し側が設定した任意の努力レベルでの実際のリクエストの中央値です。難しいプロンプトでFable 5.2を最大努力で実行すれば、p50よりもAAの数値にはるかに近い値が得られます。

どこで使うべきか、どこで使うべきでないか

間違った回答のコストが高く、呼び出しを非同期にできる場面で使う。マルチステップのエージェント、深いコード作業、長期的な計画、そして本来なら安価なモデルを3つ走らせて突き合わせるようなあらゆる用途だ。100万出力トークンあたり$40で、しかも毎リクエストでthinkingが有効となれば、誤作動のコストは現実のものになる。だからこそエフォートレベルは予算を管理する手段なのだ。

すべてのプロンプトのデフォルトのルーティング先としてこれを使用しないでください。Claude Fable 5.2 vs Claude Opus 5.5の比較は、最上位モデルが自分のワークロードに見合うかどうかを判断する場合に読むべきものであり、Claude Fable 5.2 vs Claude Fable 5.1は、前世代をすでに運用している場合の移行について説明しています。

マルチモデルのスタックを構築しているなら、LLMモデル一覧に最新のIDと価格があり、Gemini 4 Carbon APIは、そこまで大きなモデルを必要としない90パーセントの呼び出しに対応する自然な低コスト層です。

チェックリスト

選んだエンドポイントに応じてベースURLを設定する — Chat Completionsなら/v1、Messagesならサフィックスなし。エフォートは全体ではなくルートごとに設定し、エフォートと冗長さは頭の中で切り分ける。2回以上読むプレフィックスはキャッシュし、一度きりのドキュメントはキャッシュしない。出力128K、入力1Mを見込む。中程度のエフォートなら最初のトークンまで8秒、最大なら数分、そして10回に1回の呼び出しは失敗すると想定する。その後、自分の分布を測定する。このモデルは利用可能な中で最も高性能であり、出力100万トークンあたり40ドルに見合うかどうかは、完全にプロンプト次第の問いである。