Kimi API(모든 모델) - 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": "컨텍스트 캐시를 한 문장으로 설명해 주세요."
}
'

{
  "id": "resp_6adc72aab1f2eaaebe6b869e",
  "object": "response",
  "created_at": 1792832171,
  "status": "completed",
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "model": "kimi-k3.1-pro",
  "output": [
    {
      "type": "message",
      "id": "msg_6adc72aab1f2eaaebe6b869f",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "컨텍스트 캐시는 요청에서 반복되는 접두사 내용을 저장하여 이후 요청이 캐시에 적중하면 더 빠르고 저렴하게 처리할 수 있게 합니다."
        }
      ],
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 24,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 96,
    "output_tokens_details": {
      "reasoning_tokens": 62
    },
    "total_tokens": 120
  }
}

{
  "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>"
  }
}

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": "컨텍스트 캐시를 한 문장으로 설명해 주세요."
}
'

{
  "id": "resp_6adc72aab1f2eaaebe6b869e",
  "object": "response",
  "created_at": 1792832171,
  "status": "completed",
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "model": "kimi-k3.1-pro",
  "output": [
    {
      "type": "message",
      "id": "msg_6adc72aab1f2eaaebe6b869f",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "컨텍스트 캐시는 요청에서 반복되는 접두사 내용을 저장하여 이후 요청이 캐시에 적중하면 더 빠르고 저렴하게 처리할 수 있게 합니다."
        }
      ],
      "status": "completed"
    }
  ],
  "usage": {
    "input_tokens": 24,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 96,
    "output_tokens_details": {
      "reasoning_tokens": 62
    },
    "total_tokens": 120
  }
}

{
  "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는 멀티모달 서비스의 기본 엔드포인트이자 텍스트 모델의 대체 주소입니다.

POST /v1/responses를 사용하고 model로 kimi-k3.1-pro, kimi-k3.1-pro-highspeed, kimi-k3를 선택합니다. model과 input만 필요합니다.

매개변수 이름은 Chat Completions와 다릅니다. 입력은 input, 출력 한도는 max_output_tokens, 추론 강도는 reasoning.effort를 사용합니다.

답변 본문 읽기

응답의 output에는 추론, 본문, 도구 호출이 함께 포함될 수 있습니다. type="message" 항목의 output_text 콘텐츠 블록을 순회하세요. 첫 항목이 본문이라고 가정하지 마세요. 응답 JSON을 response로 파싱했다면 다음과 같이 텍스트를 추출할 수 있습니다.

text = "".join(
    part["text"]
    for item in response.get("output", [])
    if item.get("type") == "message"
    for part in item.get("content", [])
    if part.get("type") == "output_text"
)
print(text)

추론을 위한 출력 예산을 확보하세요. max_output_tokens는 추론과 본문을 모두 포함합니다. status="incomplete"이고 incomplete_details.reason="max_output_tokens"라면 한도를 높이세요. 예산이 소진되면 추론 항목만 있고 본문은 없을 수 있습니다.

도구 호출, 웹 검색, 이미지 입력, 구조화된 출력은 전체 참조를 확인하세요.

인증

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`	최신 세대 모델(권장)
`kimi-k3.1-pro-highspeed`	Pro와 동일한 매개변수, 더 빠른 생성
`kimi-k3`	이전 세대 모델

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

사용 가능한 옵션:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

input

필수

이번 요청의 입력. 문자열은 하나의 user 메시지와 같고 배열은 이전 메시지를 순서대로 제공합니다.

max_output_tokens

integer

기본값:131072

추론과 최종 답변을 포함한 최대 생성 토큰 수. 기본값 131072, 최댓값 1048576.

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

reasoning

object

추론 관련 설정입니다.

Show child attributes

stream

boolean

기본값:false

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

응답

응답 생성 성공. 스트리밍 요청은 SSE 이벤트 스트림을 반환합니다

string

응답 ID.

예시:

"resp_6adc72aab1f2eaaebe6b869e"

object

enum<string>

사용 가능한 옵션:

response

예시:

"response"

created_at

integer

생성 시각. Unix 타임스탬프(초).

예시:

1792832171

status

enum<string>

응답 상태. incomplete는 일반적으로 max_output_tokens 한도에 도달했음을 의미합니다.

사용 가능한 옵션:

completed,

incomplete,

failed

예시:

"completed"

incomplete_details

object | null

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

Show child attributes

model

string

이번 호출에 사용한 모델.

예시:

"kimi-k3.1-pro"

output

object[]

출력 항목 배열. 보통 reasoning 다음에 message가 옵니다.

Show child attributes

usage

object

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Kimi API(모든 모델) - Responses 빠른 시작

답변 본문 읽기

인증

본문

응답

​답변 본문 읽기

인증

본문

응답

답변 본문 읽기