Kimi K3.1 Pro

요청 ID k3.1-pro

프로토콜

POST /v1/chat/completions · Chat Completions 예시
POST /v1/messages · Anthropic Messages 예시
POST /v1/messages/count_tokens · Count Tokens 예시
POST /v1/responses · OpenAI Responses 예시
POST /v1/responses/compact · Responses Compact 예시

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

Authorization: Bearer YOUR_API_KEY
Anthropic Messages · x-api-key: YOUR_API_KEY

요청 매개변수

`POST /v1/chat/completions`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `k3.1-pro`로 설정하세요.
`messages`	`object[]`	필수	대화 순서대로 메시지를 보냅니다. 각 메시지에는 `role`과 `content`가 들어갑니다.
`messages[].content`	`string / object[]`	조건부	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`messages[].content[]`	`object`	조건부	이미지에는 `type: image_url` 콘텐츠 블록을 사용합니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`max_completion_tokens`	`integer`	조건부	해당하는 추론 토큰을 포함한 생성 토큰 수의 상한입니다. 이 필드를 지원하는 엔드포인트에서 사용하세요.
`max_tokens`	`integer`	조건부	출력 토큰 제한을 위한 호환 필드입니다. 엔드포인트에 따라 이 필드와 `max_completion_tokens` 중 하나를 사용하세요.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`response_format`	`object`	조건부	구조화된 출력에는 `type: json_object`를 사용하거나, 스키마를 지원할 때 `type: json_schema`와 `json_schema`를 함께 지정하세요.
`reasoning_effort`	`string`	조건부	요청할 추론 강도입니다. 사용 가능한 단계와 추론을 끌 수 있는지는 모델과 엔드포인트에 따라 다릅니다.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`string / object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/messages`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `k3.1-pro`로 설정하세요.
`messages`	`object[]`	필수	`user`와 `assistant` 메시지를 순서대로 보내세요. 시스템 지침은 최상위 `system`에 넣습니다.
`messages[].content`	`string / object[]`	필수	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`messages[].content[]`	`object`	조건부	이미지에는 `type: image` 콘텐츠 블록을 사용하고 데이터를 `source`에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`system`	`string / object[]`	선택	시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
`max_tokens`	`integer`	필수	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/messages/count_tokens`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `k3.1-pro`로 설정하세요.
`messages`	`object[]`	필수	`user`와 `assistant` 메시지를 순서대로 보내세요. 시스템 지침은 최상위 `system`에 넣습니다.
`messages[].content`	`string / object[]`	필수	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`messages[].content[]`	`object`	조건부	이미지에는 `type: image` 콘텐츠 블록을 사용하고 데이터를 `source`에 넣습니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`system`	`string / object[]`	선택	시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
`tools`	`object[]`	조건부	입력 토큰 계산에 포함할 도구 정의입니다. 실제 Messages 요청과 같은 도구를 전달하세요.

`POST /v1/responses`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `k3.1-pro`로 설정하세요.
`input`	`string / object[]`	필수	입력 텍스트 또는 순서가 있는 입력 항목 배열입니다. 메시지 항목에는 `role`과 `content`를 사용합니다.
`input[].content[]`	`object`	조건부	이미지에는 `type: input_image` 콘텐츠 블록을 사용합니다. 허용 형식은 엔드포인트에 따라 다릅니다.
`instructions`	`string`	선택	작업과 출력 요구 사항을 지정하는 모델 지침입니다.
`max_output_tokens`	`integer`	선택	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`store`	`boolean`	조건부	이 필드를 지원하는 경우 `false`는 나중에 조회하기 위한 응답 저장을 하지 않도록 요청합니다.
`text.format`	`object`	조건부	구조화된 출력은 `text.format`에 지정합니다. 예를 들어 `type: json_schema`를 사용할 수 있습니다. 해당 형식을 지원하는 엔드포인트에서만 사용하세요.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`reasoning.effort`	`string`	조건부	요청할 추론 강도입니다. 사용 가능한 단계와 추론을 끌 수 있는지는 모델과 엔드포인트에 따라 다릅니다.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`string / object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/responses/compact`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `k3.1-pro`로 설정하세요.
`input`	`string / object[]`	필수	압축할 컨텍스트입니다. 텍스트 또는 원래 순서의 대화 입력 항목을 보내세요. 허용 형식은 엔드포인트에 따라 다릅니다.

요청 예시

API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "k3.1-pro",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

OpenAI Responses

bash

curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "instructions": "You are a helpful assistant.",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ],
  "stream": true,
  "store": false
}'

Responses Compact

bash

curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "k3.1-pro",
  "input": "Explain how a rainbow forms in one sentence."
}'

응답 읽기

Chat Completions · choices[].message.content에서 텍스트를 읽으세요. SSE 스트림에서는 choices[].delta로 새 출력이 전송됩니다. JSON · SSE
Anthropic Messages · content[]에서 유형이 text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE
Count Tokens · input_tokens에서 입력 토큰 수를 읽으세요.
OpenAI Responses · 스트리밍 시 response.output_text.delta 이벤트의 delta를 연결하고 완료 및 실패 이벤트를 처리하세요. SSE

전체 연동 가이드

기능 및 제한

streaming · 지원
tool_calling · 지원
image_input · 지원
video_input · 지원

호환 별칭 및 은퇴 리디렉션

kimi-k3.1-pro → k3.1-pro (별칭)
kimi, kimi-k2.5, kimi-k2.6, kimi-k2.7, kimi-k2.8, kimi-2.8, kimi-k2.7-code, kimi-for-coding → k3.1-pro (은퇴 리디렉션)

모델 기능 카탈로그 · 가격 보기

Kimi Code 설정: API Key, K3.1 Pro와 Claude Code

Kimi Code CLI와 Claude Code에서 K3.1 Pro를 설정하세요. 영구·임시 설정, Windows 세션, URL 차이와 첫 호출 확인, 401 및 모델 전환 문제 해결을 안내합니다.

Chat Completions

OpenAI Chat 형식으로 대화를 보냅니다. 요청 전에 모델과 선택한 엔드포인트가 Chat을 지원하는지 확인하세요.

Anthropic Messages

Anthropic Messages 형식으로 HTTP 요청을 보냅니다. Claude Code 설정은 관련 가이드를 참고하세요.

가입하고 API Key 받기