Messages API

POST /v1/messages

Anthropic Messages API와 호환됩니다. 게이트웨이는 구성된 Anthropic 또는 Bedrock 채널을 통해 Claude 모델로 투명하게 프록시합니다.

요청 본문

매개변수	유형	설명
`model`*	`string`	사용할 모델의 ID(예: claude-sonnet-4-6).
`messages`*	`array`	role(user/assistant)와 content를 가진 message 객체 배열.
`max_tokens`*	`integer`	생성할 최대 token 수.
`system`	`string`	대화의 컨텍스트를 설정하기 위한 시스템 프롬프트입니다.
`stream`	`boolean`	true이면 SSE 이벤트 스트림을 반환합니다. 기본값: false.
`temperature`	`number`	샘플링 온도 0–1. 기본값: 1.
`tools`	`array`	도구 사용을 위한 도구 정의 목록입니다.

요청 예시

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

응답 예시

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 9
  }
}

ℹ

Messages API는 다음 두 가지를 모두 받아들입니다 Authorization: Bearer 및 x-api-key header를 통한 인증을 받아들이며, Anthropic SDK 규칙을 따릅니다.