NezhaGateNezhaGate
简体中文EnglishEspañol한국어 ✓日本語
로그인 API 키 받기
kimi-k3

Kimi K3 · API

⧉Markdown으로 복사 📄Markdown으로 보기AI용 평문 ✦Open in ChatGPT ✶Open in Claude
POST https://nezhagate.com/v1/chat/completions

Moonshot Kimi K3를 기반으로 한 OpenAI 호환 채팅 완성 API입니다. 긴 문서, 다중 문서 분석, 에이전트를 위한 새 플래그십입니다. 항상 먼저 생각하며 추론 과정은 message.reasoning_content로 반환되고, 추론 토큰은 usage.completion_tokens 안에서 출력 단가로 과금됩니다. 샘플링 온도는 모델이 고정하므로 temperature / top_p는 무시됩니다. 도구 호출, 스트리밍, 프롬프트 캐싱을 지원합니다. model을 kimi-k3로 지정하세요. /v1/chat/completions에서만 제공됩니다.

플레이그라운드에서 사용해 보기 →

인증

Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

콘솔에서 API 키를 만들면 시작할 수 있습니다.

요청 본문

파라미터타입필수설명
model string 예 모델 ID. 여기서는 kimi-k3입니다.
messages array 예 메시지 배열. 각 항목은 role(system/user/assistant)과 content를 가집니다. content는 문자열이거나, 이미지 이해(멀티모달 / 비전)를 위한 {type:text}와 {type:image_url} 조각들의 배열일 수 있습니다.
stream boolean 아니오 SSE로 스트리밍할지 여부. 기본값 false.
temperature number 아니오 Kimi K3는 모델이 고정한 샘플링 온도를 사용하므로 게이트웨이가 이 파라미터를 무시합니다(오류 없음).
max_tokens integer 아니오 생성할 최대 토큰 수.
web_search boolean 아니오 true로 두면 웹 검색이 켜집니다. 게이트웨이가 모델이 답하기 전에 실시간 검색 결과로 프롬프트를 보강하고 출처를 함께 제시합니다. tools 항목 {"type":"web_search"}로도 켤 수 있습니다.

요청 예시

cURL
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "kimi-k3", "messages": [{"role": "user", "content": "Hello"}], "stream": false}'

응답

200 · JSON
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "model": "kimi-k3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "reasoning_content": "The user is greeting me, so a short friendly reply fits...",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 42,
    "total_tokens": 51,
    "completion_tokens_details": {"reasoning_tokens": 31}
  }
}

이미지 입력 (Vision)

메시지 content 배열에 이미지를 넣으면 모델이 이를 분석합니다(시각적 질의응답, 텍스트 판독 / OCR 등). image_url에는 공개 이미지 링크 또는 인라인 base64 data URL(data:image/png;base64,...)을 넣을 수 있습니다. 멀티모달 모델(gpt-5.5, gemini 계열 등)에서 사용할 수 있습니다.

curl · 이미지 입력 (Vision)
curl https://nezhagate.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model": "kimi-k3", "messages": [{"role": "user", "content": [{"type": "text", "text": "이 사진에는 무엇이 있나요?"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}]}]}'

오류 코드

모든 오류 본문에는 error.message / error.type / error.code / error.param이 들어 있습니다. 분기는 code로 하세요. 전체 목록은 연동 가이드에 있습니다.

HTTPcode설명
401invalid_api_keyAPI 키가 없거나 유효하지 않음
402insufficient_quota잔액 부족 또는 키 한도 초과
400invalid_request지원하지 않는 모델 또는 파라미터
429rate_limit_exceeded업스트림 요청 한도 초과
502upstream_error모든 업스트림 경로가 실패