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

[홈](/ko/) / [문서](/ko/docs/) / Messages API 

# Messages API 

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

 페이지 복사 [ Markdown으로 보기](/ko/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 | 배열 | 예 | 사용자와 어시스턴트의 대화 턴을 번갈아 배치하며, 가장 오래된 턴부터 정렬

 | max_tokens | 정수 | 예 | 최대 출력 토큰 수. 이 한도에 도달하면 생성이 중지됩니다.

 | system | 문자열 또는 배열 | 아니요 | 최상위 시스템 프롬프트. 메시지 역할이 아닙니다.

 | temperature | 숫자 | 아니요 | 0–1. 모델 기본값을 사용하려면 생략하세요.

 | top_p | 숫자 | 아니요 | 뉴클리어스 샘플링. 이 옵션과 temperature 중 하나만 사용하세요.

 | stop_sequences | 배열 | 아니요 | 생성되면 생성을 중단하는 문자열

 | stream | 불리언 | 아니요 | 서버 전송 이벤트를 사용하려면 true

 | tools | 배열 | 아니요 | 도구 정의 — 참고: [도구 사용](/ko/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 블록은 다음의 이상적인 대상입니다: [프롬프트 캐싱](/ko/docs/guides/prompt-caching/) — 호출할 때마다 동일하므로 입력 비용의 일부만으로 캐시에서 읽을 수 있습니다. 

## 멀티모달 입력 

이미지 블록은 표준 Anthropic 구조를 사용합니다. 참고: [비전](/ko/docs/api-reference/vision/). 

[스트리밍토큰 단위 출력](/ko/docs/api-reference/streaming/)[도구 사용함수 호출](/ko/docs/api-reference/tool-use/)[오류실패 유형](/ko/docs/api-reference/errors/) 

[이전API 개요](/ko/docs/api-reference/overview/)[다음Chat Completions API](/ko/docs/api-reference/chat-completions/)