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





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

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

| 設定                        | Claude Haiku 5.5   |
| ------------------------- | ------------------ |
| モデル ID                    | `claude-haiku-5-5` |
| 同期応答の最大出力                 | 思考を含む 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-haiku-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-haiku-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-haiku-5-5`。                                                                         |
| `max_tokens`            | はい  | 思考を含む 0–128000 の整数。API の既定値はありません。                                                          |
| `messages`              | はい  | ロールと文字列またはコンテンツブロック配列を持つ 1–100000 件のメッセージ。会話のルールは後述します。                                     |
| `system`                | いいえ | 文字列またはテキストブロック配列。null は不可。                                                                  |
| `thinking`              | いいえ | 既定は適応型。無効化も可能です。手動のトークン予算やツール間の思考モードには対応していません。                                             |
| `output_config`         | いいえ | `effort`、`format`、任意のベータ機能 `task_budget` を含むオブジェクト。                                         |
| `stop_sequences`        | いいえ | 生成を停止する文字列の配列。                                                                              |
| `stream`                | いいえ | 真偽値。既定は false。                                                                              |
| `temperature`           | いいえ | 省略してください。この接続では破棄されます。公式 API の互換用の値は 1 です。                                                  |
| `top_p`                 | いいえ | 省略してください。この接続では破棄されます。公式 API の互換用の値は 0.99 です。                                               |
| `top_k`                 | いいえ | 非対応のため破棄されます。                                                                               |
| `tools`                 | いいえ | クライアントツールまたは公式サーバーツールの宣言の配列。                                                                |
| `tool_choice`           | いいえ | `auto`、`none`、`any`、名前を指定した `tool`。強制ツール呼び出しに対応しています。                                       |
| `metadata`              | いいえ | オブジェクト。任意の `user_id` は最大 512 文字の文字列、または null。                                               |
| `cache_control`         | いいえ | null または `{"type":"ephemeral","ttl":"5m"}`。TTL は `1h` も指定できます。既定の TTL は 5m。                 |
| `container`             | いいえ | null、コンテナ ID の文字列、または任意の ID と最大 20 件のスキルを含むオブジェクト。                                          |
| `context_management`    | いいえ | null、または公式のコンテキスト編集を含むオブジェクト。対応するベータヘッダーが必要です。                                              |
| `mcp_servers`           | いいえ | 最大 20 件の URL サーバーの配列。対応する MCP ベータヘッダーが必要です。                                                 |
| `service_tier`          | いいえ | `auto` または `standard_only`。Haiku に Priority Tier の処理枠はありません。                                |
| `inference_geo`         | いいえ | `global`、`us`、または null。省略時はアカウントの既定値を使います。処理地域は、報告された使用状況を確認して判断してください。                     |
| `diagnostics`           | いいえ | null またはオブジェクト。`previous_message_id` は null、または最大 256 文字の文字列。                               |
| `compaction`            | いいえ | null または `{"type":"summarize","instructions":"..."}`。instructions は任意で null も可、最大 16384 文字。 |
| `fallbacks`             | いいえ | 対応するベータで null または `default`。Haiku に自動フォールバック先モデルはなく、明示的なリストは無効です。                           |
| `fallback_credit_token` | いいえ | null、トークン文字列、または `{token,mode}`。API 側で対象資格と有効性の検証が必要です。任意のモデルを対象にできるとは限りません。                |
| `speed`                 | いいえ | `standard` または null。Fast モードには対応していません。                                                     |

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

既定は effort が **medium** の適応型思考で、思考テキストは省略されます。effort には `low`、`medium`、`high`、`xhigh`、`max`、または既定値を使う null を指定できます。

```json
{
  "thinking": {"type": "adaptive", "display": "summarized"},
  "output_config": {"effort": "medium"}
}
```

思考を無効にするには、low、medium、high のいずれかの effort と `{"type":"disabled"}` を使います。無効モードでは `display` や `block_binding` を含めないでください。`enabled`、`budget_tokens`、`between_tools`、および xhigh/max の effort で思考を無効にする指定は無効です。

適応型の `display` は `omitted`、`summarized`、または null を受け付けます。汎用のベータ値 `updates` には `thinking-display-updates-2026-08-18` が必要です。Anthropic は現在、Haiku で読める形式の進捗更新を保証していないため、その出力には依存しないでください。

任意の `thinking.block_binding` には `thinking-binding-controls-2026-08-01` が必要です。null、または `prefix_mismatch_behavior` が `error`、`drop_block`、null のいずれかであるオブジェクトを指定します。履歴を再送する際は、以前の会話ターンと完全な思考ブロックを変更せずに保持してください。思考の署名は、それを生成したアカウントまたはそのアカウントにリンクされたアカウントに紐づきます。

`output_config.task_budget` は null、または `{ "type": "tokens", "total": 20000 }` で、任意の整数/null の `remaining` を含められます。`task-budgets-2026-03-13` が必要で、`total` は最低 20000 です。ここでは `remaining` にそれ以外の範囲制限は設けていません。

### ツールと構造化出力 [#ツールと構造化出力]

クライアントツールには、英字、数字、アンダースコア、ハイフンからなる 1–128 文字の名前と、`type: "object"` の `input_schema` が必要です。宣言したツールを強制的に呼び出すには、`tool_choice: {"type":"any"}` または `{"type":"tool","name":"lookup"}` を使います。適応型思考でツールを強制すると、応答は思考ブロックを挟まずにツール呼び出しから始まります。

`disable_parallel_tool_use` は auto、any、tool の選択で使える任意の真偽値です。none にはこのフィールドはありません。ツールの結果は元の `tool_use_id` とともに返します。クライアントツールはアプリケーションが実行します。

```json
{
  "tools": [{
    "name": "lookup",
    "description": "Look up a product by SKU.",
    "input_schema": {
      "type": "object",
      "properties": {"sku": {"type": "string"}},
      "required": ["sku"],
      "additionalProperties": false
    }
  }],
  "tool_choice": {"type": "tool", "name": "lookup"}
}
```

構造化応答には `output_config.format: {"type":"json_schema","schema":{...}}` を使います。オブジェクトの `additionalProperties: false` など、Anthropic が対応する JSON Schema のサブセットに従ってください。形式が正しくても、値の事実上の正しさは保証されません。厳密なツールと構造化出力にはスキーマ全体の制限があります。[公式の構造化出力リファレンス](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)を確認してください。

コンピューター操作には `computer_toolset_20260801` が必要です。古い computer ツールのバージョンは無効です。ブラウザー操作には専用の `browser_toolset_20260801` があります。ツールを宣言しただけでは、サーバーツールの一連のセッションが動作することを検証したことにはなりません。使用前に、そのツールの公式ガイドと必要なベータ要件を確認してください。

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

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

`claude-haiku-5-5`

| 課金対象トークン | claude · デフォルト · 入力トークン数 ≤ 100,000 | claude · デフォルト · 入力トークン数 > 100,000 |
| --- | ---: | ---: |
| 入力（未キャッシュ） | $0.05 | $0.25 |
| 出力 | $0.25 | $1.25 |
| キャッシュ読み取り | $0.005 | $0.025 |
| キャッシュ書き込み · 5 分 | $0.0625 | $0.3125 |
| キャッシュ書き込み · 1 時間 | $0.1 | $0.5 |

しきい値の基準：未キャッシュの入力トークン数。選ばれた料金区分は、しきい値を超えた分だけでなく、リクエスト全体に適用されます。

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

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

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

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

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

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

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

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

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

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

* [Haiku 5.5 モデルの概要](https://platform.claude.com/docs/en/models/haiku-5-5/overview)
* [Haiku 5.5 移行ガイド](https://platform.claude.com/docs/en/models/haiku-5-5/migration-guide)
* [Messages リファレンス](https://platform.claude.com/docs/en/api/messages/create)
* [ベータ Messages リファレンス](https://platform.claude.com/docs/en/api/beta/messages/create)
* [思考](https://platform.claude.com/docs/en/build-with-claude/thinking), [effort](https://platform.claude.com/docs/en/build-with-claude/effort), [タスク予算](https://platform.claude.com/docs/en/build-with-claude/task-budgets)
* [オンデマンド圧縮](https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand), [コンテキスト編集](https://platform.claude.com/docs/en/build-with-claude/context-editing)
* [プロンプトキャッシュ](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), [画像認識](https://platform.claude.com/docs/en/build-with-claude/vision), [PDF 対応](https://platform.claude.com/docs/en/build-with-claude/pdf-support)
