Kimi Reasoning Effort

상위 문서: ← Kimi Core workflows 출처: Kimi API Platform 공식 문서 — Reasoning Effort 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

Kimi K3는 항상 사고하며, 최상위 reasoning_effort 요청 필드로 사고 effort를 설정합니다. "low", "high", "max" 지원, 기본 "max".

1. 사고 effort 설정

Chat Completions 요청 최상위에 reasoning_effort 설정:

{
  "model": "kimi-k3",
  "messages": [{"role": "user", "content": "이 수열의 일반항을 유도해줘: 1, 4, 9, 25, 64, ..."}],
  "reasoning_effort": "high"
}

K2.x에서 K3로 마이그레이션 시, K2.x thinking 설정을 제거하고 필요시 최상위 reasoning_effort를 사용.

import os
from openai import OpenAI

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

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "이 수열의 일반항을 유도해줘: 1, 4, 9, 25, 64, ..."}],
    reasoning_effort="high",
)

message = completion.choices[0].message
if hasattr(message, "reasoning_content"):
    print(getattr(message, "reasoning_content"))
print(message.content)

2. 필드

필드	타입	필수	설명
reasoning_effort	string	아니오	K3 최상위 사고 effort 필드. "low" / "high" / "max" 지원, 기본 "max"

멀티턴 대화·도구 호출에서 K3는 API가 반환한 완전한 assistant 메시지를 messages에 reasoning_content와 tool_calls 포함해 그대로 전달해야 함.

3. 관련 문서

• Kimi K3 API Tool Calling Best Practices — 도구 호출 시나리오의 reasoning_effort 설정 가이드
• Thinking Models — 모델별 사고 동작과 Preserved Thinking
• Model Parameter Reference — 모델별 파라미터 차이

---

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 Reasoning Effort 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거