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





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

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

| 設定                        | Claude Opus 5.5   |
| ------------------------- | ----------------- |
| モデル ID                    | `claude-opus-5-5` |
| コンテキストウィンドウ               | 1M トークン           |
| 同期応答の最大出力                 | 思考を含む 128000 トークン |
| 思考モード                     | 適応型、常に有効          |
| effort の既定値               | `medium`          |
| 強制ツール呼び出し（`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-opus-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-opus-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-opus-5-5`。                                                                                                                                    |
| `max_tokens`                                                                                              | 整数             | はい  | —                      | 0–128000。思考に使うトークンを含みます。`0` はプロンプトキャッシュの事前作成のみを行います。                                                                                                  |
| `messages`                                                                                                | オブジェクト配列       | はい  | —                      | `user` と `assistant` のターンを交互に指定します。`content` は文字列またはコンテンツブロック配列。最後のターンは `user` が必要です。ただし `pause_turn` 応答を継続する場合は、その内容を最後の `assistant` メッセージとして送り返します。 |
| `system`                                                                                                  | 文字列またはオブジェクト配列 | いいえ | —                      | システムプロンプト。                                                                                                                                            |
| `thinking`                                                                                                | オブジェクト         | いいえ | `{"type": "adaptive"}` | 適応型の思考が常に有効です。`display` は `omitted`（既定）または `summarized`。                                                                                              |
| `output_config.effort`                                                                                    | 列挙値            | いいえ | `medium`               | `low`、`medium`、`high`、`xhigh`、`max`。モデルの思考量を調整します。                                                                                                    |
| `output_config.format`                                                                                    | オブジェクト         | いいえ | —                      | 構造化出力用の JSON スキーマ。                                                                                                                                    |
| `stop_sequences`                                                                                          | 文字列配列          | いいえ | —                      | 指定した文字列のいずれかを生成すると停止します。                                                                                                                              |
| `stream`                                                                                                  | 真偽値            | いいえ | `false`                | サーバー送信イベントとして応答をストリーミングします。                                                                                                                           |
| `temperature`                                                                                             | 数値             | いいえ | —                      | 後方互換性のため `1`（既定）のみ受け付けます。他の値は 400 エラーになります。省略してください。                                                                                                  |
| `top_p`                                                                                                   | 数値             | いいえ | —                      | 後方互換性のため `0.99` から `1` の値のみ受け付けます。他の値は 400 エラーになります。省略してください。                                                                                         |
| `top_k`                                                                                                   | 整数             | いいえ | —                      | 受け付けません。どの値でも 400 エラーになります。省略してください。                                                                                                                  |
| `tools`                                                                                                   | オブジェクト配列       | いいえ | —                      | ツールの定義。                                                                                                                                               |
| `tool_choice`                                                                                             | オブジェクト         | いいえ | —                      | `auto` または `none`。このモデルはツールの強制呼び出し（`any` または `tool`）に対応していません。                                                                                        |
| `metadata.user_id`                                                                                        | 文字列            | いいえ | —                      | エンドユーザーを表す、個人情報を直接含まない識別子。最大 512 文字。                                                                                                                  |
| `cache_control`                                                                                           | オブジェクト         | いいえ | —                      | 最上位のプロンプトキャッシュの区切り位置。                                                                                                                                 |
| `container`, `context_management`, `mcp_servers`, `diagnostics`, `service_tier`, `inference_geo`, `speed` | —              | いいえ | —                      | ネイティブ API の任意フィールド。この接続で除外されるフィールドは「現在の API 対応範囲」を確認してください。                                                                                           |

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

Claude Opus 5.5 は常に適応型思考を使います。思考量はモデルが判断し、`output_config.effort` で調整できます。effort を高くすると、通常は出力トークン数、待ち時間、料金が増えます。`thinking.display` を `summarized` にすると、表示に使える `thinking` ブロックが応答に含まれます。`omitted` では省略されます。思考トークンは出力トークンとして課金されます。

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

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

`claude-opus-5-5`

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

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

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

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

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

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

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

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

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

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