메인 콘텐츠로 건너뛰기
POST
/
v1
/
messages
메시지 생성
curl --request POST \
  --url https://api.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "claude-sonnet-4-5-20250929",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, world"
    }
  ]
}
'
{
  "model": "claude-haiku-4-5-20251001",
  "id": "msg_bdrk_017XLrAa77zWvfBGQ6ESvrxz",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "# Hey there! 👋\n\nHow's it going? What can I help you with today?"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 8,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 24
  }
}

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json
model
enum<string>
필수

프롬프트를 완성할 모델.

사용 가능한 옵션:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-opus-4-5-20251101,
claude-opus-4-6,
claude-sonnet-4-6
예시:

"claude-sonnet-4-5-20250929"

messages
InputMessage · object[]
필수

입력 메시지.

모델은 userassistant가 번갈아 나오는 대화 턴에서 작동하도록 훈련되었습니다. 새 Message를 생성할 때 messages 매개변수로 이전 대화 턴을 지정하면, 모델이 대화의 다음 Message를 생성합니다. 요청에서 연속된 user 또는 assistant 턴은 하나의 턴으로 결합됩니다.

각 입력 메시지는 rolecontent가 포함된 객체여야 합니다. 단일 user 역할 메시지를 지정하거나 여러 userassistant 메시지를 포함할 수 있습니다.

max_tokens
integer
필수

중지하기 전에 생성할 최대 토큰 수.

모델이 이 최대값에 도달하기 전에 중지할 수 있습니다. 이 매개변수는 생성할 토큰의 절대 최대 수만 지정합니다.

필수 범위: x >= 1
예시:

1024

container

로드할 스킬이 포함된 컨테이너 파라미터.

context_management
ContextManagementConfig · object

컨텍스트 관리 설정.

mcp_servers
RequestMCPServerURLDefinition · object[]

이 요청에 사용될 MCP 서버

Maximum array length: 20
metadata
메타데이터 · object

요청에 대한 메타데이터를 설명하는 객체입니다.

service_tier
enum<string>

이 요청에 우선 용량 (사용 가능한 경우) 또는 표준 용량을 사용할지 결정합니다.

사용 가능한 옵션:
auto,
standard_only
stop_sequences
string[]

모델이 생성을 중단하게 하는 사용자 정의 텍스트 시퀀스.

stream
boolean

서버 전송 이벤트를 사용하여 응답을 점진적으로 스트리밍할지 여부.

system

시스템 프롬프트.

예시:

"Today's date is 2024-06-01."

temperature
number

응답에 주입되는 무작위성의 양입니다.

기본값은 1.0입니다. 범위는 0.0에서 1.0까지입니다.

필수 범위: 0 <= x <= 1
예시:

1

thinking
워터마크 활성화 **참고:** - `true`: 생성된 비디오에 워터마크 추가 - `false`: 워터마크 없음 (기본값) · object

Claude의 확장 사고를 활성화하기 위한 설정.

tool_choice
Auto · object

모델이 제공된 도구를 사용하는 방식.

tools
(사용자 정의 도구 · object | Bash tool (2024-10-22) · object | Bash tool (2025-01-24) · object | Code execution tool (2025-05-22) · object | CodeExecutionTool_20250825 · object | Computer use tool (2024-01-22) · object | MemoryTool_20250818 · object | Computer use tool (2025-01-24) · object | 텍스트 편집기 도구 (2024-10-22) · object | 텍스트 편집기 도구 (2025-01-24) · object | 텍스트 편집기 도구 (2025-04-29) · object | TextEditor_20250728 · object | 웹 검색 도구 (2025-03-05) · object | WebFetchTool_20250910 · object)[]

모델이 사용할 수 있는 도구의 정의.

top_k
integer

각 후속 토큰에 대해 상위 K개 옵션에서만 샘플링합니다.

필수 범위: x >= 0
예시:

5

top_p
number

핵 샘플링을 사용합니다.

필수 범위: 0 <= x <= 1
예시:

0.7

응답

메시지 내용. 두 가지 형식을 지원합니다:

1. 일반 텍스트 문자열: 문자열을 직접 전달합니다, 예: "content":"자기소개를 해주세요"

2. 객체 배열 (텍스트 입력, 멀티모달 입력 지원): 아래 구조를 참조하세요

id
string
필수

고유 객체 식별자.

ID의 형식과 길이는 시간이 지남에 따라 변경될 수 있습니다.

예시:

"msg_013Zva2CMHLNnXjNJJKqJ2EF"

type
string
필수

객체 유형.

Messages의 경우, 항상 "message"입니다.

Allowed value: "message"
role
string
필수

생성된 메시지의 대화 역할.

이 값은 항상 "assistant"입니다.

Allowed value: "assistant"
content
(텍스트 · object | 사고 · object | 수정된 사고 · object | 도구 사용 · object | 서버 도구 사용 · object | 웹 검색 도구 결과 · object | ResponseWebFetchToolResultBlock · object | 코드 실행 도구 결과 · object | ResponseBashCodeExecutionToolResultBlock · object | ResponseTextEditorCodeExecutionToolResultBlock · object | MCP 도구 사용 · object | Tool Use 또는 Function Calling을 위한 도구 목록 **참고**: - 각 도구에는 type이 포함되어야 합니다 - function 구조에는 name, description, parameters가 포함되어야 합니다 - tools 배열에 최대 128개의 함수 · object | 컨테이너 업로드 · object)[]
필수

모델이 생성한 콘텐츠.

이것은 콘텐츠 블록의 배열이며, 각 블록은 형태를 결정하는 type을 가지고 있습니다.

model
enum<string>
필수

요청을 처리한 모델.

사용 가능한 옵션:
claude-haiku-4-5-20251001,
claude-sonnet-4-5-20250929,
claude-opus-4-1-20250805,
claude-sonnet-4-20250514,
claude-sonnet-4-6
예시:

"claude-sonnet-4-5-20250929"

stop_reason
enum<string> | null
필수

중지 이유.

사용 가능한 옵션:
end_turn,
max_tokens,
stop_sequence,
tool_use,
pause_turn,
refusal,
model_context_window_exceeded
stop_sequence
string | null
필수

생성된 사용자 정의 중지 시퀀스 (있는 경우).

usage
사용량 · object
필수

과금 및 속도 제한 사용량.

context_management
ResponseContextManagement · object

컨텍스트 관리 응답.

container
Container · object

이 요청에 사용된 컨테이너 정보.