Kimi API 빠른 시작

Kimi API 빠른 시작 (Quick Start)

Kimi API는 Moonshot AI가 제공하는 대규모 언어 모델 서비스로, OpenAI와 Anthropic API 형식을 모두 호환해요. API Key를 만들고 모델을 고른 뒤 base_url만 지정하면 HTTP API, OpenAI SDK, Anthropic SDK 중 원하는 방식으로 바로 첫 호출을 해볼 수 있답니다. 이 문서는 Kimi API 공식 문서의 Start Using Kimi API 페이지를 해요체로 옮긴 거예요. 원문은 Kimi API Docs에서 확인할 수 있어요.

시작하기

1. API Key 발급

Kimi API 开放平台에 로그인해서 API Keys 페이지에서 키를 만들고 복사해 주세요. API Key는 절대 남에게 공유하면 안 되고, 코드에 하드코딩하지 말고 환경 변수로 저장하는 걸 권장해요.

export MOONSHOT_API_KEY="당신의_KIMI_API_KEY"

2. 모델 선택

빠른 시작에서는 기본적으로 Kimi K3를 추천해요. 시나리오에 따라 Kimi K2.7 Code나 Kimi K2.6을 골라도 돼요.

Kimi K3 — 장기 코딩과 엔드투엔드 지식 작업을 위한 플래그십 모델. 2.8조 파라미터에 1M token 컨텍스트.
Kimi K2.7 Code — 코드에 특화된 모델. 256K 컨텍스트에 텍스트/이미지/비디오 입력과 생각 모드를 지원해요. 출력 속도가 더 필요하면 kimi-k2.7-code-highspeed를 써요.
Kimi K2.6 — 256K 컨텍스트, 텍스트/이미지/비디오 입력, 생각/비생각 모드를 지원하는 일반 용도 모델.

3. 호출 방식 선택

Kimi API는 OpenAI 스타일의 Chat Completions API와 Responses API, 그리고 Anthropic 호환 Messages API를 제공해요. 프로젝트 기술 스택에 맞는 걸 고르면 되고, 코드를 안 짜고 바로 테스트하고 싶다면 개발자 워크벤치(Playground)를 쓸 수 있어요.

4. 첫 호출

아래 예시는 최신 모델 kimi-k3로 요청을 보내는 코드예요. MOONSHOT_API_KEY는 직접 만든 키로 바꾸거나 같은 이름의 환경 변수로 미리 설정해 두세요.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.cn/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[
        {"role": "system", "content": "당신은 Kimi, Moonshot AI의 AI 어시스턴트입니다."},
        {"role": "user", "content": "안녕하세요, 저는 이레입니다. 1+1은 얼마인가요?"}
    ]
)

print(completion.choices[0].message.content)

curl로도 같은 요청을 보낼 수 있어요.

curl https://api.moonshot.cn/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $MOONSHOT_API_KEY" \
    -d '{
        "model": "kimi-k3",
        "messages": [
            {"role": "system", "content": "당신은 Kimi, Moonshot AI의 AI 어시스턴트입니다."},
            {"role": "user", "content": "안녕하세요, 저는 이레입니다. 1+1은 얼마인가요?"}
        ]
    }'

실행 전에 준비할 것:

Python 3.8 이상 또는 Node.js 18 이상.
OpenAI SDK 1.0.0 이상 — pip install --upgrade 'openai>=1.0' / npm install openai@latest
만든 API Key

참고: kimi-k3는 요청 최상위 reasoning_effort로 추론 강도를 조절해요 ("low" / "high" / "max", 기본 "max"). kimi-k2.6 등 다른 모델로 바꾸려면 model 필드만 교체하면 되지만, 모델마다 파라미터 구성이 달라서 모델 파라미터 참조를 확인하는 게 좋아요. 코드에 특화된 고속 모델을 원하면 kimi-k3 대신 kimi-k2.7-code-highspeed를 넣으면 돼요.

더 알아보기

스트리밍 출력 — "stream": true를 켜면 응답이 생성되는 대로 조각조각 내려와요. 채팅·코드 생성·긴 텍스트에 유용해요.
다중 턴 대화 — messages 배열을 유지해서 모델이 대화 이력을 기억하게 해요.
다중 모달 입력 — Kimi K3, K2.7 Code, K2.6 모두 텍스트·이미지·비디오 입력을 지원해요.
도구 호출 — tools로 외부 함수/API를 호출하게 해서 에이전트·웹 검색·복잡한 워크플로우를 만들 수 있어요.
JSON Mode — 모델이 유효한 JSON을 출력하도록 강제해서 구조화 데이터 추출에 써요.
생각 모델 — 복잡한 추론·다단계 도구 호출·에이전트 작업을 처리해요.