홈 / 문서 / Messages API

Messages API

POST /v1/messages — Anthropic 형식 엔드포인트: 매개변수, 응답 구조 및 예제.

Markdown으로 보기 ChatGPT에 질문 Claude에서 질문

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`	배열	예	사용자와 어시스턴트의 대화 턴을 번갈아 배치하며, 가장 오래된 턴부터 정렬
`max_tokens`	정수	예	최대 출력 토큰 수. 이 한도에 도달하면 생성이 중지됩니다.
`system`	문자열 또는 배열	아니요	최상위 시스템 프롬프트. 메시지 역할이 아닙니다.
`temperature`	숫자	아니요	0–1. 모델 기본값을 사용하려면 생략하세요.
`top_p`	숫자	아니요	뉴클리어스 샘플링. 이 옵션과 temperature 중 하나만 사용하세요.
`stop_sequences`	배열	아니요	생성되면 생성을 중단하는 문자열
`stream`	불리언	아니요	서버 전송 이벤트를 사용하려면 true
`tools`	배열	아니요	도구 정의 — 참고: 도구 사용
`metadata`	객체	아니요	그대로 전달됩니다; `user_id` 은 자체적인 사용 출처 추적에 유용합니다

예시

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

응답

{
  "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배

시스템 프롬프트

{
  "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 블록은 다음의 이상적인 대상입니다: 프롬프트 캐싱 — 호출할 때마다 동일하므로 입력 비용의 일부만으로 캐시에서 읽을 수 있습니다.

멀티모달 입력

이미지 블록은 표준 Anthropic 구조를 사용합니다. 참고: 비전.

스트리밍토큰 단위 출력 도구 사용함수 호출 오류실패 유형