Claude Sonnet 5.5

Anthropic Messages 形式で claude-sonnet-5-5 を呼び出します。このドキュメントでは、公式のリクエスト仕様と互換性テストで観察された動作を区別しています。一部の高度なオプションは、現時点では仕様どおりに動作しません。使用する前に制限事項を確認してください。

現在の入力、出力、キャッシュの料金はモデルページで確認できます。

クイックスタート

curl https://api.seedrouter.ai/v1/messages \
  -H "x-api-key: $SEEDROUTER_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 how a rainbow forms in three sentences."}]
  }'

POST /v1/messages は x-api-key または Bearer 認証と、anthropic-version: 2023-06-01 を受け付けます。公式ドキュメントで beta ヘッダーが必要とされる機能には、anthropic-beta を送信してください。認証情報はサーバー側のコードで管理してください。

このモデルは、基本的な OpenAI Chat Completions（POST /v1/chat/completions）と Responses（POST /v1/responses）のリクエストも受け付けます。以下のネイティブパラメーターには Messages を使用してください。OpenAI 形式の変換では、Anthropic のすべての機能を利用できるわけではありません。

公式パラメーター仕様

Sonnet 5.5 のコンテキストウィンドウは 1M トークンで、同期リクエストの出力上限は 128000 トークンです。Batch 固有の出力制限は、このエンドポイントには適用されません。表に明記されている場合を除き、アプリケーションは省略可能なプロパティにデフォルト値を設定しません。

between_tools は自身の type プロパティのみを受け付け、エフォートは low、medium、high に限られます。display、budget_tokens、block_binding は併せて送信しないでください。例：

{
  "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 設定も拒否されます。

フォールバックのリクエストフィールド

公式の fallbacks beta は、対象となる分類器による拒否を再試行します。レート制限、過負荷、サーバーエラーは再試行せず、再試行後も拒否が解消されない場合があります。server-side-fallback-2026-07-01 を送信すると、"default" または明示的なリストを使用できます。server-side-fallback-2026-06-01 はリストのみに対応しています。それ以外の日付付きバージョンは拒否されます。

明示的なリストには、異なるモデルを最大三件指定できます。いずれもリクエストしたモデルと同じにはできません。許可される対象モデルは、beta Models API の allowed_fallback_models で取得します。各項目で指定できるのは model、max_tokens、thinking、output_config、speed のみです。上書きする値は、対象モデルで有効である必要があります。該当するフォールバックが発生すると、七月版 beta は Sonnet 5.5 の between_tools を Sonnet 5 の disabled に変換し、display を省略します。六月版 beta では、Sonnet 5 の思考設定の上書きを自分で指定してください。

fallback_credit_token は、拒否の後に別途行う再試行のための項目です。文字列形式では厳格なクレジット適用が選択され、オブジェクト形式では mode を追加できます。strict モードでは、クレジットの適用に失敗すると再試行は拒否されます。best_effort モードでは、トークン処理層で失敗した場合、通常料金で処理を続行でき、その内容が usage.fallback_credit に記録されます。ただし、トークンの形式が不正な場合や、クレジットを fallbacks と併用した場合は引き続き失敗します。適用には、公式クレジットガイドに記載されたリクエストの資格、アカウント、ワークスペース、プラットフォーム、五分間の期限に関する条件も満たす必要があります。

無害な内容のリクエストで fallbacks: "default"、七月版 beta ヘッダー、speed: "standard" を指定したところ、期待したテキストが返りました。これで確認できるのはリクエストの受理だけです。フォールバックの実行とクレジットの適用は、ここではエンドツーエンドで検証されていません。

メディアとツールの入力

画像はユーザーメッセージ内の image ブロック、PDF は document ブロックを使用します。公式のソース型には、公開 URL と、対応する MIME タイプを伴う base64 が含まれます。互換性チェックでは base64 の PNG と一ページの base64 PDF を使い、回答内容を確認しました。すべての URL、ファイルサイズ、画像解像度、PDF ページ数の境界条件をテストしたわけではありません。

クライアント側のツールは、標準の tool_use → tool_result のやり取りを使用します。ツール使用 ID を変更せず、結果をユーザーメッセージで返してください。厳格モードのツールの例が成功しても、確認できるのはその例の引数であり、対応するすべての JSON Schema キーワードではありません。

レスポンス

非ストリーミングのレスポンスには、id、type: "message"、role: "assistant"、model、content、stop_reason、stop_sequence、usage が含まれます。また、container、diagnostics、context_management、stop_details、beta レスポンスフィールドなど、任意の公式フィールドを含む場合があります。コンテンツにはテキスト、思考、ツール呼び出し、ツール結果、その他の公式ブロック型が含まれるため、最初のブロックがテキストとは限りません。

ストリーミングでは、message_start、content_block_start、content_block_delta、content_block_stop、message_delta、message_stop を処理してください。ストリームの途中でエラーが発生することもあります。使用量には、通常の入力/出力トークン、思考トークンの詳細、キャッシュ読み取り、保存期間が 5 分 / 1 時間のキャッシュ作成トークン数（それぞれ個別に集計）などが含まれます。

公式の分類器による拒否は、HTTP エラーではなく、stop_reason: "refusal" と stop_details を含む通常のレスポンスです。フォールバックのレスポンスでは、model が回答したモデルを示し、fallback コンテンツブロックが切り替えを記録し、usage.iterations が各試行を説明します。リクエストしたモデルが回答したと決めつけず、これらのフィールドを確認してください。これらのレスポンス動作は、ここでは未検証です。

Messages のエラーは {"type":"error","error":{"type":"...","message":"..."}} 形式です。失敗したリクエストは課金されません。

互換性の検証：2026-10-01

Beta ツールの実行、実際の MCP 接続、Files API の参照、地理的なデータレジデンシー、思考署名の再送、コンテキスト/出力の上限全体、メディアの境界条件、拒否/フォールバックの動作は、エンドツーエンドで検証されていません。HTTP 200 と返されたモデル名だけでは、実際にどのモデルが実行されたかを証明できず、渡したすべてのオプションが有効になったことも確認できません。

参考資料

• Sonnet 5.5 の公式概要
• Sonnet 5.5 の変更点と制限
• Messages パラメーターリファレンス
• メッセージごとのエフォート
• オンデマンドコンパクション
• 拒否とフォールバック
• フォールバッククレジット
• OpenAPI スキーマ
• コピー可能な Markdown