Kimi

Kimi (Moonshot AI)

Kimi는 중국의 AI 기업 Moonshot AI가 만든 대형 언어 모델(LLM) API 서비스예요. 얀리(Moonshot AI)의 플래그십 모델군으로, 긴 컨텍스트(문맥) 처리에 강점이 있고 OpenAI 및 Anthropic API 포맷과 호환되어 다양한 도구와 쉽게 붙일 수 있어요.

출처: 문서

본문

Kimi API는 Kimi 모델과 대화하는 인터페이스를 제공해요. OpenAI 방식의 Chat Completions API와 Anthropic 방식의 Messages API를 모두 지원해서, 기존 도구나 SDK를 그대로 활용할 수 있어요. API 키를 발급받고 base_url을 지정하면 HTTP API, OpenAI SDK, Anthropic SDK 중 원하는 방식으로 호출할 수 있어요.

주요 모델

  • kimi-k3 — Kimi의 최신 플래그십 모델이에요. 2.8조(trillion) 파라미터에 1M 토큰 컨텍스트 윈도우를 갖추고 있고, 네이티브 시각 이해(native visual understanding)를 지원해요. 장시간 코딩 에이전트(예: Claude Code)나 지식 작업, 깊은 추론에 잘 맞아요.
  • kimi-k2.7-code — 코딩에 특화된 모델이에요. 256K 토큰 컨텍스트 윈도우에 텍스트/이미지/비디오 입력과 thinking 모드를 지원해요. 출력 속도가 더 필요하면 kimi-k2.7-code-highspeed 를 선택할 수 있어요.
  • kimi-k2.6 — 범용 목적의 강력한 모델이에요. 256K 토큰 컨텍스트 윈도우에 텍스트/이미지/비디오 입력, thinking/비-thinking 모드를 모두 지원해요. 일반 채팅, 에이전트 작업, 시각 이해, 복잡한 추론에 사용해요.
  • kimi-k2-turbo-preview — 확장된 256K 컨텍스트 윈도우와 향상된 코딩 능력을 갖춘 프리뷰 모델이에요.

어느 모델을 쓸지 고민된다면 기본은 kimi-k3 를, 코드 생성·편집·프로그래밍 에이전트에 높은 출력 속도가 필요하다면 kimi-k2.7-code-highspeed 를 추천해요.

긴 컨텍스트 특징

Kimi는 긴 문서와 대화 히스토리를 통째로 처리하는 데 강한 모델이에요. 최신 플래그십인 kimi-k3 는 1M 토큰 컨텍스트 윈도우를 제공해서 방대한 문서를 통째로 넣고 요약·분석·추론할 수 있고, K2 계열은 256K 토큰 컨텍스트를 제공해요. 이런 긴 컨텍스트 처리는 코드베이스 분석, 장문 문서 QA, 긴 에이전트 실행 시나리오에 특히 유용해요.

API 사용 예시

API 키는 Kimi API Platform에 로그인한 뒤 API Keys 메뉴에서 만들 수 있어요. 보안 때문에 환경 변수에 저장해 두는 걸 권장해요.

export MOONSHOT_API_KEY="YOUR_KIMI_API_KEY"

API는 OpenAI 포맷과 완전히 호환되므로 Python 또는 Node.js용 OpenAI SDK를 그대로 쓸 수 있어요. SDK 설치는 다음과 같이 해요.

pip install --upgrade 'openai>=1.0'   # Python
npm install openai@latest              # Node.js

Python으로 첫 호출을 하는 간단한 예시 코드는 다음과 같아요. MOONSHOT_API_KEY 자리에 발급받은 API 키를 넣고, base_url 을 https://api.moonshot.ai/v1 로 지정하면 돼요.

from openai import OpenAI
client = OpenAI(
    api_key="MOONSHOT_API_KEY",  # Replace MOONSHOT_API_KEY with the API Key you obtained from the Kimi Open Platform
    base_url="https://api.moonshot.ai/v1",
)
completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "system", "content": "You are Kimi, an AI assistant provided by Moonshot AI."},
        {"role": "user", "content": "Hello, my name is Li Lei. What is 1+1?"},
    ],
    temperature=0.6,
)
# We receive a response from the Kimi large language model via the API (role=assistant)
print(completion.choices[0].message.content)

성공적으로 실행하려면 Python 환경(3.8 이상 권장) 또는 Node.js 환경, OpenAI SDK, 그리고 플랫폼에서 발급받은 API Key가 필요해요.

더 알아보기 (Learn more)