API

Messages

Anthropic Messages 형식입니다. Claude Code, Anthropic SDK 및 여러 에이전트가 사용합니다.

전체 가이드

POSThttps://api.ailoot.ai/v1/messages

Messages

curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "안녕! 어떤 일을 할 수 있어?"}]
  }'

import anthropic
import os

client = anthropic.Anthropic(max_retries=0, 
    base_url="https://api.ailoot.ai",   # /v1 제외: SDK가 /v1/messages를 자동으로 추가합니다
    api_key=os.environ["AILOOT_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "API가 무엇인지 두 문장으로 설명해 줘."}],
)
print(msg.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 0,
  baseURL: "https://api.ailoot.ai", // /v1 제외
  apiKey: process.env.AILOOT_API_KEY,
});

const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "API가 무엇인지 두 문장으로 설명해 줘." }],
});
console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);

200 OK

{
  "id": "msg_01H…",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "안녕하세요! 코드를 작성하고 설명하거나 질문에 답할 수 있습니다…" }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 52 }
}

인증

x-api-keyheader필수
키 sk-…. 다음도 사용할 수 있습니다: Authorization: Bearer sk-… — Claude Code는 다음 설정으로 이 방식에 따라 전송합니다: ANTHROPIC_AUTH_TOKEN.
anthropic-versionheader선택 사항
API 버전입니다. 예: 2023-06-01. SDK가 자동으로 전송합니다.

요청 본문

modelstring필수
Messages 형식을 지원하는 모델 ID입니다. Claude, GPT, Gemini, DeepSeek, Qwen 등을 포함해 식별자 776개가 있습니다.
messagesarray필수
메시지 user 및 assistant; content — 문자열 또는 블록(text, image, tool_use, tool_result).
max_tokensinteger필수
응답 토큰의 최대 수입니다. 예약 금액에 포함됩니다. 잔액이 전체 한도를 충당하지 못하면 Ailoot가 한도를 줄이지만 256 미만으로 낮추지 않습니다(사고 기능을 사용하면 1025). 새 한도는 다음 헤더로 알립니다: X-Ailoot-Max-Tokens-Capped.
systemstring | array선택 사항
시스템 지침입니다.
streamboolean선택 사항
SSE 이벤트 스트림(message_start, content_block_delta, …, message_stop). 유료 텍스트는 비용 계산 후 한 번에 전달됩니다.
temperaturenumber선택 사항
응답 무작위성은 0~1입니다.
toolsarray선택 사항
도구: name, description, input_schema.
tool_choiceobject선택 사항
auto, any, tool 또는 none.
thinkingobject선택 사항
{"type": "enabled", "budget_tokens": N} — 지원하는 모델의 사고 기능입니다.
stop_sequencesarray선택 사항
생성을 중단할 문자열입니다.

응답

contentarray
응답 블록: text, thinking, tool_use.
stop_reasonstring
end_turn, max_tokens, stop_sequence 또는 tool_use.
usageobject
input_tokens, output_tokens, 캐시 관련 필드: cache_read_input_tokens 및 cache_creation_input_tokens.

궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.지원팀에 문의

curl https://api.ailoot.ai/v1/messages \ -H "x-api-key: $AILOOT_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-5-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "안녕! 어떤 일을 할 수 있어?"}] }'

import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # /v1 제외: SDK가 /v1/messages를 자동으로 추가합니다 api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "API가 무엇인지 두 문장으로 설명해 줘."}], ) print(msg.content[0].text)

import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ maxRetries: 0, baseURL: "https://api.ailoot.ai", // /v1 제외 apiKey: process.env.AILOOT_API_KEY, }); const msg = await client.messages.create({ model: "claude-sonnet-5-5", max_tokens: 1024, messages: [{ role: "user", content: "API가 무엇인지 두 문장으로 설명해 줘." }], }); console.log(msg.content[0].type === "text" ? msg.content[0].text : msg.content);

{ "id": "msg_01H…", "type": "message", "role": "assistant", "model": "claude-sonnet-5-5", "content": [ { "type": "text", "text": "안녕하세요! 코드를 작성하고 설명하거나 질문에 답할 수 있습니다…" } ], "stop_reason": "end_turn", "usage": { "input_tokens": 14, "output_tokens": 52 } }