첫 요청 설명

Messages 호출 하나를 줄별로 살펴보며 각 필드의 역할과 반환되는 내용을 설명합니다.

빠른 시작을 따라 하면 응답을 받을 수 있습니다. 이 페이지에서는 각 부분의 의미를 설명하므로, 다음 요청은 직접 작성할 수 있습니다.

요청

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": "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 은 요금 청구의 기준입니다. 로그에 기록하세요. 비용을 귀속하는 데 신뢰할 수 있는 유일한 기준입니다.

여러 턴의 대화

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?"}
  ]
}