curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

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

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

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

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

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

Responses API

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

reasoning.effort로 추론 강도, prompt_cache_options로 캐시를 설정합니다. 검색은 web_search_call 출력 항목으로 반환됩니다. 스트리밍에서는 response.completed / response.incomplete / response.failed를 처리하세요. 출력 한도에 도달하면 incomplete가 됩니다. 멀티턴 요청에는 추론, 도구 호출 및 결과를 포함한 전체 output 기록을 전달하세요.

POST

responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

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

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

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

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

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<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이며 추론이 항상 활성화됩니다.

구조화된 출력(text.format)과 캐시 쓰기 TTL(prompt_cache_options)은 K3.1 시리즈만 지원하며 kimi-k3는 지원하지 않습니다.

사용 가능한 옵션:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

input

필수

이번 요청의 입력입니다. 문자열은 user 메시지 하나와 같습니다. 배열은 유형이 있는 항목을 순서대로 담으며 대화 기록, 도구 호출 및 결과를 포함할 수 있습니다.

instructions

string

다른 지시보다 먼저 적용되는 최상위 시스템 지시입니다.

stream

boolean

기본값:false

true이면 SSE 이벤트 스트림으로 응답합니다.

max_output_tokens

integer

기본값:131072

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

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

reasoning

object

추론 관련 설정입니다.

Show child attributes

text

object

출력 텍스트 설정입니다.

Show child attributes

tools

(함수 도구 · object | 사용자 정의 도구 · object | 네임스페이스 도구 · object | 웹 검색 도구 · object)[]

모델이 호출할 수 있는 도구입니다.

type으로 구분하는 도구 정의입니다. function, custom(apply_patch만), namespace, web_search를 지원하며 다른 유형은 지원하지 않습니다.

함수 도구
사용자 정의 도구
네임스페이스 도구
웹 검색 도구

Show child attributes

tool_choice

enum<string>

도구 호출을 제어합니다. auto이면 모델이 도구 호출 여부를 결정합니다.

사용 가능한 옵션:

auto

include

enum<string>[]

추가로 반환할 필드이며 web_search 도구에만 적용됩니다. web_search_call.action.sources는 검색된 웹 출처를, web_search_call.results는 이미지 검색 결과를 반환합니다.

사용 가능한 옵션:

web_search_call.results,

web_search_call.action.sources

prompt_cache_options

object

컨텍스트 캐시 쓰기 옵션. kimi-k3.1-pro / kimi-k3.1-pro-highspeed만 지원하며 kimi-k3는 이 매개변수를 지원하지 않습니다. 생략하면 기본적으로 5m 캐시에 자동으로 기록합니다. 쓰기와 읽기는 별도로 과금됩니다.

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는 지원하지 않는 값에 대해 오류를 반환합니다.

응답

응답 생성 성공

모델 응답 하나입니다.

string

응답의 고유 식별자입니다.

예시:

"resp_68f0c1c2d3e4f5a6b7c8d9e0"

object

enum<string>

사용 가능한 옵션:

response

created_at

integer

응답 생성 시점의 Unix 타임스탬프입니다.

completed_at

integer | null

응답 종료 시점의 Unix 타임스탬프입니다. status가 completed 또는 incomplete이면 제공되며 in_progress 또는 failed이면 null입니다.

status

enum<string>

응답 상태입니다. 스트리밍 초기 스냅샷의 상태는 in_progress입니다.

사용 가능한 옵션:

in_progress,

completed,

incomplete,

failed

model

string

이번 응답을 생성한 모델입니다.

output

(추론 · object | 메시지 · object | Function Call · object | 사용자 정의 도구 호출 · object | 웹 검색 호출 · object)[]

출력 항목 배열로 web_search_call(있는 경우), reasoning, message, 도구 호출 순서입니다.

type으로 구분하는 output 배열의 요소입니다.

추론
메시지
Function Call
사용자 정의 도구 호출
웹 검색 호출

Show child attributes

usage

object | null

input_tokens는 캐시 읽기와 쓰기를 포함합니다. K3.1 시리즈의 일반 입력은 cached_tokens와 cache_write_tokens를 빼고, kimi-k3는 cached_tokens만 뺍니다. output_tokens에는 추론이 이미 포함되어 있습니다.

Show child attributes

incomplete_details

object | null

status가 incomplete일 때 제공되는 이유입니다.

Show child attributes

error

object | null

status가 failed일 때 제공되는 오류 정보입니다.

Show child attributes

instructions

string | null

reasoning

object | null

text

object | null

tools

(함수 도구 · object | 사용자 정의 도구 · object | 네임스페이스 도구 · object | 웹 검색 도구 · object)[] | null

type으로 구분하는 도구 정의입니다. function, custom(apply_patch만), namespace, web_search를 지원하며 다른 유형은 지원하지 않습니다.

함수 도구
사용자 정의 도구
네임스페이스 도구
웹 검색 도구

Show child attributes

tool_choice

enum<string> | null

도구 호출을 제어합니다. auto이면 모델이 도구 호출 여부를 결정합니다.

사용 가능한 옵션:

auto

max_output_tokens

integer | null

temperature

number | null

top_p

number | null

parallel_tool_calls

boolean

service_tier

string | null

store

boolean

항상 false입니다.

background

boolean | null

항상 false입니다.

previous_response_id

string | null

항상 null입니다.

conversation

object | null

항상 null입니다.

prompt_cache_options

object

서버가 실제로 적용한 컨텍스트 캐시 쓰기 옵션입니다. prompt_cache_options를 생략한 경우 여기서 반환되는 mode와 ttl을 기준으로 합니다.

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

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

인증

본문

응답