Source: https://aiprimetech.io/ja/docs/api-reference/messages/

[ホーム](/ja/) / [ドキュメント](/ja/docs/) / Messages API 

# Messages API 

POST /v1/messages — Anthropic形式のエンドポイント：パラメータ、レスポンス構造、使用例。 

 ページをコピー [ Markdownで表示](/ja/docs/api-reference/messages.md) [ ChatGPTに質問](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claudeで質問](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

Claude Code や公式 SDK を含む、すべての Anthropic 互換クライアントが使用するエンドポイントです。 

エンドポイントPOST https://aiprimetech.io/v1/messages

認証x-api-key: sk-...

バージョンヘッダーanthropic-version: 2023-06-01

コンテンツタイプapplication/json 

## リクエストボディ 

 | 項目 | 種類 | 必須 | 説明

 | model | 文字列 | はい | 次の一覧に記載されたとおりのモデル ID： /v1/models

 | messages | 配列 | はい | user と assistant のターンを交互に、古い順に並べます

 | max_tokens | 整数 | はい | 出力トークンの最大数。この上限に達すると生成が停止します。

 | system | 文字列または配列 | いいえ | トップレベルのシステムプロンプト。メッセージのロールではありません。

 | temperature | 数値 | いいえ | 0～1。省略するとモデルのデフォルト値が使用されます。

 | top_p | 数値 | いいえ | ニュークリアスサンプリング。これと temperature のいずれかを使用し、両方は使用しないでください。

 | stop_sequences | 配列 | いいえ | 生成された時点で生成を停止する文字列

 | stream | ブール値 | いいえ | サーバー送信イベントを使用する場合は true

 | tools | 配列 | いいえ | ツール定義 — 参照： [ツールの使用](/ja/docs/api-reference/tool-use/)

 | metadata | オブジェクト | いいえ | そのまま渡されます。 user_id は独自の利用者識別に役立ちます 

## 例 

```
Copycurl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

## レスポンス 

```
Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}
```

 | 項目 | 説明

 | content | ブロックの配列。テキストブロックには次が含まれます： type: text および text フィールド。ツール呼び出しには次が含まれます： type: tool_use.

 | stop_reason | end_turn, max_tokens, stop_sequence または tool_use

 | usage.input_tokens | 課金対象の入力。再送した履歴全体を含みます

 | usage.output_tokens | 課金対象の出力 — 通常、入力単価の 4～5 倍 

## システムプロンプト 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}
```

内容が変わらない system ブロックは、次の機能の理想的な対象です： [プロンプトキャッシュ](/ja/docs/guides/prompt-caching/) — 呼び出しごとに内容が同一なので、入力料金の一部の費用でキャッシュから読み取れます。 

## マルチモーダル入力 

画像ブロックは標準の Anthropic 形式を使用します — 参照： [画像認識](/ja/docs/api-reference/vision/). 

[ストリーミングトークンごとの出力](/ja/docs/api-reference/streaming/)[ツールの使用関数呼び出し](/ja/docs/api-reference/tool-use/)[エラー障害のパターン](/ja/docs/api-reference/errors/) 

[前へAPIの概要](/ja/docs/api-reference/overview/)[次へChat Completions API](/ja/docs/api-reference/chat-completions/)