テキストモデル上級者向け更新日
POST/v1/messages
Claude Sonnet 5.5
リクエスト ID claude-sonnet-5-5
プロトコル
POST /v1/messages· Anthropic Messagesの例POST /v1/messages/count_tokens· Count Tokensの例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
- Anthropic Messages ·
x-api-key: YOUR_API_KEY
リクエストパラメータ
POST /v1/messages
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に claude-sonnet-5-5 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
messages[].content[] | object | 条件付き | 画像は type: image のコンテンツブロックを使い、画像データを source に入れます。対応形式は接続先によって異なります。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
max_tokens | integer | 必須 | 出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
thinking.type | string | 任意 | adaptive または between_tools を使用します。後者はツール呼び出しの間だけ推論します。 |
output_config.effort | string | 条件付き | 推論の強度です。選べる強度と推論を無効にできるかはモデルと接続先によって異なります。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | object | 条件付き | 通常のツールには type: auto を使います。このモデルは any または tool による通常のツールの強制呼び出しに対応しません。 |
POST /v1/messages/count_tokens
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に claude-sonnet-5-5 を指定します。 |
messages | object[] | 必須 | user と assistant のメッセージを順に送信します。システム指示は最上位の system に入れます。 |
messages[].content | string / object[] | 必須 | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
messages[].content[] | object | 条件付き | 画像は type: image のコンテンツブロックを使い、画像データを source に入れます。対応形式は接続先によって異なります。 |
system | string / object[] | 任意 | システム指示。テキストまたはテキストブロックの配列を指定します。 |
tools | object[] | 条件付き | 入力トークンの計算に含めるツール定義。Messages リクエストと同じツールを送信します。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Count Tokens
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "claude-sonnet-5-5",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
レスポンスの読み取り
- Anthropic Messages ·
content[]からタイプがtextのブロックを取得します。ストリーミングでは SSE のコンテンツブロックイベントを順に処理します。 JSON · SSE - Count Tokens ·
input_tokensから入力トークン数を取得します。
機能と制限
streaming· 対応tool_calling· 対応image_input· 条件付き対応 — 互換エンドポイントとリクエスト形式によって異なりますvideo_input· 非対応
互換エイリアスと廃止済みリダイレクト
claude-sonnet-4-5,claude-sonnet-4-5-20250514,claude-sonnet-4-5-20250929,claude-sonnet-4-6→claude-sonnet-5-5(廃止済みリダイレクト)
関連ガイド
Claude Code のインストール・API 設定・Windows トラブル対処
Claude Code のインストールから API Key・接続先の設定、Windows・macOS・Linux の確認方法、認証エラーや接続障害への対処、Desktop・Kimi・GLM の設定まで解説します。
Anthropic Messages
Anthropic Messages 形式で HTTP リクエストを送信します。Claude Code を設定する場合は関連記事を参照してください。
モデル機能カタログ
公開されているテキスト・画像・動画モデルについて、正規化されたリクエスト ID、互換プロトコル、対応クライアント、ツール利用、入出力機能、制限、確認日を比較できます。