Anthropic Messages

Anthropic Messages互換の構造で、メッセージとContent Blocksを送信します。

Messages APIは、userとassistantのメッセージおよびContent Blocksからモデルレスポンスを作成します。テキスト、画像、ツール呼び出し、ストリーミング出力、拡張思考に対応します。利用できるContent Blocks、ツール、高度なパラメーターは、選択したモデルと現在のAPI Keyから参照できるモデルによって異なります。

POST/v1/messages

user と assistant のメッセージから次の assistant レスポンスを生成します。メッセージ内容には文字列、またはテキスト、画像、ツール、ドキュメントの Content Blocks を使用できます。

この API は通常の JSON レスポンスと SSE ストリーミングイベントに対応します。画像入力、ツール呼び出し、拡張思考への対応は選択したモデルによって異なります。

認証

anthropicApiKey

x-api-key<token>

x-api-key Header に API Key を指定します。

指定位置: header

ヘッダーパラメーター

anthropic-version*string

使用する API バージョンを指定します。

デフォルト値"2023-06-01"

anthropic-beta?string

使用する beta バージョンを指定します。複数の値はカンマで区切るか、この Header を複数回送信できます。

リクエストボディ

Messages では、テキスト、画像、ツール、拡張思考を Content Blocks で表現します。用途に応じて表示を選択してください。

application/json

テキストチャット

user と assistant のメッセージで単一ターンまたは複数ターンの会話を構成します。system 指示はトップレベルのフィールドに指定します。

model: 現在の API キーで利用できる Messages 対応モデル ID です。
max_tokens: 今回のレスポンスで生成できる最大トークン数です。
messages[]: 時系列に並べた user と assistant のメッセージです。

application/json

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "こんにちは。自己紹介してください。"
    }
  ]
}

基本的なテキストチャットです。messages には文字列または text Content Blocks を指定できます。

model*string

使用するモデル ID です。現在の API キーで利用できる Messages 対応モデルを選択してください。

長さ1 <= length <= 256

max_tokens*integer

生成できる最大 Token 数です。上限はモデルによって異なります。0 を指定すると、レスポンスを生成せずにプロンプトキャッシュのみを作成できます。

範囲0 <= value

messages*array<>

時系列に並べたテキスト会話メッセージです。content には文字列または text Content Blocks の配列を指定できます。

項目数1 <= items

metadata?

リクエストに関連付けるメタデータです。

cache_control?|null

リクエスト内の最後のキャッシュ可能なコンテンツブロックに自動適用されるトップレベルのキャッシュ制御です。利用可否はモデルとチャネルによって異なります。

container?||null

リクエスト間でコンテナを再利用するか、コンテナに読み込む Skills を指定します。利用可否はモデル、チャネル、アカウントによって異なります。

inference_geo?string|null

推論を実行する地理的リージョンを指定します。未指定の場合はアカウントのデフォルトリージョンを使用します。利用可否はアカウントとチャネルによって異なります。

output_config?

モデル出力の設定です。各フィールドの利用可否は選択したモデルとチャネルによって異なります。

service_tier?string

リクエストで使用するサービス階層です。auto は利用可能な場合に優先キャパシティを使用し、standard_only は標準キャパシティのみを使用します。実際の対応範囲はアカウントとチャネルによって異なります。

指定可能な値

"auto"
"standard_only"

stop_sequences?array<string>

生成を停止するカスタムテキストシーケンスです。

stream?boolean

Server-Sent Events を使用してレスポンスを段階的に返すかどうかです。

デフォルト値false

system?|array<>

トップレベルの system プロンプトです。Messages の一覧では system ロールを使用しません。

temperature?number

非推奨

非推奨です。Claude Opus 4.6 以降に公開されたモデルはカスタム temperature に対応しません。旧リクエストとの互換性のため 1.0 は受け付ける場合がありますが、その他の値は 400 を返す可能性があります。新しいモデルではこのフィールドを省略してください。

範囲0 <= value <= 1

thinking?||

拡張思考の設定です。新しいモデルでは adaptive を優先し、旧モデルでは enabled と budget_tokens を引き続き使用できる場合があります。

tool_choice?||

tools?array<|||||||>

モデルが使用できるカスタムツールまたは組み込みツールです。

top_k?integer

非推奨

非推奨です。Claude Opus 4.6 以降に公開されたモデルは、すべての top_k 値を拒否して 400 を返す可能性があります。新しいモデルではこのフィールドを省略してください。

範囲1 <= value

top_p?number

非推奨

非推奨です。Claude Opus 4.6 以降に公開されたモデルでは、デフォルトに近い設定のみ限定的に互換動作し、その他の値は 400 を返す可能性があります。新しいモデルではこのフィールドを省略してください。

範囲0 < value < 1

画像、ツール、拡張思考の対応状況は、モデルとプロバイダーチャネルによって異なる場合があります。まず最小限のテキストリクエストを確認し、その後で高度なフィールドを一つずつ有効にしてください。

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/messages" \  -H "anthropic-version: 2023-06-01" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "こんにちは。自己紹介してください。"      }    ]  }'

{
  "content": [
    {
      "type": "text",
      "text": "こんにちは。私は AI アシスタントです。"
    }
  ],
  "id": "msg_example",
  "model": "MODEL_ID",
  "role": "assistant",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 16,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Anthropic Messages公式ドキュメントアップストリームプロトコルの定義と最新のフィールド変更を確認します。

認証

ヘッダーパラメーター

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`