Kimi API(모든 모델) - Messages 전체 참조

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

POST

messages

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "max_tokens": 1024,
  "output_config": {
    "effort": "low"
  },
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ]
}
'

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<string>"
}

BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며 텍스트 모델과 장시간 연결을 더 잘 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 기본 엔드포인트이자 텍스트 모델의 대체 주소입니다.

인증

Authorization

string

header

필수

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

API Key 발급:

API Key 관리 페이지에서 API Key를 발급받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

기본값:kimi-k3.1-pro

필수

호출할 모델:

모델 ID	특성	추론 강도
`kimi-k3.1-pro`	최신 세대 모델(권장)	`low` / `high` / `max`, 기본값 `max`
`kimi-k3.1-pro-highspeed`	Pro와 동일한 매개변수, 더 빠른 생성	`kimi-k3.1-pro`와 동일
`kimi-k3`	이전 세대 모델	`max`만 지원

세 모델 모두 컨텍스트 창은 1,048,576 tokens이며 추론이 항상 활성화됩니다.

구조화된 출력(output_config.format), 중지 시퀀스(stop_sequences), 캐시 쓰기 TTL(cache_control)은 K3.1 시리즈만 지원하며 kimi-k3는 지원하지 않습니다. kimi-k3의 응답은 thinking 블록 없이 text 블록만 포함할 수 있습니다.

사용 가능한 옵션:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

max_tokens

integer

필수

thinking과 최종 텍스트를 포함해 이번 생성에 허용되는 최대 token 수입니다.

필수 범위: 1 <= x <= 1048576

messages

object[]

필수

Anthropic Messages 메시지 목록입니다. 여러 턴 대화에서는 assistant의 전체 콘텐츠 블록을 변경하지 말고 다시 전달하세요.

Minimum array length: 1

Show child attributes

system

문자열 또는 text 블록 배열 형식의 시스템 프롬프트입니다.

stream

boolean

기본값:false

Anthropic SSE 이벤트 스트림 반환 여부입니다.

tools

object[]

사용자 정의 함수 또는 서버 측 웹 검색입니다. 내장 검색은 type=web_search_20250305, name=web_search를 사용하며 실제 호출 횟수로 과금합니다.

Option 1
Option 2

Show child attributes

tool_choice

object

Show child attributes

stop_sequences

string[]

중지 시퀀스. 정확히 일치하면 출력을 중단하며 일치한 시퀀스 자체는 출력하지 않습니다. 최대 5개, 각각 32바이트 이하입니다. 일치 시 stop_reason은 end_turn, stop_sequence는 null입니다.

kimi-k3.1-pro / kimi-k3.1-pro-highspeed만 지원하며 kimi-k3는 지원하지 않습니다.

Maximum array length: 5

cache_control

object

최상위 캐시 쓰기 옵션. kimi-k3.1-pro / kimi-k3.1-pro-highspeed만 지원하며 kimi-k3는 이 매개변수를 지원하지 않습니다. 쓰기 TTL은 최상위 cache_control만 제어하며 메시지 블록 내부의 캐시 표시는 이 필드를 대체할 수 없습니다. 생략하면 기본값은 5m입니다.

Show child attributes

output_config

object

출력 설정: 추론 강도 및 구조화 출력.

Show child attributes

temperature

number

기본값:1

샘플링 온도. 모델에서 1로 고정하므로 전달할 필요가 없습니다. kimi-k3.1-pro / kimi-k3.1-pro-highspeed는 이 필드를 자동으로 무시하며 kimi-k3는 지원하지 않는 값에 대해 오류를 반환합니다.

top_p

number

기본값:0.95

핵 샘플링 임계값. 모델에서 0.95로 고정하므로 전달할 필요가 없습니다. kimi-k3.1-pro / kimi-k3.1-pro-highspeed는 이 필드를 자동으로 무시하며 kimi-k3는 지원하지 않는 값에 대해 오류를 반환합니다.

응답

Message 응답입니다. 스트리밍 요청은 Anthropic SSE 이벤트 스트림을 반환합니다

string

type

enum<string>

사용 가능한 옵션:

message

role

enum<string>

사용 가능한 옵션:

assistant

model

string

예시:

"kimi-k3.1-pro"

content

object[]

텍스트, 이미지, 추론, 도구 사용 또는 도구 결과를 위한 Anthropic 콘텐츠 블록입니다.

Show child attributes

stop_reason

enum<string> | null

사용 가능한 옵션:

end_turn,

max_tokens,

tool_use,

refusal,

null

stop_sequence

string | null

usage

object

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Kimi API(모든 모델) - Messages 전체 참조

인증

본문

응답