Source: https://aiprimetech.io/ja/docs/getting-started/first-request/

[ホーム](/ja/) / [ドキュメント](/ja/docs/) / 最初のリクエストの解説 

# 最初のリクエストの解説 

Messages呼び出しを行ごとに解説します。各フィールドの役割と返される内容を説明します。 

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

クイックスタートではレスポンスを取得できます。このページでは各部分の意味を説明し、次のリクエストを自分で書けるようにします。 

## リクエスト 

```
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"}]
  }'
```

 | 項目 | 必須 | 役割

 | model | はい | 実行するモデル。次の一覧にあるIDと /v1/models 完全に一致する必要があります。

 | max_tokens | はい | 厳格な上限を設定する対象は 出力です。モデルは文の途中でも、この上限に達すると停止します。これはコストを制御するための値であり、目標値ではありません。

 | messages | はい | これまでの会話を古い順に並べたものです。各項目には role (user または assistant）と content.

 | system | いいえ | 会話全体に適用する指示です。最上位のフィールドであり、次の値を持つメッセージではありません： role: system.

 | temperature | いいえ | 0〜1。値が低いほど出力が一定になります。理由がなければ未設定のままにしてください。

 | stream | いいえ | true は、単一のJSON本文ではなく、サーバー送信イベントを返します。参照先： [ストリーミング](/ja/docs/api-reference/streaming/). 

## レスポンス 

```
Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "Hello! How can I help?"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 9, "output_tokens": 12}
}
```
 
- content は配列です。文字列ではありません。テキストの格納先は content[0].textです。これを文字列として扱うことが、最もよくあるクライアント側のバグです。
- stop_reason は、生成が終了した理由を示します： end_turn （完了）、 max_tokens （設定した上限に到達し、応答が途中で切れた）、 stop_sequence、または tool_use.
- usage が課金の基準です。ログに記録してください。コストの帰属を判断するための唯一の信頼できる根拠です。 

もし stop_reason は max_tokensの場合、回答は途中で切れています。引き上げる設定は max_tokens です。または、より短い回答を求めてください。むやみに再試行しないでください。途中で切れた出力にも料金がかかります。 

## 複数ターンの会話 

APIは状態を保持しません。会話を続けるには、モデルの過去の応答も含めて履歴全体を再送します。 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"},
    {"role": "assistant", "content": "Paris."},
    {"role": "user", "content": "And its population?"}
  ]
}
```

毎ターン履歴を再送するため、会話が長くなるほど入力トークン数が増え、料金も増加します。長いエージェントセッションが高額になるのは、このためです。 [プロンプトキャッシュ](/ja/docs/guides/prompt-caching/) と [コンテキスト管理](/ja/docs/guides/context-management/) はいずれも、この問題に直接対処します。 

[Messages API全フィールドのリファレンス](/ja/docs/api-reference/messages/)[ストリーミングトークン単位のレスポンス](/ja/docs/api-reference/streaming/)[Python SDKPythonでの同じ呼び出し](/ja/docs/sdks/python/) 

[前へベースURL](/ja/docs/getting-started/base-urls/)[次へAPIの概要](/ja/docs/api-reference/overview/)