KO ▾
API 키 받기

kimiapikey.com문서

Kimi API: 5분 내 첫 요청

표준 OpenAI 호환 인터페이스를 사용하여 5분 이내에 첫 응답을 받으세요. 이 가이드는 무검열 모델의 설정, 인증 및 기본 사용법을 다룹니다.

API 키 받기

사전 준비

시작하려면 kimiapikey.com에서 API 키가 필요합니다. 이메일과 비밀번호만으로 가입하면 되며, 체험용에는 신용카드가 필요하지 않습니다. 공식 또는 호환 SDK가 설치된 지원되는 언어 환경도 필요합니다. 당사 API는 OpenAI chat-completions 형식을 따르므로 GPT-3.5/4용 기존 코드는 최소한의 변경으로 작동할 수 있습니다. SDK 버전이 base_url 매개변수를 지원할 만큼 최신인지 확인하세요.

베이스 URL 및 인증

당사 API는 https://api.kimiapikey.com/v1에 위치합니다. 인증은 표준 Authorization 헤더를 통해 처리됩니다. 키를 Bearer 토큰으로 전달하세요. 이는 OpenAI 호환 엔드포인트를 받는 모든 클라이언트에서 작동합니다. 프록시나 사용자 지정 클라이언트를 사용하는 경우 Authorization 헤더가 올바르게 전달되는지 확인하세요. 요청할 모델 ID는 uncensored입니다.

첫 번째 요청

설치를 확인하기 위해 간단한 채팅 완료를 보내세요. 아래 curl 명령어를 사용하고 YOUR_API_KEY을 실제 키로 바꾸세요. 이 요청은 uncensored 모델로 짧은 프롬프트를 전송합니다. 성공하면 모델의 응답이 포함된 JSON 응답을 받게 됩니다. choices 배열에서 생성된 텍스트를 확인하세요. 401 오류가 발생하면 키가 유효하지 않거나 만료되었습니다.

Python SDK

가장 쉬운 통합을 위해 공식 OpenAI Python 라이브러리를 사용하세요. base_url을 당사 엔드포인트로 설정하고 키를 제공하세요. 이 예제는 기본 텍스트 생성 호출을 보여줍니다. 필요에 따라 model 매개변수를 조정할 수 있지만 uncensored이 기본값입니다. 이 접근 방식은 코드를 다양한 OpenAI 호환 서비스 간에 이식 가능하게 유지합니다.

Node SDK

JavaScript/TypeScript 프로젝트의 경우 openai npm 패키지를 사용하세요. 클라이언트를 베이스 URL과 API 키로 구성하세요. 이렇게 하면 Node 환경에서 직접 요청을 보낼 수 있습니다. 구문은 Python SDK와 유사하여 언어를 전환할 때 일관성을 보장합니다. await을 사용하여 비동기 응답을 올바르게 처리하는 것을 잊지 마세요.

스트리밍 응답

실시간 출력을 위해 SDK에서 스트리밍을 활성화하세요. 이는 생성되는 대로 텍스트 청크를 전송하여 지각된 지연 시간을 줄입니다. 요청에서 stream 플래그를 사용하세요. SDK는 부분 응답을 생성하므로 UI를 단계적으로 업데이트할 수 있습니다. 이는 즉각적인 피드백이 중요한 채팅 인터페이스나 장문 콘텐츠 생성에 이상적입니다.

제한 및 오류

각 키는 분당 300개의 요청으로 제한됩니다. 이를 초과하면 429 오류가 발생합니다. 요청 본문은 8 MB를 초과할 수 없습니다. 100,000개의 토큰 컨텍스트 창은 프롬프트와 완성의 합계에 적용됩니다. 일반적인 오류로는 401(잘못된 키)과 402(크레딧 부족)이 있습니다. API를 계속 사용하려면 대시보드를 통해 충전하세요. 크레딧은 만료되지 않으며 월 요금이 없습니다.

cURL

curl https://api.kimiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

from openai import OpenAI

client = OpenAI(base_url="https://api.kimiapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimiapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

스트리밍

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

질문과 답변

API는 함수 호출을 지원하나요?

네, 엔드포인트는 표준 OpenAI 형식의 도구/함수 호출을 지원합니다. 요청에 도구를 정의하면 모델이 구조화된 인수를 반환합니다.

속도 제한을 초과하면 어떻게 되나요?

429 Too Many Requests 오류가 발생합니다. 잠시 후 다시 시도하거나, 선불 크레딧 등급을 업그레이드하여 더 높은 처리량을 유지하세요.

모델이 제 데이터로 학습되나요?

아니요. API로 전송된 프롬프트는 학습에 사용되지 않습니다. 귀사의 데이터는 비공개로 유지되며 기본 모델 개선에 사용되지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 베이스 URL을 변경하세요. 설정은 이것뿐입니다.

API 키 받기문서 읽기

기술 사양

크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.

항목내용
형식OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작
모델 IDuncensored
인증Authorization: Bearer YOUR_KEY
엔드포인트POST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
최대 출력100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음)
파라미터temperature, top_p, stop, seed, presence_penalty, frequency_penalty
함수 호출지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송
스트리밍지원 — SSE, 마지막 청크에 토큰 사용량 포함
컨텍스트 창100,000 토큰 (입력 + 출력)
JSON 모드response_format: {"type": "json_object"}
동시 요청키당 동시 8개
속도 제한키당 분당 300회
응답 헤더X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
요청 크기최대 8 MB
가격입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50
과금선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료
보너스$50 이상 +5%, $100 이상 +10%, $200 이상 +15%
유효기간유료 크레딧은 만료되지 않으며 구독 없음
충전USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액
무료 체험$0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용
키계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효
로그인Google 또는 이메일과 비밀번호
콘텐츠성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부

오류 코드

오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.

코드유형의미
400bad_request잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과
401missing_key · invalid_key · key_revoked키 없음·잘못됨·새 키로 교체됨
402no_credit잔액 없음 — 충전하면 즉시 재개
403content_blocked미성년자 관련 성적 콘텐츠 — 거부, 과금 없음
404not_found알 수 없는 엔드포인트
413request_too_large본문 8 MB 초과
429rate_limited · concurrency분당 300회 또는 동시 8개 초과 — 잠시 후 재시도
503upstream_busy모델 혼잡 — 몇 초 후 재시도