KO ▾
API 키 받기

kimiapikey.com가이드

Cursor에서 Kimi 스타일 API 키 사용: 설정 가이드

Cursor는 모든 OpenAI 호환 엔드포인트와 통신할 수 있으므로 이 API에 연결하려면 네 가지 필드와 약 2분이 필요합니다. 이 가이드는 정확한 값, 키가 작동함을 증명하는 테스트, 그리고 가장 흔히 마주치는 오류를 다룹니다.

업데이트

발광 케이블로 API 서버에 연결된 코드 편집기의 등각 그림

주요 포인트

  • Cursor에는 세 가지 값이 필요합니다: 키, 베이스 URL https://api.kimiapikey.com/v1, 모델 이름 uncensored.
  • 먼저 curl로 키를 테스트하면 Cursor 측 문제와 API 측 문제를 쉽게 구분할 수 있습니다.
  • 에이전트 스타일 편집은 큰 프롬프트를 보내므로 입력 토큰을 확인하세요: 1M 입력당 $0.15, 1M 출력당 $0.50.
  • 시험용 키는 동시 요청 2개를 허용하며 Cursor의 에이전트가 이를 초과할 수 있습니다. 일반 키는 동시 8개를 허용합니다.

짧은 답변

cursor에서 kimi api 키 사용법을 찾고 있다면, 먼저 알아야 할 점은 타사에서 발급한 키는 해당 제공자의 엔드포인트에서만 작동한다는 것입니다. 이 사이트에서 발급한 키는 이 사이트의 엔드포인트와 호환되며, Cursor는 엔드포인트가 OpenAI chat completions 형식을 지원하므로 이를 허용합니다. 키를 붙여넣고 Cursor의 베이스 URL을 다른 주소로 설정한 후, 사용자 정의 모델 이름 하나를 추가하면 됩니다.

전체 설정 순서:

  1. 계정을 생성하고 API 키 페이지에서 키를 복사하세요.
  2. Cursor를 열고 설정(Settings)으로 이동한 후 모델(Model)을 선택하세요.
  3. OpenAI API 키 필드에 키를 붙여넣으세요.
  4. 베이스 URL 재지정을 켜고 https://api.kimiapikey.com/v1을 입력하세요.
  5. uncensored라는 사용자 정의 모델을 추가하고 채팅에서 선택하세요.

이 문서의 나머지 부분에서는 각 단계를 설명하고 편집기 외부에서 연결을 테스트할 수 있는 방법을 제공하며, 일반적으로 문제가 발생하는 부분을 나열합니다.

이 키의 성격과 한계

이 사이트는 독립적인 제공자가 실행하고 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정된 하나의 오픈 웨이트 모델에 대한 접근권을 판매합니다. 이는 Moonshot, Kimi 또는 기타 벤더의 공식 API가 아니며, 요청을 다른 사람의 모델로 전달하는 라우터도 아닙니다. 사이트 이름은 서비스를 운영하는 주체가 아니라 사람들이 검색하는 내용을 반영합니다. 이미 다른 벤더의 키를 보유하고 있다면 해당 벤더의 엔드포인트와 함께 계속 사용하세요. 두 키는 서로 호환되지 않습니다.

제공되는 것은 평범한 OpenAI 스타일 API입니다: POST /v1/chat/completions 및 GET /v1/models, Bearer 토큰 인증, 100,000 토큰 컨텍스트 창, 스트리밍, 함수 호출 및 JSON 모드입니다. 텍스트 전용입니다. 이미지 생성, 임베딩, 파인튜닝이 없으며, 이는 편집기에서 중요합니다. 이러한 기능에 의존하는 Cursor의 기능은 이 엔드포인트를 사용하지 않기 때문입니다. Kimi API 키 설명서에서 명명 규칙과 대안에 대해 더 자세히 알아보세요.

코딩에서 "무검열"은 실용적인 의미를 가집니다. 변수 이름이나 테스트 픽스처가 민감해 보인다고 해서 작업 중간에 중단되지 않습니다. 소유한 시스템용 보안 도구, 지저분한 문자가 포함된 로그 파서, 스크레이퍼, 픽션 생성기 및 모더레이션 테스트 세트는 다른 곳에서는 거부를 유발하는 작업 유형입니다. 엄격한 한계가 유지됩니다: 미성년자가 관련된 성적 콘텐츠는 절대 없습니다.

Cursor 단계별 설정

1. 키와 시험 크레딧 받기

Google 또는 이메일과 비밀번호로 가입하세요. API 키 페이지에서 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 청구할 수 있습니다. 카드가 필요 없으며, 7일 동안 유효하고 사람당 하나입니다. 이는 몇백 건의 일반 채팅 요청에 충분하므로, 아무것도 지불하기 전에 이 전체 가이드를 완료할 수 있습니다.

2. 모델 설정 열기

Cursor에서 설정을 열고 모델 섹션을 찾습니다. 메뉴 레이블은 버전마다 이동할 수 있으므로 OpenAI API 키를 위한 필드와 OpenAI 베이스 URL 재지정을 위한 토글 또는 필드를 찾으세요. 이 두 설정이 중요합니다.

3. 세 가지 값 채우기

Cursor 필드내용
OpenAI API 키대시보드의 키
OpenAI 베이스 URL 재지정https://api.kimiapikey.com/v1
사용자 정의 모델 이름uncensored

보여진 대로 베이스 URL을 정확히 입력하세요. 끝에 /v1이 붙지만, 후행 슬래시나 /chat/completions은 없습니다. 클라이언트가 경로를 자체적으로 추가하기 때문입니다. 전체 경로가 붙은 URL을 붙여넣으면 404가 발생하며, 오류 메시지는 이유를 잘 알려주지 않습니다.

4. 모델 선택 및 메시지 보내기

채팅 패널을 열고 모델 목록에서 uncensored를 선택한 후 "ISO 날짜를 파싱하는 함수를 작성해줘"와 같은 작은 질문을 해보세요. 응답이 스트리밍되면 완료된 것입니다. Cursor가 오류를 표시하면 설정을 무작위로 변경하지 마세요. 다음 섹션으로 가서 엔드포인트를 직접 테스트하세요.

5. 재지정의 부작용 이해하기

베이스 URL 재지정은 Cursor에서 사용하는 모든 OpenAI 스타일 모델에 적용되며, 사용자 정의 모델에만 국한되지 않습니다. 나중에 표준 OpenAI 모델로 돌아가면 재지정을 먼저 끄세요. 그렇지 않으면 이 엔드포인트가 제공하지 않는 모델 이름으로 요청이 전송됩니다.

편집기를 비난하기 전에 키 테스트하기

터미널로 2분만 투자하면 한 시간의 추측을 줄일 수 있습니다. 이 요청은 Cursor가 수행하는 작업을 수행합니다: Bearer 토큰으로 chat completion 요청을 보냅니다.

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": "Reply with the word ready."}],
    "max_tokens": 20
  }'

choices 배열이 있는 JSON 본문은 키, URL 및 모델 이름이 모두 정확함을 의미합니다. 응답 헤더도 확인하세요. X-Balance-USD는 남은 크레딧을 보여주며, X-Request-Id은 요청 추적이 필요할 때 보관할 가치가 있습니다.

공식 OpenAI SDK를 사용한 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": "Reply with the word ready."}],
    max_tokens=20,
)
print(resp.choices[0].message.content)

GET /v1/models로 모델을 나열할 수도 있습니다. Cursor 및 유사한 클라이언트는 확인 버튼을 누를 때 이를 호출하는 경우가 있으므로, 모델 호출이 성공하는 것은 좋은 신호입니다. curl은 작동하지만 Cursor가 작동하지 않는다면 문제는 편집기 설정에 있으며, 하단의 오류 표는 일반적인 문제를 다룹니다.

모델이 편집기에서 코드를 작성할 때의 변화

사이드 패널의 채팅은 저렴합니다. 짧은 질문과 몇백 토큰의 컨텍스트는 1센트도 안 되는 비용만 듭니다. 파일을 첨부하고 검색 결과 및 대화 기록을 포함하는 편집기 기능은 매 요청이 모든 것을 다시 포함하기 때문에 더 비쌉니다. 모델은 프롬프트와 응답 간에 공유되는 100,000토큰 창을 가지며, Cursor는 큰 폴더를 첨부하면 대부분을 기꺼이 채웁니다.

실제 계산을 보여줍니다. 요청에 40,000개의 입력 토큰이 포함되어 있고 모델이 1,500개의 토큰을 반환한다고 가정해 봅시다:

  • 입력: 40,000 / 1,000,000 x $0.15 = $0.006
  • 출력: 1,500 / 1,000,000 x $0.50 = $0.00075
  • 총계: 요청당 $0.00675, 따라서 이러한 요청 100개는 $0.675가 듭니다

작업량이 많은 오후라도 $1 미만이지만 입력 측이 지배적이므로 돈을 절약하는 습관은 짧은 질문이 아니라 더 적은 파일을 첨부하는 것입니다. 주제가 바뀌면 새 채팅을 시작하세요. 이전 기록은 매 턴마다 다시 지불되기 때문입니다.

API는 함수 호출을 지원하며, 이는 에이전트 스타일 편집기 기능의 기반입니다. 모델이 도구 호출을 결정하면, 클라이언트는 이를 실행하고 결과를 role: "tool" 메시지로 반환합니다. 모델이 다단계 에이전트를 얼마나 잘 구동하는지는 모델에 따라 다르므로, 리팩토링과 같은 큰 작업을 맡기기 전에 작은 작업으로 테스트해 보세요. API 뒤에 있는 오픈 웨이트 모델이 하나뿐이므로, 메뉴에서 선택할 수 있는 다양한 동작이 아닌 단일 동작만 제공됩니다.

Cursor의 탭 완성처럼 Cursor 자체 모델로 실행되는 Cursor 기능은 일반적으로 사용자 정의 키로 전환되지 않습니다. 릴리스 간에 변경되는 목록이 있으므로 사용자 정의 OpenAI 스타일 엔드포인트를 허용하는 기능이 무엇인지 Cursor의 현재 문서를 확인하세요.

일반적인 오류 및 해결 방법

증상잠재적 원인해결 방법
404 또는 "찾을 수 없음"베이스 URL에는 엔드포인트 경로가 포함되어 있거나 /v1이 누락됨정확히 https://api.kimiapikey.com/v1를 사용하세요
401 Unauthorized붙여넣은 키에 불필요한 공백이나 줄바꿈이 있거나, 오래된 키입니다대시보드에서 키를 다시 복사하여 붙여넣으세요
모델을 찾을 수 없음모델 이름이 다르게 입력됨uncensored를 사용하세요. 소문자이며 그 외에는 아무것도 없음
코드 concurrency와 함께 429키에 대한 동시 요청 수가 초과되었습니다실행 중인 요청이 완료될 때까지 기다리거나, 전체 키(동시 8개)를 사용하세요
코드 rate_limited와 함께 4291분당 허용량을 초과했습니다요청 속도를 줄이세요. 체험 키는 분당 60개, 전체 키는 분당 300개를 허용합니다
Retry-After: 5 헤더와 함께 429일시적 과부하5초 후 재시도
확인 버튼은 실패하지만 curl은 작동함편집기는 알고 있는 모델 이름으로 테스트합니다확인 단계를 건너뛰고 실제 채팅 메시지를 전송하세요

동시성 오류는 체험 키를 사용하는 사용자에게 놀라움을 줄 수 있으므로 참고해야 합니다. 체험 키는 동시 요청 2개를 허용하며, 여러 작업을 병렬로 시작하는 에이전트는 사용자의 별도 조치 없이도 이 한도를 초과할 수 있습니다. 스트리밍 응답은 스트리밍이 끝날 때까지 슬롯을 점유하므로, 긴 응답은 전체 시간 동안 하나의 슬롯을 사용합니다. 전체 키는 동시 요청 8개와 분당 300개의 요청을 허용하므로 단일 개발자에게 충분한 용량을 제공합니다.

실패한 요청과 거부된 요청은 요금이 부과되지 않으므로, 오류 후 재시도해도 추가 비용이 들지 않습니다. 전체 제한 사항은 문서 페이지에서 확인할 수 있습니다.

체험 기간이 만료된 후 결제

구독은 없습니다. $20부터 $500까지 원하는 정수 금액으로 선불 크레딧을 충전할 수 있으며, 요청은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50의 속도로 크레딧을 차감합니다. 크레딧은 만료되지 않으므로 코딩이 없는 달에는 비용이 들지 않습니다. $50 이상의 충전에는 보너스가 제공됩니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 암호화폐(TRC20 기반 USDT, Base 기반 USDC)로 결제할 수 있습니다. 가격 책정 페이지에는 현재 수치가 한 곳에 정리되어 있습니다.

이전에 언급한 입력 40,000, 출력 1,500 토큰의 요청을 기준으로 할 때, $20 충전으로는 약 2,960번의 해당 요청이 가능합니다($20 / $0.00675). 대부분의 편집기 요청은 이보다 작으므로 실제 사용 가능 횟수는 더 많습니다. 프롬프트는 학습에 사용되지 않으므로, 붙여넣는 코드가 클라이언트의 것일 경우 이는 중요합니다.

설치를 완료한 후 추천하는 첫 번째 작업은 빠르게 검토할 수 있는 작은 작업입니다. 기존 함수의 단위 테스트, 긴 주석이 있는 정규식, 또는 하나의 노이즈가 많은 파일의 리팩토링이 좋은 예입니다. 결과가 워크플로우에 적합하다면 크레딧을 추가하세요. 적합하지 않다면 체험 크레딧 몇 센트만으로 확인이 끝납니다.

자주 묻는 질문

모델이 Moonshot의 공식 Kimi와 동일한가요?
아니요, 당사는 무검열을 위해 조정된 오픈 웨이트 모델을 호스팅합니다. 이는 GPT, Claude, Gemini, Grok, DeepSeek 또는 기타 벤더의 모델이 아닙니다. 당사 자체 서버에서 실행되는 고유한 모델입니다.

데이터로 학습합니까?
아니요. 프롬프트와 생성 결과는 학습에 사용되지 않습니다. 우리는 프라이버시와 투명성을 중요하게 생각하므로 데이터는 고객님의 것입니다.

속도 제한은 어떻게 됩니까?
키당 분당 300개의 요청으로 제한됩니다. 최대 요청 본문 크기는 8 MB입니다. 이러한 제한은 모든 사용자에게 안정적인 성능을 보장하기 위해 설계되었습니다.

콘텐츠 정책은 무엇입니까?
이 모델은 성인, 논쟁적, 창의적 주제에 대해 무검열입니다. 그러나 미성년자가 포함된 성적인 콘텐츠는 차단됩니다. 이는 구독 수준에 관계없이 항상 적용되는 엄격한 제한입니다.

질문과 답변

이 베이스 URL로 Cursor에 Moonshot 또는 Kimi 키를 넣을 수 있나요?

아니요. 키는 해당 키를 발급한 제공자의 엔드포인트에서만 작동합니다. 여기 대시보드의 키를 사용하거나, 다른 키는 해당 제공자의 URL과 함께 유지하세요.

Cursor에 어떤 모델 이름을 입력해야 하나요?

소문자로 uncensored를 입력하세요. 이는 이 API가 제공하는 유일한 모델 ID이며, 다른 이름을 입력하면 모델을 찾을 수 없다는 오류가 반환됩니다.

Cursor의 에이전트 모드와 호환되나요?

API는 에이전트 기능에 필요한 함수 호출을 지원합니다. 모델이 긴 다단계 작업을 얼마나 신뢰성 있게 완료하는지는 달라지므로, 큰 작업 전에 작은 작업으로 테스트해 보세요.

시험용 키에서 429 오류가 발생하는 이유는 무엇인가요?

체험 키는 동시 요청 2개와 분당 60개의 요청을 허용합니다. 전체 키는 동시 8개와 분당 300개를 허용하며, Retry-After: 5 헤더는 짧은 과부하를 의미하며 재시도할 수 있습니다.

내 코드가 학습에 사용되나요?

아니요. API로 전송된 프롬프트는 학습에 사용되지 않습니다.

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

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

API 키 받기문서 읽기