KO ▾
API 키 받기

5분 내 첫 요청

Kimi API 키를 OpenAI 호환 클라이언트에 넣고 무검열 텍스트 생성을 시작하세요. 이 가이드는 SDK 구성 방법과 실제 토큰 가격을 설명합니다.

OpenAI Python/Node SDK 설치

표준 OpenAI 클라이언트 라이브러리를 설치하세요. 이 API는 동일한 OpenAI 호환 인터페이스를 따르기 때문에 작동합니다. 전용 SDK가 필요하지 않습니다. Python의 경우 pip install openai, Node.js의 경우 npm install openai을 실행하세요. 라이브러리는 JSON 직렬화 및 HTTP 요청을 자동으로 처리합니다.

베이스 URL 및 API 키 구성

클라이언트를 엔드포인트에 연결하세요. 베이스 URL을 https://api.kimiapi.top/v1로 설정하고 대시보드에서 API 키를 입력하세요. 이 키는 선불 크레딧을 인증합니다. 가입 페이지에서 Google 또는 이메일로 새 키를 즉시 생성할 수 있습니다. 시작하기 위해 신용카드가 필요하지 않습니다.

curl https://api.kimiapi.top/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."}]
  }'

첫 채팅 완성 요청 보내기

uncensored 모델에 간단한 메시지를 보내세요. 이 모델은 합법적인 성인 사용에 대한 거절 없이 답변하도록 조정되었습니다. 100,000토큰 컨텍스트 창을 지원하지만 최대 출력은 32,000토큰입니다. 응답은 텍스트로 직접 반환되며 오류 및 거부는 크레딧을 소모하지 않습니다.

from openai import OpenAI

client = OpenAI(base_url="https://api.kimiapi.top/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)

SSE로 스트리밍 활성화

실시간 응답을 위해 스트리밍을 활성화하세요. SDK는 서버 전송 이벤트(SSE)를 통해 토큰을 스트리밍합니다. 마지막 청크에는 과금을 위한 총 토큰 사용량이 포함됩니다. 이 방식은 긴 출력의 지각된 지연 시간을 줄입니다. 애플리케이션 로직에서 도착하는 각 토큰을 처리할 수 있습니다.

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)

구조화된 출력을 위한 JSON 모드 사용

response_format을 {"type": "json_object"}로 설정하여 일관된 기계 판독 가능한 출력을 확보하세요. 이 설정은 모델이 유효한 JSON을 반환하도록 강제합니다. 데이터 추출 또는 구성 생성에 이상적이며 모델이 구조를 깨지 않아 코드에서 응답을 쉽게 구문 분석할 수 있습니다.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimiapi.top/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);

사용량 및 비용 확인

대시보드를 통해 사용량을 모니터링하세요. 입력 비용은 토큰 백만 개당 $0.25, 출력은 토큰 백만 개당 $1.00입니다. 401 오류가 발생하면 키를 확인하세요. 402 오류는 USDT 또는 USDC로 충전해야 함을 의미합니다. 429 오류는 분당 300개 요청 제한에 도달했음을 나타냅니다. 크레딧은 만료되지 않으므로 편리할 때 충전하세요.

기술 사양

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

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

오류 코드

오류는 고정된 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모델 혼잡 — 몇 초 후 재시도

질문과 답변

Kimi API의 과금은 어떻게 작동하나요?

실제 토큰 사용량에 대해서만 요금이 부과됩니다. 입력 토큰은 백만 토큰당 $0.25, 출력 토큰은 백만 토큰당 $1.00입니다. 오류 및 거부는 무료이며 선불 크레딧은 만료되지 않습니다.

어떤 암호화폐 결제가 지원되나요?

USDT(TRC20) 및 USDC(Base)를 지원합니다. 충전 금액은 $10부터 $500까지이며, 카드나 PayPal 없이 직접 결제가 처리됩니다.

컨텍스트 창 제한은 어떻게 되나요?

이 모델은 프롬프트와 응답 생성 모두에 대해 100,000토큰의 컨텍스트 창을 지원합니다. 그러나 별도의 하한을 지정하지 않는 한 요청당 최대 출력은 32,000토큰입니다.

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

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