# Claude Sonnet 5.5 API (https://wanapi.app/ja/docs/claude-sonnet-5-5)





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

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

| 設定                        | Claude Sonnet 5.5      |
| ------------------------- | ---------------------- |
| モデル ID                    | `claude-sonnet-5-5`    |
| コンテキストウィンドウ               | 1M トークン                |
| 同期応答の最大出力                 | 思考を含む 128000 トークン      |
| 思考モード                     | 適応型、または between\_tools |
| 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-sonnet-5-5",
    "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-sonnet-5-5",
    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-sonnet-5-5`。                                                                                                                                                                |
| `max_tokens`                      | 整数、必須                     | 思考トークンを含む 0–128000。公式 API では 0 は出力を生成せずにプロンプトキャッシュを作成します。「現在の API 対応範囲」も確認してください。                                                                                                   |
| `messages`                        | オブジェクト配列、必須               | 会話メッセージは最低 1 件、最大 100000 件。各メッセージに `role` と `content` を指定します。content は文字列またはコンテンツブロック配列。通常のターンは `user`/`assistant` です。会話途中の `system` メッセージは公式の配置ルールに従います。                           |
| `system`                          | 文字列またはテキストブロック配列          | 最上位の指示。テキストブロックにキャッシュの区切り位置を指定できます。                                                                                                                                                 |
| `thinking`                        | オブジェクト                    | 既定は `{"type":"adaptive"}`。もう 1 つの対応モードは `{"type":"between_tools"}`。手動予算と `disabled` は拒否されます。                                                                                        |
| `thinking.display`                | 列挙値                       | 適応型モードのみ。`omitted`（既定）または `summarized`。要約の省略は、思考の無効化を意味しません。                                                                                                                        |
| `thinking.block_binding`          | オブジェクト、ベータ                | 適応型モードのみ。`thinking-binding-controls-2026-08-01` が必要です。公式の思考保持の仕様に従ってください。                                                                                                           |
| `output_config.effort`            | 列挙値または null               | `low`、`medium`、`high`、`xhigh`、`max`。既定は `high`。null では既定値を使います。                                                                                                                     |
| `output_config.format`            | オブジェクトまたは null            | 構造化 JSON 出力：`{"type":"json_schema","schema":{...}}`。対応する JSON Schema のサブセットを使います。                                                                                                   |
| `stream`                          | 真偽値                       | 既定は `false`。`true` は SSE イベントを返します。                                                                                                                                                 |
| `stop_sequences`                  | 文字列配列                     | 公式仕様では、一致する文字列で生成を停止します。上流の互換性検証では、この動作は反映されませんでした。                                                                                                                                 |
| `temperature`                     | 数値または null                | 互換性のため 1 のみ受け付けます。省略してください。それ以外の null でない値は拒否されます。                                                                                                                                  |
| `top_p`                           | 数値または null                | 互換性のため 0.99–1 のみ受け付けます。省略してください。                                                                                                                                                    |
| `top_k`                           | null 以外は不可                | サンプリング設定には対応していません。このプロパティは省略してください。                                                                                                                                                |
| `tools`                           | オブジェクト配列                  | クライアントツールには `name`、`input_schema`、任意の説明や厳密性の設定を指定します。サーバーツールはバージョン付きの公式定義を使います。                                                                                                     |
| `tool_choice`                     | オブジェクト                    | `auto`（既定）または `none`。`any` と名前を指定した強制 `tool` は拒否されます。`auto` には `disable_parallel_tool_use` を指定できます。                                                                                 |
| `metadata.user_id`                | 文字列または null               | 最大 512 文字。個人情報を直接含まない識別子を使ってください。                                                                                                                                                   |
| `cache_control`                   | オブジェクトまたは null            | `type: "ephemeral"`、`ttl: "5m"`（既定）または `"1h"`。Sonnet 5.5 ではキャッシュ可能なトークンが最低 512 必要です。公式 API はブロック単位のキャッシュ区切りにも対応しています。                                                               |
| `diagnostics`                     | オブジェクトまたは null            | `previous_message_id`：最大 256 文字の文字列または null。キャッシュの差異の診断を要求します。                                                                                                                      |
| `service_tier`                    | 列挙値                       | `auto`（既定）または `standard_only`。                                                                                                                                                      |
| `speed`                           | 列挙値または null               | 省略するか、`standard` / null を指定します。Sonnet 5.5 は `fast` に対応していません。                                                                                                                       |
| `inference_geo`                   | 文字列または null               | 公式の既定値はアカウント設定で決まります。リクエストが受理されただけでは、処理地域は確認できません。                                                                                                                                  |
| `fallbacks`                       | 文字列、オブジェクト配列、または null、ベータ | `"default"` または最大 3 件のフォールバック設定。各設定に `model` が必要で、`max_tokens`、`thinking`、`output_config`、`speed` を任意で上書きできます。フォールバックのルールも確認してください。                                                 |
| `fallback_credit_token`           | 文字列、オブジェクト、または null       | 以前の拒否応答に含まれるトークン、または `{"token":"...","mode":"strict"}`。オブジェクト形式には `fallback-credit-2026-07-01` が必要です。mode は `strict`（既定）または `best_effort`。null でない `fallbacks` との併用は不可。             |
| `container`                       | 文字列、オブジェクト、または null       | コンテナ ID、または任意の `id` と `skills`（最大 20 件）を含むコンテナ設定。スキルには公式の型、識別子、バージョンのフィールドを使います。                                                                                                    |
| `context_management`              | オブジェクトまたは null            | `edits` を含む公式のコンテキスト編集設定。null は設定の省略を意味します。モデルごとの編集互換性の制約も適用されます。                                                                                                                   |
| `mcp_servers`                     | オブジェクト配列                  | 公式の MCP サーバー定義。必要なベータバージョンとサーバー認証に従います。空の配列による疎通確認だけでは、リモート MCP の実行は検証できません。                                                                                                        |
| `compaction`                      | オブジェクトまたは null、ベータ        | `compact-2026-09-04` と `{"type":"summarize"}` を指定します。null は圧縮の省略を意味します。有効な圧縮は、null でない `context_management`、停止文字列、構造化出力形式と併用できません。署名付き圧縮の動作は現在の検証を通過していません。                         |
| `messages[].output_config.effort` | 列挙値、ベータ                   | system メッセージ単位の effort。`mid-conversation-output-config-2026-07-01` が必要です。effort のみの system メッセージはどこにでも置けます。本文を含む system メッセージ群は公式の配置ルールに従います。`between_tools` モードでは effort を変更できません。 |

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

`between_tools` では `type` プロパティと、effort の `low`、`medium`、`high` のみを受け付けます。`display`、`budget_tokens`、`block_binding` は同時に送らないでください。例：

```json
{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "thinking": {"type": "between_tools"},
  "output_config": {"effort": "medium"},
  "messages": [{"role": "user", "content": "Explain this concept briefly."}]
}
```

assistant の事前入力には対応していません。`pause_turn` を継続するには、返されたサーバーツールの assistant コンテンツを変更せずに再送します。圧縮は既存の履歴を要約するもので、assistant の事前入力ではありません。思考ブロックと署名を完全に保持してください。公式の紐づけルールに従わずに、モデル間で移動したり過去の履歴を編集したりしないでください。

ネイティブ Claude API でのコンピューター操作には `computer_toolset_20260801` が必要で、`computer_20251124` は拒否されます。この実行モデルでは、`claude-opus-4-8`、`claude-opus-4-7`、`claude-sonnet-5` を指定した Advisor 設定も拒否されます。

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

画像と 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 Sonnet 5.5

`claude-sonnet-5-5`

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

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

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

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

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

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

```json
{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "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-sonnet-5-5","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK."}]}'
```

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

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

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

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

* [Sonnet 5.5 公式概要](https://platform.claude.com/docs/en/models/sonnet-5-5/overview)
* [Sonnet 5.5 の変更点と制約](https://platform.claude.com/docs/en/models/sonnet-5-5/whats-new-sonnet-5-5)
* [Messages パラメーターリファレンス](https://platform.claude.com/docs/en/api/messages/create)
* [メッセージ単位の effort](https://platform.claude.com/docs/en/build-with-claude/effort)
* [オンデマンド圧縮](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand)
* [拒否応答とフォールバック](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback)
* [フォールバッククレジット](https://platform.claude.com/docs/en/build-with-claude/fallback-credit)
