Kimi 매개변수 및 프로토콜 차이
호환 프로토콜에서 Kimi 모델의 매개변수 차이와 사용 방법을 알아봅니다.
Kimi는 이 페이지에 따라 매개변수를 조정하세요. 전체 구조: Chat Completions, Responses, Messages.
| 모델 | 적용 범위 |
|---|
| kimi-k3.1-pro, kimi-k3.1-pro-highspeed, kimi-k3 | 세 프로토콜의 공통 규칙, 개별 확장 대상 모델은 해당 행에 표시 |
| 필드 | 차이 설명 |
|---|
temperature, top_p | 각각 1.0, 0.95로 고정. 생략 권장, 다른 값은 오류 |
n, presence_penalty, frequency_penalty | 각각 1, 0, 0로 고정. 다른 값은 오류 |
reasoning_effort | low/high/max 지원, 기본값 max. 추론 및 추론 보존이 항상 켜지며 K2.x의 thinking 스위치는 사용하지 않음 |
max_completion_tokens | 기본값 131072, 최대 1048576. 입력과 출력 예산 합이 컨텍스트를 넘으면 출력 예산 자동 축소, 입력 자체는 범위 내여야 함 |
stop | 최대 5개 문자열, 각 32바이트 이하 |
tool_choice | auto/none/required 지원. 함수 지정 객체는 추론과 호환되지 않아 400 반환 |
messages[].reasoning_content | 여러 턴과 도구 호출 시 추론 및 tool_calls을 포함한 전체 assistant 메시지를 그대로 재전송 |
messages[].partial | Kimi Partial Mode: 마지막 assistant에 true을 설정해 접두사부터 생성, response_format.type=json_object과 병용 금지 |
messages[].tools | 동적 도구는 kimi-k3.1-pro, kimi-k3에 공식 명시. 전체 도구 정의와 content 없는 system 추가. 그 위치부터 사용 가능하며 후속 요청에도 유지 |
| 필드 | 차이 설명 |
|---|
reasoning.effort | low/high/max 지원, 기본값 max |
max_output_tokens | 기본값 131072, 최대 1048576 |
tool_choice | auto만 지원 |
tools[].type | function/namespace/custom/web_search만 지원, custom 도구 이름은 apply_patch만 허용 |
text.format | type: "json_schema", schema 사용. name 생략 시 output |
| 응답의 대화 상태 필드 | store, background은 false, previous_response_id, conversation는 null 고정. 서버 응답 체인 대신 클라이언트가 전체 입출력 이력 재전송 |
| 필드 | 차이 설명 |
|---|
max_tokens | 필수, 최소 1, 0 불가 |
output_config.effort | low/high/max 지원, 기본값 max |
tool_choice.type | auto/any/none 지원, 기본값 auto |
stop_sequences | 최대 5개 문자열, 각 32바이트 이하 |
이전 thinking 블록 | signature과 함께 다음 assistant에 그대로 재전송 |
output_config.format | 구조화 출력에 type: "json_schema", schema 필수 |
| 필드 | 차이 설명 |
|---|
Chat / Responses의 prompt_cache_options | mode은 implicit만, ttl는 5m/1h 지원, 기본값 5m. 생략해도 기본 5분 캐시 기록 |
Chat / Responses의 prompt_cache_breakpoint | 명시적 중단점 미지원, 콘텐츠에 넣으면 400 |
Messages의 cache_control | 요청 최상위만 적용, messages 내부 표시는 무시. type은 ephemeral 고정, ttl은 5m/1h, 기본값 5m. 생략해도 TTL 5분으로 읽기/쓰기 |
| 추론 강도 | 강도 변경은 접두사 캐시 적중을 깨뜨리므로 대화 시작 시 결정 |
ms://은 Kimi 원본 참조 형식으로 Kimi에 먼저 업로드해야 합니다. 이 페이지는 AGTCloud 업로드 API를 제공하지 않습니다.
MODEL_ID을 선택한 프로토콜에서 사용 가능한 전체 모델 ID로 바꾸고 본인 API Key를 사용하세요.
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096,
"prompt_cache_options": {"mode": "implicit", "ttl": "1h"}
}'