モデルとモダリティの実践ガイド2026年10月21日Flatkey Team

Claude Sonnet API（2026年）：Sonnet 5.5のモデルID、設定、レート制限、コード

Claude Sonnet 5.5をAPIで呼び出すためのすべて：モデルID、キー、動くコード、effortと思考設定、レート制限、コスト、移行時の修正点。

Claude Sonnet API（2026年）：Sonnet 5.5のモデルID、設定、レート制限、コード

Claude Sonnet APIを使うには、AnthropicのAPIキーを作成し、モデルID claude-sonnet-5-5 を指定して https://api.anthropic.com/v1/messages にリクエストを送ります。これは2026年9月28日にリリースされた現行のSonnetモデルです。コンテキストウィンドウは100万トークン、最大出力は128K、適応型思考（adaptive thinking）がデフォルトで有効で、2026年10月21日時点のAnthropic公式料金は入力100万トークンあたり$2、出力100万トークンあたり$10です。Sonnet 4.6以前からコードを移行する場合、以前は使えた5つのリクエスト設定が400エラーを返すようになっています。詳しくは後述します。

本記事は、Claudeでプロダクトを開発するエンジニア向けに、呼び出すべきSonnetのモデルID、キーの取得方法、curl・Python・Node.jsの動作するコード、ティア別のレート制限、移行時につまずきやすい破壊的変更をまとめたものです。全Claudeモデルのコスト内訳はClaude API料金ガイドをご覧ください。

APIで利用できるClaude Sonnetモデル

モデル	APIモデルID	ステータス（2026年10月21日）	コンテキスト / 最大出力	100万トークンあたり入力 / 出力	キャッシュ読み取り
Claude Sonnet 5.5	`claude-sonnet-5-5`	現行、2026年9月28日リリース	1M / 128K	$2 / $10	$0.10
Claude Sonnet 5	`claude-sonnet-5`	レガシー	モデルドキュメント参照	$2 / $10	$0.20
Claude Sonnet 4.6	`claude-sonnet-4-6`	レガシー	モデルドキュメント参照	$3 / $15	$0.30
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	非推奨、2026年11月30日に提供終了	モデルドキュメント参照	$3 / $15	$0.30

料金はAnthropicの料金ページ、モデルのステータスはモデル概要と非推奨ページ、Sonnet 5.5の仕様はSonnet 5.5の概要より。いずれも2026年10月21日に確認しました。

どれを使うべきか： 新規開発には claude-sonnet-5-5 を使いましょう。移行ガイドによると、トークン単価はSonnet 5と同じですが、キャッシュ読み取りは半額（100万トークンあたり$0.10対$0.20）です。Sonnet 4.6（$3 / $15）と比べるとSonnet 5.5のほうがトークン単価は安いものの、トークナイザーには注意が必要です。Anthropicによれば、同じテキストでもSonnet 5.5はSonnet 4.6より約30%多くトークンを生成するため、定価ではなく実際のトークン数で比較してください。Sonnet 4.5の利用者は、2026年11月30日の提供終了までに移行する必要があります。

Sonnet 5.5の概要

項目	値	出典
モデルID（Claude API、Google Cloud、Microsoft Foundry、Claude Platform on AWS）	`claude-sonnet-5-5`	概要
Amazon BedrockのモデルID	`anthropic.claude-sonnet-5-5`	概要
コンテキストウィンドウ	100万トークン	概要
最大出力	128Kトークン。Batch APIでベータヘッダー `output-300k-2026-03-24` を付けると300K	概要
入出力モダリティ	テキストと画像を入力、テキストを出力	概要
思考	適応型、デフォルトで有効。最も低い設定は `between_tools`	概要
デフォルトのeffort	`high`	概要
知識のカットオフ	2026年6月	概要
提供終了	2027年9月28日より前には終了しない	概要

Claude Sonnet APIキーの取得方法

Claude Consoleにサインインし、API keysを開きます。
キーを作成し、一度だけコピーして、環境変数またはシークレットマネージャーに ANTHROPIC_API_KEY として保存します。
クレジットを追加するか支払い方法を登録します。利用ティア（とレート制限）は支出に応じて上がります。詳しくは後述のレート制限の章を参照してください。

1つのキーですべてのClaudeモデルを利用でき、「Sonnet専用のAPIキー」は存在しません。Claude、GPT、Gemini、DeepSeekを1つのキーで使いたい場合は、Flatkeyのような統合APIなら全モデル共通のキーを発行できます（末尾で紹介します）。

はじめてのClaude Sonnet 5.5リクエスト

以下のリクエストは、AnthropicのSonnet 5.5移行ガイドにある公式サンプルに沿ったものです。effortレベルを指定し、このモデルで400を返す設定はすべて避けています。

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-sonnet-5-5",
    "max_tokens": 4096,
    "messages": [{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    "output_config": {"effort": "medium"}
  }'

Python（公式 anthropic SDK）：

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY

response = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Write a SQL query that finds churned customers in the last 30 days."}],
    output_config={"effort": "medium"},
)

print("stop_reason:", response.stop_reason)
for block in response.content:
    if block.type == "text":  # adaptive thinking may add thinking blocks first
        print(block.text)

Node.js（@anthropic-ai/sdk）：

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY

const response = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,
  messages: [{ role: "user", content: "Write a SQL query that finds churned customers in the last 30 days." }],
  output_config: { effort: "medium" },
});

const text = response.content.find((b) => b.type === "text");
console.log(response.stop_reason, text?.text);

レスポンスはブロックの種類ごとに読み取ってください。適応型思考が有効な場合、最初のコンテンツブロックが thinking ブロックになることがあるため、Sonnet 5.5で response.content[0].text を直接読むのは安全ではありません。

Sonnet 5.5のeffortと思考設定

Sonnet 5.5では、固定の思考予算に代わって output_config 内の effort を使います（effortのドキュメント）。デフォルトは high です。Anthropicの移行ガイドには low、medium、high、xhigh、max の各レベルが示されています。

やりたいこと	送る内容	Anthropicドキュメントの補足
デフォルトの動作	何も送らない、または `thinking: {"type": "adaptive"}`	適応型思考はデフォルトで有効
より安く速い回答	`output_config: {"effort": "low"}` または `"medium"`	effortが低いほど出力トークンが減る
事前の思考なし	`thinking: {"type": "between_tools"}`	`low`、`medium`、`high` で利用可。`xhigh` や `max` では400
最も難しい問題	`output_config: {"effort": "xhigh"}` または `"max"`	`between_tools` ではなく適応型思考を使う

Sonnet 5.5は thinking: {"type": "disabled"} を受け付けません。最も低い設定は between_tools です（移行ガイド）。

400エラーを返すようになった設定

Sonnet 4.6以前からアップグレードする場合は、以下を削除してください。5つすべてがAnthropicのSonnet 5.5移行ガイドに記載されています。

旧設定	Sonnet 5.5での挙動	置き換え先
`thinking: {"type": "enabled", "budget_tokens": N}`	400エラー	`output_config.effort`
`temperature`、`top_p`、`top_k`	400エラー	プロンプトでの指示、effort
アシスタントのプリフィル（最後のメッセージが `assistant`）	400エラー	構造化出力またはシステム指示
強制 `tool_choice`（`any` または特定ツール）	400エラー	`auto` と明確なツール指示
`thinking: {"type": "disabled"}`	400エラー	`thinking: {"type": "between_tools"}`

Sonnet 4.6と比べてトークン数が約30%増えるため、max_tokens とコスト見積もりも見直してください。アップグレード後にモデルIDのエラーが出る場合は、Claudeのモデルバージョンが見つからないとAnthropicの400エラーのガイドでよくある原因を解説しています。

Claude Sonnet APIのレート制限

Anthropicはレート制限ページでティアごとの上限を公開しています。2026年10月21日時点のSonnet 5.5の値は次のとおりです。

ティア	1分あたりのリクエスト数	1分あたりの入力トークン	1分あたりの出力トークン
Start	1,000	2,000,000	400,000
Build	5,000	5,000,000	1,000,000
Scale	10,000	10,000,000	2,000,000

Sonnet 5、Sonnet 4.x、Haiku 5.5も各ティアで同じ値です。Anthropicによると、ほとんどのモデルではキャッシュから読み取った入力トークンは1分あたりの入力トークン制限にカウントされません。つまりプロンプトキャッシュはコスト削減だけでなくレート制限対策にもなります。

Sonnet 5.5の実際のコスト

2026年10月21日時点の公式料金（100万トークンあたり、料金）：

項目	料金
入力	$2.00
出力	$10.00
キャッシュ書き込み（5分）	$2.50
キャッシュ書き込み（1時間）	$4.00
キャッシュ読み取り	$0.10
Batch API 入力 / 出力	$1.00 / $5.00
米国内限定の推論（`inference_geo`）	全トークン料金が1.1倍

計算例：月50,000件のリクエストを処理するサポートアシスタントで、各リクエストに3,000トークンのキャッシュ済みシステムプロンプト、500トークンの新規入力、400トークンの出力があるとします。キャッシュ読み取り：1億5,000万トークン × $0.10 = $15。新規入力：2,500万 × $2 = $50。出力：2,000万 × $10 = $200。合計は月約$265（初回のキャッシュ書き込みは除く）です。コストの大半は出力なので、入力の最適化よりも effort の調整が効きます。モデルごとの比較はClaude API料金とClaudeとGPTのAPIルーティングをご覧ください。

OpenAI SDKでClaude Sonnetを使う

Anthropicは https://api.anthropic.com/v1/ でOpenAI互換エンドポイントを提供していますが、OpenAI SDK互換性ページでは、テストや比較向けであり、多くの本番用途には向かないとされています。関数呼び出しの strict パラメータは無視され、response_format も無視され、プロンプトキャッシュには対応していません。Sonnet 5.5を本番で使うなら、上記のネイティブMessages APIを使ってください。選択肢の詳細はClaude APIとOpenAI SDKの互換性の記事で解説しています。

Sonnetも他のモデルも1つのキーで：Flatkey

プロダクトでGPT、Gemini、DeepSeekも使うなら、Flatkeyなら1つのキーと1つのプリペイド残高ですべてをまかなえます。2026年10月21日時点で、FlatkeyのClaude Sonnet 5.5モデルページは100万トークンあたり入力$1.60 / 出力$8.00で、Anthropicの$2 / $10より20%安く、Sonnet 4.6は$2.40 / $12.00でした。FlatkeyのAnthropic SDKガイドによれば、Anthropic SDKのbase URLを https://router.flatkey.ai（/v1 なし）に変えるだけで動作します。

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Draft a release note for v2.3."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Claude Codeの設定についてはClaude CodeのAPIルーター設定を参照してください。リリース当日の特定のベータヘッダーや企業契約など、Anthropic自身のプラットフォームでしか得られない機能や契約が必要な場合は、Anthropicを直接利用しましょう。

よくある質問

Claude Sonnet APIのモデル名は？

2026年10月21日時点で、現行のモデルIDはClaude API、Google Cloud、Microsoft Foundry、Claude Platform on AWSでは claude-sonnet-5-5、Amazon Bedrockでは anthropic.claude-sonnet-5-5 です。旧IDには claude-sonnet-5 や claude-sonnet-4-6 があります。

Claude Sonnet APIの料金は？

2026年10月21日に確認したAnthropicの料金ページによると、Claude Sonnet 5.5は入力100万トークンあたり$2、出力100万トークンあたり$10で、キャッシュ読み取りは$0.10、Batch APIは半額（$1 / $5）です。

Claude Sonnet APIは無料で使えますか？

いいえ。AnthropicのAPIはトークン単位の従量課金で、Sonnetに無料のAPI枠はありません。一般向けのClaudeアプリには独自の無料・有料プランがありますが、API課金とは別物です。他社の無料オプションは無料LLM APIガイドをご覧ください。

Claude Sonnet 5.5のコンテキストウィンドウは？

100万トークンで、1リクエストあたり最大128Kトークンを出力できます。Message Batches APIでベータヘッダー output-300k-2026-03-24 を付ければ300Kまで出力可能です。

アップグレード後、Sonnetへのリクエストが400エラーになるのはなぜ？

Sonnet 5.5は、思考予算、temperature/top_p/top_k、アシスタントのプリフィル、ツールの強制選択、thinking: {"type": "disabled"} を拒否します。これらを削除し、output_config.effort または thinking: {"type": "between_tools"} を使ってください。