guides

Claude Fable 5.2 API:料金、導入手順、コード例

Poyo.ai Team
5 min read
Share:

要点

  • モデルIDはclaude-fable-5-2。 2026年11月9日にリリースされ、1Mトークンのコンテキストウィンドウと、1リクエストあたり最大128Kの出力トークンに対応しています。
  • 料金は入力/出力100万トークンあたり$8 / $40(AnthropicのAPI)で、Fable 5.1より20%安くなりました。PoYoでは$6.40 / $32です。
  • PoYoでの呼び出し方は2通り。 POST https://api.poyo.ai/v1/messagesのAnthropic Messages形式と、OpenAI互換のPOST https://api.poyo.ai/v1/chat/completionsです。公式のAnthropic SDKも、ベースURLをhttps://api.poyo.aiに設定すればそのまま使えます。
  • 思考は常に有効。 思考の深さとコストはoutput_config.effortで調整します。デフォルトはhighで、定型的な作業にはmediumかlowが向いています。
  • 思考は出力として課金される。 high effortでは短い回答でも数千の出力トークンを使うことがあるため、effortを明示的に設定し、max_tokensは思考と回答の合計に見合う値にしてください。
  • まずstop_reasonを確認する。 モデルが回答を終えたのか、ツールを呼び出したのか、max_tokensに達したのか、安全上のrefusalを返したのかがわかるので、コンテンツを読む前にチェックしましょう。

Claude Fable 5.2 APIの概要

Claude Fable 5.2
APIモデルIDclaude-fable-5-2
リリース日2026年11月9日
コンテキストウィンドウ1Mトークン
最大出力1リクエストあたり128Kトークン
入力 → 出力テキストと画像 → テキスト
思考アダプティブ、常に有効
effortレベルlow、medium、high(デフォルト)、xhigh、max
ナレッジカットオフ2026年6月
データ保持30日間保持
公式料金(100万トークンあたり)入力$8 / 出力$40 / キャッシュ読み取り$0.20
PoYoの料金(100万トークンあたり)入力$6.40 / 出力$32 / キャッシュ読み取り$0.16
PoYoのエンドポイント/v1/messages、/v1/chat/completions

AnthropicはFable 5.2を、高度な推論や長時間にわたるエージェント作業向けのモデルと位置づけており、ほとんどのワークロードではClaude Opus 5.5から始めることを推奨しています。どちらを使うか迷っている場合は、先にClaude Fable 5.2とOpus 5.5の比較をご覧ください。このガイドでは組み込み方法を扱います。

Claude Fable 5.2のエージェントが構築したプロトタイプのOSを、ノートPCで動かしている様子。動画はAnthropicのClaude Fable 5.2発表資料より。

Fable 5、5.1、5.2:どの料金を見ているのか

「Claude Fable 5 pricing」で検索すると、2026年にリリースされた3つのFableモデルのどれを指しているのかがわかりにくくなります。3モデルとも1Mのコンテキストウィンドウと128Kの出力上限は共通で、料金はそれぞれ異なります。

モデルリリース日入力出力キャッシュ読み取りAPIモデルID
Claude Fable 52026年6月9日$10$50$1.00claude-fable-5
Claude Fable 5.12026年9月1日$10$50$0.25claude-fable-5-1
Claude Fable 5.22026年11月9日$8$40$0.20claude-fable-5-2

公式料金(米ドル/100万トークン)です。Fable 5.2はFableティアで初めて値下げされた現行モデルなので、新しいプロジェクトはFable 5.2から始めましょう。このガイドでは以降、Fable 5.2について解説します。

料金のまとめ

料金項目(100万トークンあたり)Anthropic公式PoYoPoYoクレジット
入力$8.00$6.401,280
出力(思考を含む)$40.00$32.006,400
キャッシュ読み取り$0.20$0.1632
キャッシュ書き込み(5分)$10.00$8.001,600
キャッシュ書き込み(1時間)$16.00$12.802,560

PoYoはサブスクリプション不要の従量課金で、$1 = 200クレジットのクレジット制です。1Mのコンテキストウィンドウ全体が標準料金で課金されるため、900Kトークンのプロンプトも9Kトークンのプロンプトも、トークン単価は同じです。その他のClaudeモデルについては、Claude API料金ガイドをご覧ください。

クイックスタート

  1. PoYoのダッシュボードでAPIキーを作成します。
  2. モデルをclaude-fable-5-2に設定して、https://api.poyo.aiにリクエストを送ります。
  3. 認証は、/v1/messagesではx-api-key: YOUR_KEY(Authorization: Bearer YOUR_KEYも利用可)、/v1/chat/completionsではAuthorization: Bearer YOUR_KEYを使います。

curl(Anthropic Messages形式)

curl https://api.poyo.ai/v1/messages \
  -H "x-api-key: $POYO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 16000,
    "output_config": {"effort": "medium"},
    "messages": [
      {"role": "user", "content": "このGoのワーカープールにある競合状態を見つけて、修正案を提示してください:..."}
    ]
  }'

レスポンスは標準的なAnthropicのMessageオブジェクトです。回答はcontentのtextブロックに入っており、その前にthinkingブロックが来ることがあります。

Python(Anthropic SDK)

import os
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.poyo.ai",
    api_key=os.environ["POYO_API_KEY"],
)

with client.messages.stream(
    model="claude-fable-5-2",
    max_tokens=32000,
    output_config={"effort": "medium"},
    thinking={"type": "adaptive", "display": "summarized"},
    messages=[{"role": "user", "content": "このサービスをRESTからgRPCへ移行する計画を書いてください:..."}],
) as stream:
    message = stream.get_final_message()

if message.stop_reason == "refusal":
    print("Request declined:", message.stop_details)
else:
    for block in message.content:
        if block.type == "thinking":
            print("Thinking summary:", block.thinking)
        elif block.type == "text":
            print(block.text)

print(message.usage)

ストリーミングを使えば、長いリクエストでもHTTPタイムアウトを気にせずに済みます。high以上のeffortでは、難しいリクエスト1件に数分かかることもあります。

TypeScript(Anthropic SDK)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.poyo.ai",
  apiKey: process.env.POYO_API_KEY,
});

const message = await client.messages
  .stream({
    model: "claude-fable-5-2",
    max_tokens: 32000,
    output_config: { effort: "medium" },
    messages: [{ role: "user", content: "このプルリクエストにセキュリティ上の問題がないかレビューしてください:..." }],
  })
  .finalMessage();

if (message.stop_reason === "refusal") {
  console.log("Request declined:", message.stop_details);
} else {
  for (const block of message.content) {
    if (block.type === "text") console.log(block.text);
  }
}

OpenAI互換のChat Completions

すでにOpenAI形式のリクエストを使っている場合は、同じモデルIDを/v1/chat/completionsに送ります。

curl https://api.poyo.ai/v1/chat/completions \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "messages": [
      {"role": "system", "content": "あなたはシニアデータエンジニアです。"},
      {"role": "user", "content": "ClickHouseでイベントの重複を排除するためのスキーマを設計してください。"}
    ],
    "stream": true
  }'

公式のOpenAI SDKでは、base_urlをhttps://api.poyo.ai/v1に設定します。output_config.effort、思考の表示、cache_control、Anthropic形式のツール定義など、Claude固有の設定を使いたい場合は/v1/messagesを選んでください。

effort:品質とコストを左右する最大のレバー

Fable 5.2はすべてのリクエストでアダプティブに思考します。どれだけ思考するかは、output_config内のeffortで決まります。

effort向いている用途補足
low短いやり取り、要件が明確なタスク、大量に動かすサブエージェント最も速く、最も安い。長いタスクでは「タスクを最後までやり遂げる」という指示を加える
medium対話的なコーディング、チャット、日常的な知識作業ほとんどのプロダクトのトラフィックに適したデフォルト
high(デフォルト)難しいコーディング、リサーチ、エージェント作業、無人で長時間動かす処理Anthropicによると、能力向上の大部分はhighの時点で得られる
xhigh最も難しい、長時間にわたるコーディングとエージェント作業評価で効果が確認できた場面で使う。トークン使用量は増える
max性能の上限を測るとき、または時間やトークンよりも深さが重要なまれなタスク最も深い推論と、最も長いターン

AnthropicのFrontierCode 2.0のグラフ。low、medium、high、xhigh、maxの各effortでのClaude Fable 5.2と他のモデルについて、スコアとタスクあたりのコストをプロットしたもの

FrontierCode 2.0で、effortによってスコアとタスクあたりのコストがどう変わるか。グラフはAnthropicのClaude Fable 5.2発表資料より。

実践的なルールが3つあります。

  • すべてのリクエストでeffortを設定する。 Opus 5.5から流用したコードは、デフォルトでmediumで動いていました。Fable 5.2では同じリクエストがhighで動き、出力トークンも多くなります。
  • 思考の量はeffortで決める。 速く安いターンにしたい場合、Anthropicは「熟考せずに直接答えて」のようなプロンプトの指示よりも、effortのレベルを下げることを推奨しています。high以上では、Fable 5.2は挨拶への返事も含め、ほぼすべての回答の前に思考します。
  • 回答の長さはプロンプトで決める。 effortは思考の深さを、プロンプトは最終的な回答の長さを決めます。

effortが請求額にどう影響するかの実測例は、Claude Fable 5.2とOpus 5.5の比較の実地テストの結果をご覧ください。あるコーディングタスクでは、Fable 5.2はmediumでもhighでも同じスコアを記録し、mediumのコストはおよそ4分の1でした。

アダプティブ思考:「常に有効」がコードに意味すること

  • thinkingは省略するか、{"type": "adaptive"}を送る。 思考の設定はこれだけです。深さはeffortで決まり、以前のbudget_tokensやdisabledの設定に代わるものです。
  • 思考トークンは出力として課金され、max_tokensにも含まれます。max_tokensは思考と回答の合計に合わせて設定しましょう。16Kが目安の下限で、難しいタスクではストリーミングと組み合わせて32K以上にするのが適しています。
  • 思考の要約はオプトイン。 デフォルトでは、thinkingブロックはthinkingフィールドが空の状態で届くため、ストリーミングが高速に保たれます。読める要約を受け取るには"display": "summarized"を追加します。どちらのモードでも、課金対象は思考全体です。
  • サンプリングはモデルに任せる。 temperature、top_p、top_kは付けずにリクエストを送ります。Fable 5.2はサンプリングを自分で管理します。
  • usageを確認する。 output_tokensにはすでに思考が含まれており、そのうちの思考分はoutput_tokens_details.thinking_tokensで確認できます。

ツールの使用

Fable 5.2では、tool_choiceにauto(デフォルト)またはnoneを指定できます。特定のツールを呼び出させたいときは、プロンプトでそのツール名を指示します。

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "output_config": {"effort": "medium"},
  "tools": [
    {
      "name": "get_order_status",
      "description": "Look up an order by its ID and return the shipping status and carrier.",
      "input_schema": {
        "type": "object",
        "properties": {"order_id": {"type": "string"}},
        "required": ["order_id"]
      }
    }
  ],
  "tool_choice": {"type": "auto"},
  "messages": [
    {"role": "user", "content": "注文A-1042は今どこにありますか?get_order_statusで確認してください。"}
  ]
}

モデルがツールを呼び出すと、レスポンスはstop_reason: "tool_use"で終わります。ツールを実行し、次のuserメッセージでtool_resultブロックを返してください。その際、assistantのターン全体を、thinkingブロックも含めてそのまま送り返します。

ほかにも知っておくと便利なルールがあります。

  • tool_choiceにはautoかnoneを使う。 ツールを確実に実行させたいときは、プロンプトでツール名を指示します。JSONを確実に得たいときは、構造化出力(JSONスキーマを指定したoutput_config.format)を使います。
  • コンピューター操作は、computer_toolset_20260801ツールセットで実行します。
  • ツールの入力はJSONパーサーで解析する。 モデルがツールの引数内で使うエスケープ形式にかかわらず、正しく処理できます。

Claude Fable 5.2がカメラ映像をもとにロボットアームを操作し、パズルキューブを解いている様子。動画はAnthropicのClaude Fable 5.2発表資料より。

1Mコンテキストとプロンプトキャッシュ

1Mトークンのウィンドウには英単語でおよそ555,000語が収まり、大規模なコードベースや大量の契約書を1回のリクエストで扱えます。Fable 5.2はClaude Opus 4.7で導入されたトークナイザーを使っており、同じテキストでも4.7より前のモデルより多くのトークンを生成します。上限を前提に計画する前に、自分のファイルでトークン数を数えておきましょう。

キャッシュの効果が最も大きいのは長いプロンプトです。Fable 5.2のキャッシュ読み取りは入力料金の2.5%(100万トークンあたり$8に対して$0.20)です。PoYoでは、トップレベルにcache_controlを追加すると、最後のキャッシュ可能なブロックが自動的にキャッシュされます。

{
  "model": "claude-fable-5-2",
  "max_tokens": 16000,
  "cache_control": {"type": "ephemeral", "ttl": "1h"},
  "output_config": {"effort": "medium"},
  "system": "You answer questions about the contract below. Quote clause numbers.\n\n<contract>...</contract>",
  "messages": [
    {"role": "user", "content": "すべての解除権と、それぞれの通知期間を一覧にしてください。"}
  ]
}

変わらない内容(システムプロンプト、ツール定義、ドキュメント)を先に置き、変わる質問を最後に置きます。マルチターンの会話やエージェントのループでは、新しいターンごとにそれまでのプレフィックスをキャッシュから読み直します。5分キャッシュは書き込みに入力料金の1.25倍かかり、1回の読み取りで元が取れます。1時間キャッシュは2倍で、2回の読み取りで元が取れます。

キャッシュとモデルの推論の両方をターンをまたいで活かすには、2つの習慣が役立ちます。

  • 履歴は追記のみにする。 各thinkingブロックは、その前にあるシステムプロンプト、ツール、メッセージと結びついています。1つの会話の中ではsystemとtoolsを固定し、新しいターンはmessagesの末尾に追加してください。以前のターンを編集したうえで古いthinkingブロックを送り返すと、APIのプレフィックスチェックがThe block is bound to a different conversationというメッセージでリクエストを検出します。指示を変えたいときは、新しい会話を始めましょう。
  • モデルはいつでも切り替えられる。 同じ会話の中でも、リクエストごとにmodelを変更できます。Fable 5.2のthinkingブロックを読み取るのはFable 5.2とMythos 5.2です。会話がOpus 5.5などの別モデルに移ると、APIがそれらのブロックを自動的に除外し、リクエストは成功して、新しいモデルが独自の推論で続きを進めます。キャッシュはモデルごとに保持されます。

拒否への対応

Fable 5.2は安全分類器を備えています。分類器がリクエストを止めた場合、レスポンスはHTTP 200で返り、stop_reason: "refusal"と、ポリシー領域(cyber、bio、reasoning_extractionなど)を示すstop_detailsオブジェクトが含まれます。コードでは次のように対応しましょう。

  1. 上のPythonとTypeScriptの例と同じように、contentを読む前にstop_reasonを確認します。
  2. stop_details.categoryをログに記録し、どのプロンプトで発生するかを把握します。
  3. Opus 5.5など別のモデルにリクエストを送るか、ユーザーにわかりやすいメッセージを表示します。

モデルの推論過程を確認したい場合は、"display": "summarized"の思考をリクエストしてください。そうすれば推論が回答のテキストに含まれず、reasoning_extractionカテゴリーが対象とする領域に入らずに済みます。

Fable 5.1やOpus 5.5からの移行

移行元変わる点
Claude Fable 5.1モデルIDを差し替えます。料金は$10 / $50から$8 / $40に下がります。プレフィックスチェックがすべてのアカウントに適用されるようになったため、履歴は追記のみにしてください。コンピューター操作にはcomputer_toolset_20260801を使います。advisorツールでは、advisorをclaude-fable-5-2に設定します。effortの比較検証はhighからやり直しましょう
Claude Opus 5.5トークン単価は$4 / $20から$8 / $40になり、キャッシュ読み取りは$0.20のままです。デフォルトのeffortがmediumからhighに変わるため、明示的に設定してください。Fable 5.2は30日間のデータ保持で動作します。思考とtool_choiceのルールは同じです
Claude Opus 5以前disabledやbudget_tokensの代わりに、思考をアダプティブに任せてeffortで調整します。tool_choiceはautoと指示文を組み合わせるか、JSONには構造化出力を使います。temperature、top_p、top_kの代わりに、サンプリングはモデルに任せます。max_tokensは思考と回答の合計に合わせて設定します

以前のモデルから引き継いだプロンプトは、見直しておくと効果的です。長い複数ステップのタスクでは、特にlowとmediumのeffortで、システムプロンプトに「タスクを最後までやり遂げる」という指示を加えることをAnthropicは推奨しています。Fable 5.2はスタイルのルールに忠実に従うため、古いモデル向けに書いた厳しい文長の制限は緩めると、自然な文章になります。プロンプトを変えたときは、新しい会話を始めましょう。

リクエストあたりのコスト

以下の出力トークンには思考が含まれます。料金はすべて100万トークンあたりです。

シナリオトークン数公式($8 / $40)PoYo($6.40 / $32)
チャットの返信入力5K + 出力1K0.005×8 + 0.001×40 = $0.0800.005×6.4 + 0.001×32 = $0.064(12.8クレジット)
コードレビュー入力50K + 出力8K0.05×8 + 0.008×40 = $0.720.05×6.4 + 0.008×32 = $0.576(115.2クレジット)
エージェントセッションキャッシュ読み取り2M + 新規入力300K + 出力150K2×0.2 + 0.3×8 + 0.15×40 = $8.802×0.16 + 0.3×6.4 + 0.15×32 = $7.04
800Kトークンのドキュメント、最初の質問5分キャッシュへの書き込み800K + 出力10K0.8×10 + 0.01×40 = $8.400.8×8 + 0.01×32 = $6.72
同じドキュメント、追加の質問キャッシュ読み取り800K + 出力10K0.8×0.2 + 0.01×40 = $0.560.8×0.16 + 0.01×32 = $0.45

ドキュメントの行を見ると、キャッシュの重要性がわかります。最初の質問のあと、追加の質問1回あたりのコストはおよそ15分の1になります。エージェントセッションでは出力が請求額の約3分の2を占めるため、最初に調整すべき設定はeffortです。

PoYoでClaude Fable 5.2を使う

PoYoでは、Fable 5.2をAnthropicの公式トークン料金より20%安く利用でき、実用的なメリットもそろっています。

  • 1つのAPIキーですべてのモデルを利用。 Fable 5.2、Opus 5.5、Sonnet 5.5、GPTモデル、画像・動画・音声モデルが、同じキーとダッシュボードで使えます。
  • 従量課金。 クレジットはトークン単位で課金され、サブスクリプションは不要です。
  • 2つのリクエスト形式に対応。 同じモデルIDで、Anthropic Messages形式でもOpenAI Chat Completions形式でもFable 5.2を呼び出せます。

Claude Fable 5.2のモデルページのPlaygroundでプロンプトを試し、同じモデルIDをそのまま本番環境に移せます。日常向けのデフォルトモデルと比べたいときは、同じキーのまま"model"をclaude-opus-5-5に切り替えてください(Claude Opus 5.5のページ)。

よくある質問

Claude Fable 5.2 APIの料金はいくらですか?

AnthropicのAPIでは、入力100万トークンあたり$8、出力100万トークンあたり$40で、キャッシュ読み取りは$0.20です。PoYoでは同じモデルが、100万トークンあたり入力$6.40、出力$32、キャッシュ読み取り$0.16です。思考トークンは出力の料金で課金されます。

Claude Fable 5の料金はいくらですか?

Claude Fable 5(2026年6月)は入力/出力100万トークンあたり$10 / $50で、キャッシュ読み取りは$1です。Fable 5.1は$10 / $50の料金を維持し、キャッシュ読み取りを$0.25に下げました。Fable 5.2では$8 / $40に下がり、キャッシュ読み取りは$0.20です。

Claude Fable 5.2のモデルIDは何ですか?

claude-fable-5-2です。表記どおりに指定し、/v1/messagesまたは/v1/chat/completionsで使います。

PoYoでAnthropic SDKを使えますか?

はい。ベースURLをhttps://api.poyo.aiに設定し、PoYoのキーをAPIキーとして渡します。x-api-keyとanthropic-versionはSDKが自動で送信し、ストリーミングもSDKのストリーム用ヘルパーで利用できます。

Fable 5.2の思考を減らすにはどうすればよいですか?

output_config.effortをlowかmediumに設定します。アダプティブ思考はすべてのリクエストで動き、effortのレベルに応じて量が変わるため、レベルを下げるほど回答が速く、安くなります。

どのeffortレベルを使うべきですか?

対話的な作業や定型的なコーディングはmediumから、難しく長時間にわたるエージェントタスクはhighから始めましょう。評価で効果が確認できた場面ではxhighに上げ、シンプルで大量の呼び出しにはlowを使います。

長いコンテキストはどのように課金されますか?

1Mトークンのウィンドウ全体が標準料金で課金されるため、長いプロンプトも短いプロンプトもトークン単価は同じです。プロンプトキャッシュを使えば、長いコンテキストを読み直すコストをさらに抑えられます。

会話の途中でモデルを切り替えたり、メッセージを編集したりできますか?

モデルの切り替えはいつでもできます。次のリクエストで別のmodelを指定すれば、必要に応じてAPIが以前のthinkingブロックを自動的に除外するため、リクエストは成功します。編集については、systemとtoolsを固定し、新しいメッセージは末尾に追加して、各assistantのターンは受け取ったとおりに返してください。thinkingブロックが生成されたあとで以前のターンが変更された履歴は、プレフィックスチェックで検出されます。指示を変えたいときは、新しい会話を始めましょう。

Fable 5.2とMythos 5.2はどう違いますか?

能力、仕様、料金は同じです。Mythos 5.2はCyber Verification ProgramなどAnthropicのプログラムで認証を受けた組織に提供され、Fable 5.2はすべての開発者が利用できます。

Share: