Kimi를 사용해 보세요

API 오류 코드

Kimi API 호출 시 자주 발생하는 오류 코드와 해결 방법입니다.

오류 코드 참조

오류 코드의미해결 방법
400잘못된 요청요청 본문의 형식, 매개변수 이름과 타입을 확인하세요. 흔한 원인으로는 잘못된 JSON 형식, 필수 매개변수 누락, 허용 범위를 벗어난 값이 있습니다.
401인증되지 않음API Key가 올바른지, 만료되었거나 비활성화되지 않았는지 확인하세요. 헤더 형식이 Authorization: Bearer <your-api-key>인지 확인하세요.
403금지됨(잔액 부족)계정 잔액이 소진되었습니다. 콘솔에서 충전하세요. 계정에 제한이 걸렸을 수도 있으므로 필요한 경우 지원팀에 문의하세요.
404찾을 수 없음요청 URL 경로와 모델 이름을 확인하세요. 엔드포인트가 https://api.moonshot.ai/v1/...인지 확인하세요.
429Too Many Requestsrate limit을 초과했습니다. 호출 빈도를 낮추고, 지수 백오프를 구현하거나, 더 높은 한도가 필요하면 지원팀에 문의하세요.
500Internal Server Error일시적인 서버 문제입니다. 잠시 후 다시 시도하세요. 문제가 계속되면 request_id와 함께 [email protected]로 문의하세요.

일반 문제 해결 팁

  1. 전체 오류 메시지 확인: 응답 JSON의 error.message에 자세한 설명이 포함되어 있습니다.
  2. request_id 기록: 지원팀이 문제를 빠르게 찾는 데 도움이 됩니다.
  3. 공식 문서 참조: 호출이 platform.kimi.ai의 문서와 일치하는지 확인하세요.
  4. 재시도 로직 구현: 429 및 500 오류에는 지수 백오프를 사용하세요.
API 오류 코드 - Kimi 헬프 센터