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

인증

Authorization
string
header
필수

##모든 인터페이스는 Bearer Token 인증이 필요합니다##

API Key 받기:

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

사용 시 요청 헤더에 추가:

본문

application/json
model
enum<string>
기본값:kimi-k3.1-pro
필수

kimi-k3.1-pro 또는 kimi-k3.1-pro-highspeed를 사용하세요. Highspeed는 생성 속도가 더 빠릅니다.

사용 가능한 옵션:
kimi-k3.1-pro,
kimi-k3.1-pro-highspeed
messages
object[]
필수

대화 메시지입니다. 여러 턴 대화에서는 과거 assistant 메시지 전체를 포함하세요.

Minimum array length: 1
max_completion_tokens
integer
기본값:131072

추론과 최종 답변을 포함한 최대 생성 토큰 수입니다. 기본값은 131072, 최대값은 1048576이며 남은 컨텍스트의 제한도 받습니다.

필수 범위: 1 <= x <= 1048576
reasoning_effort
enum<string>
기본값:max

추론 강도입니다. low / high / max를 권장하며 기본값은 max입니다. 추론은 항상 활성화됩니다. 호환용 값 medium은 high, xhigh는 max, minimal / none은 low로 처리됩니다. none도 추론을 끄지 않습니다. 강도가 높으면 보통 추론 토큰과 지연 시간이 늘어납니다. 추론 토큰은 출력에 포함됩니다.

사용 가능한 옵션:
low,
high,
max,
medium,
xhigh,
minimal,
none
stream
boolean
기본값:false

응답을 SSE 스트림으로 반환할지 여부입니다.

tools
object[]

함수 도구 또는 웹 검색입니다. 검색은 {"type":"web_search"}로 선언합니다.

Maximum array length: 128
tool_choice

모델이 도구를 호출할지 또는 특정 함수를 강제로 호출할지 제어합니다.

사용 가능한 옵션:
auto,
none,
required
prompt_cache_options
object

컨텍스트 캐시 쓰기 옵션입니다. 생략하면 5m 캐시에 자동으로 기록합니다. 쓰기와 읽기는 별도로 과금됩니다.

response_format
object

출력 형식입니다. text는 일반 텍스트, json_object는 JSON 객체, json_schema는 지정한 JSON Schema를 따르는 구조화 출력입니다.

max_tokens
integer
지원 중단

이전 클라이언트용 출력 제한 별칭입니다. 새 요청에는 max_completion_tokens를 사용하고 둘을 동시에 지정하지 마세요.

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

응답

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

id
string
object
string
예시:

"chat.completion"

created
integer
model
string
예시:

"kimi-k3.1-pro"

choices
object[]
usage
object