Claude Haiku 5.5 APIを使うには、https://api.anthropic.com/v1/messages に対して、"model": "claude-haiku-5-5"、x-api-key ヘッダー、anthropic-version: 2023-06-01 を含むPOSTリクエストを送信します。プロンプトが10万トークンまでの場合、料金は入出力トークン100万あたり $0.10/$0.50（それ以上は $0.50/$2.50）です。最大100万トークンのコンテキストを読み取り、最大12万8千トークンを書き込みます。適応的思考が有効な medium エフォートがデフォルトです。
Anthropicは2026年10月7日にHaiku 5.5をリリースしました。これはエフォートレベルを持つ最初のHaikuです（Claude Haiku 5.5とはで仕様と位置付けを解説しています）。この記事では、curl、Python、TypeScriptでの最初の呼び出しに加え、エフォート、思考、キャッシング、バッチ、拒否、エージェントツールセットを実装ベースで説明します。以下のリクエストはすべてApidogに保存し、アサートできます。
Claude Haiku 5.5 API の概要
| パラメータ | Haiku 5.5 の動作 |
|---|---|
| モデルID |
claude-haiku-5-5（Bedrock: anthropic.claude-haiku-5-5）。別エイリアスなし |
| MTokあたりの価格（10万トークンまでのプロンプト） | 入力 $0.10、出力 $0.50、キャッシュ読み取り $0.01
|
| MTokあたりの価格（10万トークンを超えるプロンプト） | 入力 $0.50、出力 $2.50、キャッシュ読み取り $0.05
|
| コンテキスト / 最大出力 |
1M / 128K。output-300k-2026-03-24 ベータヘッダーを使うバッチでは 300K
|
output_config.effort |
low、medium（デフォルト）、high、xhigh、max
|
thinking |
デフォルトで adaptive。disabled は high エフォート以下のみ |
thinking.display |
デフォルトでは thinking フィールドは空。summarized は読みやすいテキストを返す |
temperature、top_p、top_k
|
非デフォルト値は400を返す |
| アシスタントプリフィル | 思考がオフでも400を返す |
| キャッシュ可能な最小プロンプト | 512トークン（Haiku 4.5では4,096） |
出典: Haiku 5.5 モデルページ および Claude API 料金ドキュメント。
Claude Haiku 5.5 API の最初の呼び出し
Claude Consoleでキーを作成し、ANTHROPIC_API_KEY として環境変数に設定します。Anthropic API キーガイドも参照してください。キーをソースコードへ直接貼り付けないでください。
curl
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-haiku-5-5",
"max_tokens": 4096,
"output_config": {"effort": "medium"},
"thinking": {"type": "adaptive", "display": "summarized"},
"messages": [{
"role": "user",
"content": "Classify this ticket as billing, bug, or feature request: The export button times out on large projects."
}]
}'
Python
Python SDKは環境変数 ANTHROPIC_API_KEY を自動的に取得します。
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-haiku-5-5",
max_tokens=4096,
output_config={"effort": "medium"},
thinking={"type": "adaptive", "display": "summarized"},
messages=[{
"role": "user",
"content": "Classify this ticket as billing, bug, or feature request: The export button times out on large projects."
}],
)
for block in response.content:
if block.type == "thinking":
print("[thinking]", block.thinking)
elif block.type == "text":
print(block.text)
print(response.stop_reason, response.usage)
TypeScript
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
const response = await client.messages.create({
model: "claude-haiku-5-5",
max_tokens: 4096,
output_config: { effort: "medium" },
thinking: { type: "adaptive", display: "summarized" },
messages: [
{
role: "user",
content:
"Classify this ticket as billing, bug, or feature request: The export button times out on large projects.",
},
],
});
for (const block of response.content) {
if (block.type === "text") {
console.log(block.text);
}
}
console.log(response.stop_reason, response.usage);
実装時は次の3点を守ってください。
response.content[0].textを前提にしない
応答がthinkingブロックから始まることがあります。必ずblock.typeで分岐してテキストを取り出します。max_tokensに思考トークンの余裕を含める
思考トークンもmax_tokensにカウントされます。サポート外パラメータを送らない
temperature、top_p、top_k、budget_tokens、アシスタントプリフィルは、このモデルでは400エラーになります。
Haiku 4.5から移行する場合は、Haiku 5.5 vs Haiku 4.5 ガイドで変更前後のJSONと破壊的変更を確認してください。
エフォートレベルを選択する
output_config.effort は、品質、レイテンシ、コストを調整する主要な設定です。プロンプティングガイドでは、次の使い分けが示されています。
-
low: 最も安価で高速。チャット、短いツールタスク、単純な大量リクエスト向け。 -
medium: デフォルト。エージェントコーディングを含む大半の用途はここから開始。 -
high: ナレッジワーク、長いエージェントタスク、厳密な指示遵守向け。 -
xhigh/max: 評価で改善が確認できる場合にのみ利用。AnthropicはSonnet 5.5でも同じ評価を実行して比較することを推奨しています。
AnthropicのローンチチャートにあるOSWorld 2.1（オフラインサブセット）の結果は以下のとおりです。
| エフォート | スコア | 試行あたりのコスト |
|---|---|---|
low |
42.0% | $0.0695 |
medium |
53.3% | $0.1257 |
high |
61.3% | $0.1827 |
xhigh |
67.6% | $0.2792 |
max |
72.4% | $0.6111 |
xhigh から max に上げると、5点未満のスコア向上に対してコストは2倍以上になります。まずは実際のプロンプトで low、medium、high を比較し、必要な場合だけ上げてください。Haiku 5.5 ベンチマーク分析には、エフォート別の追加チャートがあります。
また、マルチターンチャットで xhigh を使う場合、モデルが思考をすべて書き込み、可視テキストなしでターンを終了することがあります。ユーザーに応答を返す前に、テキストブロックが存在するか確認してください。
思考の制御
適応的思考はデフォルトでオンです。Haiku 4.5と比べると、実装上は次の2点が重要です。
- デフォルト表示では思考テキストは非表示です。
thinkingブロックには空のthinkingフィールドとsignatureのみが返されます。 - ログやUIで要約を表示したい場合は、
"display": "summarized"を指定します。
{
"thinking": {
"type": "adaptive",
"display": "summarized"
}
}
思考量を減らしたい場合は、プロンプトで直接回答を促すのではなく、エフォートを下げてください。Anthropicのテストでは、直接回答を促しても思考は停止しませんでした。
思考を無効化できるのは high 以下のエフォートだけです。
{
"model": "claude-haiku-5-5",
"max_tokens": 1024,
"thinking": {"type": "disabled"},
"output_config": {"effort": "low"},
"messages": [{
"role": "user",
"content": "Extract the invoice number from: INV-2291, due Nov 3."
}]
}
xhigh または max で同じ設定を送ると400エラーになります。
強制された tool_choice（any または特定ツール）は受け入れられますが、応答はツール呼び出しから開始し、思考ブロックは含まれません。
マルチターンやエージェントループでは、返された思考ブロックをそのまま履歴に追加してください。思考ブロックの前にある system、tools、過去の messages を変更すると400エラーになる場合があります。また、思考ブロックは生成したアカウント、またはリンクされたアカウントでのみ利用できます。
プロンプトのキャッシュとバッチジョブ
キャッシュを使うと、安定したプロンプトプレフィックスのコストを下げられます。10万トークンまでのプロンプトでは、キャッシュ読み取りは100万トークンあたり $0.01 で、新規入力の $0.10 より安価です。
- 5分キャッシュ書き込み:
$0.125 - 1時間キャッシュ書き込み:
$0.20 - キャッシュ可能な最小プロンプト: 512トークン
Haiku 4.5の最小値は4,096トークンだったため、Haiku 5.5では短いシステムプロンプトやツールリストもキャッシュ対象にできます。
安定したプレフィックスに cache_control を指定します。
{
"model": "claude-haiku-5-5",
"max_tokens": 1024,
"system": [{
"type": "text",
"text": "You are a support triage assistant. <long, stable policy text here>",
"cache_control": {"type": "ephemeral"}
}],
"messages": [{
"role": "user",
"content": "Ticket: refund not received after 10 days."
}]
}
リクエスト間でトップレベルの effort を変更するとキャッシュは無効になります。一方、メッセージごとのエフォートは、mid-conversation-output-config-2026-07-01 ベータヘッダーを使うClaude APIおよびGoogle Cloudでキャッシュを保持します。
TTLについてはプロンプトキャッシングのドキュメント、概念についてはプロンプトキャッシング解説を参照してください。
待機できるワークロードには、Message Batches APIを使えます。入出力料金は50%削減されます。
| プロンプト長 | 入力 | 出力 |
|---|---|---|
| 10万トークンまで | $0.05 / MTok |
$0.25 / MTok |
| 10万トークン超 | $0.25 / MTok |
$1.25 / MTok |
また、output-300k-2026-03-24 ベータヘッダーを使うバッチは、30万出力トークンに到達できる唯一の経路です。
10万トークンを超えるプロンプトには高額な料金が適用されます。設計時にはプロンプトサイズを計測してください。Haiku 5.5 料金ガイドで料金境界の例を確認できます。
stop_reason: "refusal" を処理する
Haiku 5.5はリクエストを拒否できるセーフティ分類器を実行します。サーバー側のフォールバックはありません。拒否時には次のような応答になります。
{
"stop_reason": "refusal"
}
カテゴリには cyber、frontier_llm、bio、general_harms があります。Haiku 4.5から移行する場合、これらの拒否は新しい挙動です。
拒否を盲目的にリトライしないでください。同じリクエストを再送しても、通常は別の拒否が返されます。stop_reason を先に確認し、通常応答と分けて処理します。
def run(client, messages):
response = client.messages.create(
model="claude-haiku-5-5",
max_tokens=4096,
messages=messages,
)
if response.stop_reason == "refusal":
details = getattr(response, "stop_details", None)
category = getattr(details, "category", "unknown")
log_refusal(category, messages) # 独自のログ処理
return {"status": "refused", "category": category}
text = "".join(
block.text
for block in response.content
if block.type == "text"
)
return {"status": "ok", "text": text}
拒否されたリクエストは、人間のレビューまたは別モデルへのルーティングを検討してください。cyber または bio 分類器によって正当なセキュリティ・ライフサイエンス業務がブロックされるチームは、Anthropicのサイバー検証プログラムまたはライフサイエンス検証プログラムに申請できます。
コンピューター利用とブラウザー利用
Claude APIとGoogle Cloudでは、Haiku 5.5は computer_toolset_20260801 ツールセットでコンピューター利用をサポートします。ベータヘッダーは不要です。
古い computer_20250124 を宣言すると400エラーになります。
ブラウザー利用には browser_toolset_20260801 を使用します。これはHaiku 4.5ではサポートされていません。PythonおよびTypeScript SDKは、リリース日に両ツールセット向けのベータクラスを追加しました。
利用可能なツールメンバーについては、コンピューター利用ツールに関するドキュメントを確認してください。
レート制限
Haiku 5.5のレート制限はHaiku 4.5と同じです。
| ティア | リクエスト/分 | 入力トークン/分 | 出力トークン/分 |
|---|---|---|---|
| Start | 1,000 | 2M | 400K |
| Scale | 最大10,000 | 10M | 2M |
Priority Tierはサポートされていません。429エラーの実装パターンは、レート制限超過ガイドを参照してください。
ApidogでClaude Haiku 5.5 APIをテストする
保存済みリクエストを使うと、エフォートごとの比較、拒否のデバッグ、キャッシュ動作の確認を繰り返せます。Apidogでの設定手順は以下のとおりです。
環境を作成し、
ANTHROPIC_API_KEYをシークレット変数として追加します。x-api-keyヘッダーには{{ANTHROPIC_API_KEY}}を設定し、anthropic-version: 2023-06-01とcontent-type: application/jsonを追加します。https://api.anthropic.com/v1/messagesへのPOSTリクエストを作成し、最初の呼び出しのJSONを貼り付けて保存します。-
次のアサーションを追加します。
- HTTPステータスが
200 -
$.stop_reasonがend_turn -
$.usage.output_tokensが0より大きい -
$.content[*].typeにtextが含まれる
- HTTPステータスが
これにより、拒否や空の xhigh 応答をテストで検出できます。
リクエストを
low、high、xhigh、max用に複製し、フォルダーを実行します。自分のプロンプトに対する各エフォートのusageを比較できます。キャッシュ済みシステムプロンプトのバリアントを追加し、2回目の実行で
$.usage.cache_read_input_tokensが0より大きいことをアサートします。
より広いテストパターンについては、LLMアプリケーションのテストを参照してください。
よくある質問（FAQ）
Claude Haiku 5.5のモデルIDは何ですか？
Claude API、Google Cloud、Microsoft Foundry、およびAWS上のClaude Platformでは claude-haiku-5-5 です。日付サフィックスや別個のエイリアスはありません。Amazon Bedrockでは anthropic.claude-haiku-5-5 を使います。
Claude Haiku 5.5 APIの無料版はありますか？
常時提供される無料ティアはありません。ただし、新しいAPIユーザーにはAPIテスト用の少額の無料クレジットが付与されます。
無料の Claude.ai ユーザーはチャットでHaiku 5.5を選択できますが、これはAPIキーではありません。MaxおよびTeamプランには月額APIクレジットが含まれるようになりました。無料アクセスガイドで対象範囲を確認してください。
Haiku 4.5向けのリクエストが400エラーを返すのはなぜですか？
以下の項目を確認してください。
budget_tokens- 非デフォルトの
temperature top_ptop_k- アシスタントプリフィル
- 古い
computer_20250124ツール
これらが一般的な原因です。
Claude CodeでHaiku 5.5を使用できますか？
はい。v2.1.293以降で使用できます。Anthropic APIでは、haiku エイリアスはHaiku 5.5に解決されます。詳細はClaude CodeでのClaude Haiku 5.5を参照してください。
エージェントコーディングにはHaiku 5.5とSonnet 5.5のどちらを使うべきですか？
Anthropicは、Sonnet 5.5とOpus 5.5が「複雑なエージェントコーディングタスクにはより良い選択肢のままである」と述べています。
Haiku 5.5は、分類、要約、圧縮、サブエージェント、ブラウザー利用など、狭い範囲の作業に使ってください。
次のステップ
まず最初のリクエストを medium で送信してください。次に、実際のワークロードから選んだ同一プロンプトを low と high で実行し、usage.output_tokens、レイテンシ、回答品質を比較します。
Apidogをダウンロードして、3つのリクエストとアサーションを保存しておくと、次のモデルリリース時にはモデルIDや設定フィールドを変更するだけで再評価できます。
Top comments (0)