# Claude Fable 5.2 API (https://wanapi.app/ja/docs/claude-fable-5-2)





このリファレンスでは **Claude Fable 5.2** と、このモデル固有の Messages パラメーターを説明します。`POST https://api.wanapi.app/v1/messages` に `claude-fable-5-2` を指定してください。[Claude モデルを比較](/ja/docs/claude-api)。

## モデル設定 [#モデル設定]

| 設定                        | Claude Fable 5.2   |
| ------------------------- | ------------------ |
| モデル ID                    | `claude-fable-5-2` |
| コンテキストウィンドウ               | 1M トークン            |
| 同期応答の最大出力                 | 思考を含む 128000 トークン  |
| 思考モード                     | 適応型、常に有効           |
| effort の既定値               | `high`             |
| 強制ツール呼び出し（`any` / `tool`） | 非対応                |

## 接続とリクエスト送信 [#接続とリクエスト送信]

[API キー設定](/ja/settings/apikeys)でキーを作成してください。1 つの API キーですべてのモデルとグループを利用できます。サーバーの環境変数 `WAN_API_KEY` に保管してください。`anthropic-version: 2023-06-01` を送り、必要な機能を使う場合にのみ `anthropic-beta` を追加します。

```bash
curl https://api.wanapi.app/v1/messages \
  -H "x-api-key: $WAN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Explain the purpose of a database index in three sentences."}]
  }'
```

```python
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app",
)
message = client.messages.create(
    model="claude-fable-5-2",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain the purpose of a database index in three sentences."}],
)
print("".join(block.text for block in message.content if block.type == "text"))
```

## 現在の API 対応範囲 [#現在の-api-対応範囲]

以下の表は、このモデル本来の API 仕様を説明しています。Wan API は現在、互換レイヤーを通してリクエストを転送します。**`max_tokens` には正の値を指定してください**。現在のゲートウェイは `0` を生成用のトークン上限に置き換えるため、この接続ではキャッシュの事前作成だけを行う用途には使えません。

現在のゲートウェイは `diagnostics`、`compaction`、`fallbacks`、`fallback_credit_token`、`thread` を転送しません。また、現在のチャネル設定では `speed`、`service_tier`、`inference_geo` も除外されます。以下ではモデル本来の仕様を説明するためにこれらのフィールドを掲載していますが、この接続ではまだ利用できません。応答が成功しても、無視されたフィールドが有効になったとは限りません。これらのフィールドを必要とするベータ機能にも、同じ制限が適用されます。

## パラメーター [#パラメーター]

| フィールド                   | 型 / 既定値                 | 制約                                                                            |
| ----------------------- | ----------------------- | ----------------------------------------------------------------------------- |
| `model`                 | 必須の文字列                  | `claude-fable-5-2`。正確な ID を使ってください。グループへの振り分けは自動です。                           |
| `max_tokens`            | 必須の整数                   | 思考を含む 0–128000。0 は stream true、構造化出力、強制ツールと併用できません。                           |
| `messages`              | 必須の配列                   | 公式仕様のターンを 1–100000 件。空にできるのは pause\_turn 後にスレッドを継続する場合のみ。                     |
| `system`                | 文字列またはテキストブロック配列        | スレッド継続時はフィールド自体を省略します。                                                        |
| `thinking`              | オブジェクト、既定は adaptive     | adaptive のみ。display は omitted（既定）、summarized、updates、または null。                |
| `output_config`         | オブジェクト                  | effort は low、medium、high（既定）、xhigh、max、または null。format と task\_budget は任意。    |
| `output_format`         | オブジェクトまたは null          | 非推奨の構造化出力エイリアス。output\_config.format を優先してください。                               |
| `stop_sequences`        | 文字列配列                   | null は不可。オンデマンド圧縮とは併用できません。                                                   |
| `stream`                | 真偽値、false               | true で SSE。null は不可。                                                          |
| `tools`                 | 配列                      | 公式のクライアントツールとサーバーツール / ツールセット。クライアントツールはアプリケーションが実行します。                       |
| `tool_choice`           | オブジェクト                  | auto または none。強制ツール呼び出しは拒否されます。                                               |
| `metadata`              | オブジェクト                  | user\_id は最大 512 文字の文字列、または null。                                             |
| `cache_control`         | オブジェクトまたは null          | type は ephemeral、ttl は 5m または 1h。                                             |
| `container`             | 文字列、オブジェクト、または null     | 任意の id と最大 20 件のスキル。                                                          |
| `context_management`    | オブジェクトまたは null          | 公式のコンテキスト編集。対応するベータが必要です。                                                     |
| `mcp_servers`           | 配列                      | 最大 20 件の HTTPS サーバー。対応する MCP ベータが必要です。                                        |
| `diagnostics`           | オブジェクトまたは null          | previous\_message\_id は最大 256 文字の文字列、または null。                                |
| `service_tier`          | auto または standard\_only | 任意。null は不可。                                                                  |
| `inference_geo`         | 文字列または null             | global または us。アカウントの利用可能範囲に従います。                                              |
| `speed`                 | 文字列または null             | standard、fast、または null。fast にベータ指定は不要です。                                      |
| `compaction`            | オブジェクトまたは null          | type は summarize。instructions は任意で、最大 16384 Unicode 文字。                       |
| `fallbacks`             | default、配列、または null     | 異なる対象を最大 3 件。公式の server-side-fallback ベータが必要です。                               |
| `fallback_credit_token` | 文字列、オブジェクト、または null     | トークンは最大 2048 文字。公式の credit ベータが必要で、fallbacks との併用は不可。                         |
| `thread`                | オブジェクトまたは null          | create、または previous\_message\_id で continue。message-threads-2026-08-12 が必要です。 |

## 思考とツール [#思考とツール]

Claude Fable 5.2 は既定で high effort の適応型思考を使います。enabled、disabled、between\_tools の思考モード、および budget\_tokens には対応していません。`thinking.display: updates` には `thinking-display-updates-2026-08-18` が必要です。`thinking.block_binding` では、`thinking-binding-controls-2026-08-01` を指定すると prefix\_mismatch\_behavior に error、drop\_block、null を使えます。

`output_config.task_budget` には `task-budgets-2026-03-13`、type tokens、最低 20000 の整数の total が必要です。remaining には任意で 0 以上の整数を指定できます。圧縮を使う場合や、署名付き圧縮ブロックを再送する場合は remaining を省略してください。オンデマンド圧縮には `compact-2026-09-04` が必要で、context\_management、stop\_sequences、構造化出力、強制ツールと併用できません。しきい値による圧縮では `compact-2026-01-12` を使い、input\_tokens のトリガー値は最低 50000 です。

system メッセージ単位の effort には mid-conversation-output-config-2026-07-01 が必要です。最後の assistant の事前入力は拒否されます。公式仕様に従った pause\_turn と圧縮の継続は有効です。

コンピューター操作には computer\_toolset\_20260801 を使います。Advisor ツールには advisor-tool-2026-03-01 と対応する対象モデルが必要です。ツールの実行と権限はアプリケーションが管理します。

スレッドの継続では新しいメッセージだけを送り、system と tools は省略する必要があります。圧縮、またはすべての思考を保持する操作以外のコンテキスト編集とは併用できません。リクエストがない状態で 5 分経過すると状態は失効するため、会話はローカルにも保持してください。状態に依存する制約は、継続時に検証されます。

Fable 5.2 のフォールバック先は Claude Opus 4.8 と Claude Opus 5 です。高度なベータ機能の実行と Fast モードの課金には実際の動作検証が必要です。リクエストスキーマだけでは、実測に基づく機能保証にはなりません。

## メディア入力 [#メディア入力]

画像と PDF は、一般公開された HTTP(S) URL を user メッセージの `content` ブロックに指定してください。ファイルはご自身でホストする必要があります。この接続には Files API やアップロード機能はありません。画像入力の例：

```json
{"role":"user","content":[
  {"type":"image","source":{"type":"url","url":"https://example.com/chart.png"}},
  {"type":"text","text":"What does this chart show?"}
]}
```

PDF には `document` ブロックを使います。会話を続ける際は、ツール使用 ID、完全な思考ブロック、署名を変更せずに保持してください。クライアントツールはアプリケーションが実行して結果を返します。ツールの宣言だけでは実行されません。

## 料金 [#料金]

100 万トークンあたりの米ドル料金

現在の単価には各グループの倍率が反映されています。料金情報は最大 2 分間キャッシュされます。

1 つの API キーですべてのモデルとグループを利用できます。「デフォルト」は自動ルーティング順で最初に利用できるグループを示します。実際に選ばれたグループの単価で課金されます。

### Claude Fable 5.2

`claude-fable-5-2`

| 課金対象トークン | claude · デフォルト · すべての入力長 |
| --- | ---: |
| 入力（未キャッシュ） | $4 |
| 出力 | $20 |
| キャッシュ読み取り | $0.1 |
| キャッシュ書き込み · 5 分 | $5 |
| キャッシュ書き込み · 1 時間 | $8 |

— は確認済みの単価がないことを示します。無料という意味ではありません。

キャッシュ単価は、レスポンスに対応するキャッシュ使用量が報告された場合のみ適用されます。キャッシュされたトークンを未キャッシュ入力として二重に数えないでください。

各課金対象トークン数に対応する単価を掛け、合計を 1,000,000 で割ります。思考トークンは出力トークンに含まれ、二重には課金されません。キャッシュ読み取り、5 分間の書き込み、1 時間の書き込みにはそれぞれ別の単価があります。入力長に応じて料金が変わる場合は、適用される料金区分を選んでからリクエスト料金を計算してください。

## 応答とストリーミング [#応答とストリーミング]

完了したメッセージには `id`、`type`、`role`、`model`、`content`、`stop_reason`、`usage` が含まれます。テキストは `content` のテキストブロックから取得してください。先頭のブロックは思考やツール呼び出しの場合もあります。以下は説明用の例です。

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5-2",
  "content": [{"type": "text", "text": "A database index helps locate rows without scanning the whole table."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 18}
}
```

SSE を使うには `stream: true` と `curl -N` を指定します。`message_start`、`content_block_start`、`content_block_delta`、`content_block_stop`、`message_delta`、`message_stop` に加え、`ping` とストリーム内のエラーも処理してください。各チャンクを完全なレスポンスとして扱わず、最終的な使用量を確認します。

## OpenAI 互換形式 [#openai-互換形式]

同じモデル ID を `POST /v1/chat/completions` と `POST /v1/responses` でも使えます。`Authorization: Bearer YOUR_API_KEY` を指定し、OpenAI SDK のベース URL を `https://api.wanapi.app/v1` に設定してください。Chat Completions は `messages`、Responses は `input` を使います。これらのフィールドは Messages 形式へ変換されるため、上記のネイティブパラメーターを使う場合は `/v1/messages` を利用してください。

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5-2","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

## 使用ログとエラー [#使用ログとエラー]

[LLM ログ](/ja/usage)では、過去 7 日間に完了した呼び出しのモデル、入力トークン数、出力トークン数、料金を確認できます。呼び出し後に更新し、`claude-fable-5-2` で絞り込んでください。画像・動画には[タスクログ](/ja/tasks)を使います。

リクエストが失敗したら、HTTP ステータスと `error` オブジェクトを確認してください。キー、[残高](/ja/docs/balance)、モデル ID、対応するパラメーターの組み合わせを確認します。拒否応答や出力上限による停止は、HTTP エラーとは異なります。リクエストやストリームが中断した場合は、再試行前にログを確認してください。新しいリクエストでは追加料金が発生することがあります。

## モデルの参考資料 [#モデルの参考資料]

* [モデルの概要](https://platform.claude.com/docs/en/models/fable-5-2/overview)
* [Messages リファレンス](https://platform.claude.com/docs/en/api/beta/messages/create)
* [思考](https://platform.claude.com/docs/en/build-with-claude/thinking)
