Skip to main content
POST
/
v1
/
messages
Messages (Anthropic 호환)
curl --request POST \
  --url https://api.k-router.com/v1/messages \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "model": "<string>",
  "messages": [
    {}
  ],
  "max_tokens": 123,
  "system": "<string>",
  "stream": true,
  "temperature": 123,
  "top_p": 123,
  "stop_sequences": [
    {}
  ]
}
'

​
POST /v1/messages

Anthropic Messages API와 호환되는 엔드포인트입니다. 기존 Anthropic SDK에서 base_url과 api_key만 변경하면 바로 사용할 수 있습니다.

​
헤더

​
x-api-key
string
required
kr-your-api-key. Authorization: Bearer kr-... 형식도 지원합니다.
​
Content-Type
string
required
application/json
​
anthropic-version
string
Anthropic API 버전. 선택사항입니다. 예: 2023-06-01

​
요청 본문

​
model
string
required
모델 ID. kr/claude-sonnet-46, kr/claude-opus-46 등.
​
messages
array
required
메시지 배열. 각 메시지는 role (user, assistant)과 content (문자열 또는 content blocks)를 포함합니다.
​
max_tokens
integer
required
최대 출력 토큰 수.
​
system
string
시스템 프롬프트. 문자열 또는 content blocks 배열.
​
stream
boolean
default:"false"
true 시 SSE 스트리밍 응답.
​
temperature
number
default:"1.0"
0~1. 낮을수록 결정적, 높을수록 창의적.
​
top_p
number
Nucleus sampling 파라미터.
​
stop_sequences
array
생성을 중단할 문자열 목록.

​
응답

200 - 성공
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "안녕하세요! 무엇을 도와드릴까요?"
    }
  ],
  "model": "kr/claude-sonnet-46",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 10,
    "output_tokens": 15
  }
}

​
예시

from anthropic import Anthropic

client = Anthropic(
    api_key="kr-your-api-key",
    base_url="https://api.k-router.com"  # /v1 없이! SDK가 자동 추가
)

response = client.messages.create(
    model="kr/claude-sonnet-46",
    max_tokens=1024,
    system="당신은 도움이 되는 어시스턴트입니다.",
    messages=[{"role": "user", "content": "안녕하세요"}]
)
print(response.content[0].text)

​
스트리밍

# SSE 스트리밍
with client.messages.stream(
    model="kr/claude-sonnet-46",
    max_tokens=1024,
    messages=[{"role": "user", "content": "안녕하세요"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
base_url 설정 시 /v1을 포함하지 마세요. Anthropic SDK는 자동으로 /v1/messages 경로를 추가합니다. https://api.k-router.com만 입력하세요.