API

앤트로픽 메시지 생성

요약

앤트로픽의 Message API는 Claude 모델을 기반으로 작동하며, 사용자와의 대화 흐름을 이해하고 이에 맞는 응답을 생성합니다. 대화 내용은 messages 필드에 입력하며, 요청 시 다양한 설정을 통해 스트리밍 또는 비스트리밍 방식의 응답을 받을 수 있습니다. 이미지 블록 삽입, 외부 도구 사용, 시스템 프롬프트 지정 등 고급 기능도 함께 제공합니다.

SDK: 앤트로픽 SDK
공식 문서: 앤트로픽 공식 문서

API	지원 모델
anthropic/messages	`claude-sonnet-4-5-20250929` `claude-opus-4-5-20251101` `claude-haiku-4-5-20251001`

메시지 생성

POST

/v1/api/anthropic/messages

Claude 모델은 입력된 메시지 배열을 기반으로 자연스러운 대화 응답을 생성합니다. 시스템 프롬프트, 도구 호출, 이미지 입력, 스트리밍 출력 등을 조합해 활용할 수 있습니다.

요청 헤더

Authorization: Bearer {api-key}

파라미터

model

string

required

응답 생성을 위해 사용할 모델 ID입니다. Claude 3 이상의 모델을 사용하는 것이 권장되며, 더 넓은 기능 범위를 제공합니다. 예시: claude-sonnet-4-5-20250929

messages

array

required

모델에 전달할 대화 메시지 배열입니다. base64로 인코딩된 이미지를 포함할 수 있습니다. 전체 구조는 Messages를 참고하세요.

messages는 user와 assistant 역할이 번갈아 구성된 배열이어야 하며, system 역할은 별도의 system 필드로 설정해야 합니다.

이미지 입력 시에는 base64 인코딩과 함께 media_type을 반드시 지정해야 합니다. 지원되는 포맷은 jpeg, png, gif, webp입니다.

max_tokens

integer

required

생성할 최대 토큰 수입니다. 모델은 이 값을 초과하지 않도록 응답을 종료합니다. 상한은 모델 리스트마다 다릅니다.

system

string

모델의 역할 또는 동작을 정의하는 시스템 프롬프트입니다.

stream

boolean

스트리밍 응답을 받을지 여부입니다. 기본값: false

stream이 활성화되면 응답은 Server-Sent Events 방식으로 실시간 전달되며, 토큰 단위로 수신됩니다. thinking, tool_choice, tools와 같은 기능은 Claude 3 이상에서 지원됩니다.

마지막 수정 날짜: Nov 28, 2025

에러 코드

/models/generate-content