KO ▾
API 키 받기

kimiapikey.com가이드

Moonshot API Base URL: 코드에서 다른 곳으로 연결하기

moonshot API 기본 URL은 OpenAI 스타일 클라이언트의 단일 문자열일 뿐이며, 이를 변경하는 것이 동일한 코드를 다른 제공자에 연결하는 방법입니다. 이 페이지에서는 Python, Node, curl 및 일반 도구에서 해당 문자열이 어디에 있는지와 대안 엔드포인트를 어떻게 설정하는지 보여줍니다.

업데이트

스위치 보드의 두 소켓 간에 케이블이 이동하는 모습으로 변경된 API 기본 URL을 나타냅니다
발광 케이블로 API 서버에 연결된 코드 편집기의 등각 그림

주요 포인트

  • 기본 URL은 단일 설정이며 요청 본문은 OpenAI 채팅 형식을 유지합니다.
  • 전환 시 세 가지를 변경하십시오: 기본 URL, API 키, 모델 ID.
  • 우리의 엔드포인트는 https://api.kimiapikey.com/v1이며 model ID는 uncensored입니다.
  • 독립적인 호스팅 모델이며 Moonshot의 공식 서비스가 아니므로 프롬프트를 다시 테스트하십시오.

기본 URL이 실제로 수행하는 작업

OpenAI 호환 클라이언트는 base URL과 경로라는 두 부분으로 모든 요청을 구성합니다. SDK는 이를 연결하므로 chat.completions.create 호출은 <base_url>/chat/completions으로 POST 요청이 됩니다. 이 형식을 따르는 제공자(Moonshot 포함)는 자체 base URL을 문서에 게시합니다. 포럼 게시글에서 복사하는 대신 문서에서 확인하십시오. 추측할 수 없는 유일한 값이기 때문입니다.

따라서 제공자를 전환하려면 다음 세 가지 수정만 필요합니다.

  1. 요청이 전송될 위치를 결정하는 기본 URL입니다.
  2. 제공자별로 발급되며 해당 제공자의 서버에서만 작동하는 API 키입니다.
  3. model ID입니다. 각 제공자는 모델을 고유하게 명명하기 때문입니다.

메시지, 역할, 스트리밍, 도구 및 JSON 모드는 동일한 형태를 유지하므로 마이그레이션이 짧습니다. 내장 웹 검색 도구와 같은 제공자별 기능에 의존하는 항목은 별도 처리가 필요합니다.

제공자당 구성 블록 또는 환경 파일에 세 값을 함께 유지하는 것도 도움이 됩니다. base URL, 키 및 model ID가 나란히 있으면 전환을 한 줄로 되돌릴 수 있으며 새 키가 오래된 주소와 연결되는 부분 마이그레이션 상태를 피할 수 있습니다.

Python: openai 패키지

Python에서는 클라이언트를 생성할 때 기본 URL을 설정합니다. 이 예제는 이 사이트의 엔드포인트에 연결합니다:

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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

코드에 설정을 남기지 않으려면 환경을 사용하세요. SDK는 OPENAI_BASE_URL 및 OPENAI_API_KEY를 읽어들이며, 인자 없이 OpenAI()를 호출하면 배포 시 코드 변경 없이 공급자를 전환할 수 있습니다. 단, 셸의 남은 변수가 파일의 값을 덮어쓸 수 있음을 유의하세요.

Node 및 curl

공식 JavaScript 패키지는 카멜 케이스로 작성된 동일한 옵션 이름을 사용합니다:

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: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

SDK가 전혀 없으면 base URL은 주소의 앞부분일 뿐입니다:

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":"Hello"}]}'

동일한 엔드포인트는 POST /v1/responses도 허용하며, GET /v1/models은 서버가 제공하는 항목을 나열합니다. 인증은 모든 경우에 Authorization 헤더의 베어러 토큰입니다.

편집기 및 채팅 프론트엔드

GUI 도구는 base URL을 "API base", "Override OpenAI Base URL", "Custom endpoint" 또는 "Provider URL"이라는 다른 레이블로 노출합니다. 붙여넣는 값은 위의 코드와 동일한 문자열이며 /v1로 끝납니다. 도구가 전체 URL을 원하는 경우를 제외하고 /chat/completions 주소를 붙여넣지 마십시오.

저장 후 도구가 목록을 가져오지 않으면 model ID를 수동으로 추가하십시오. 일부 편집기는 키를 고정 제공자에 대해 검증하고 사용자 지정 값을 거부합니다. 이 경우 먼저 사용자 지정 또는 OpenAI 호환 모드를 활성화하는 설정을 찾으십시오. Cursor에서 Kimi 스타일 API 키 사용에 대한 기사는 이러한 도구 중 하나를 자세히 설명합니다.

제공자를 교체할 때 변경되는 사항

형식이 일치한다고 해서 동작이 일치하는 것은 아닙니다. 프로덕션 트래픽을 이동하기 전에 다음 항목을 하나씩 확인하십시오:

  • 출력 스타일. 모델마다 글쓰는 방식이 다릅니다. 실제 프롬프트를 실행하여 테스트하십시오. 장난감 예제만으로는 부족합니다.
  • 컨텍스트 창 크기. 이 엔드포인트는 프롬프트와 생성 결과를 합쳐 100,000 토큰의 컨텍스트 창을 제공합니다. 현재 설정에서 더 긴 프롬프트를 보내고 있다면, 먼저 프롬프트를 줄이십시오.
  • 제한 사항. 전체 키는 동시 요청 8개 및 분당 300개를 허용합니다. 어느 한 제한을 초과하면 HTTP 429가 발생하며, 코드는 rate_limited 또는 concurrency입니다.
  • 기능. SSE를 통한 스트리밍, 함수 호출 및 JSON 모드가 지원됩니다. 이미지, 오디오 및 비디오 생성, 임베딩 및 파인튜닝은 지원되지 않으며 이는 텍스트 전용 API입니다.
  • 이름 지을 때. 이 서비스는 합법적인 성인 사용 시 콘텐츠 거부 없이 답변할 수 있도록 선택된 오픈 웨이트 모델 하나를 실행합니다. Moonshot의 공식 API가 아니며, 여러 벤더를 연결하는 라우터도 아닙니다.

중립적인 비교를 위해 동일한 10개의 프롬프트를 두 엔드포인트에 모두 통과시켜 나란히 비교하십시오. 이 작업은 몇 분 정도 걸리며 추측을 줄여줍니다.

Base URL 실수 및 증상

전환 후 대부분의 실패는 키가 아닌 주소에서 비롯됩니다. 각 실수가 어떻게 나타나는지 그리고 이를 수리하는 방법은 다음과 같습니다.

실수증상해결 방법
호스트만 포함, /v1 없음모든 호출에서 404끝에 /v1 추가
전체 경로가 붙여넣어짐오류에 중복된 경로가 있는 404주소를 /v1로 되돌리십시오
추적 슬래시 및 수동 경로 결합URL의 이중 슬래시SDK가 경로에 추가되도록 하십시오
오래된 키, 새로운 URL401새 제공자가 발급한 키를 사용하십시오
오래된 URL, 새로운 키이전 제공자로부터 401레포지토리 및 셸에서 오래된 주소를 검색하십시오
http:// 대신 https://리디렉션 또는 연결 오류모든 곳에 https 사용

남은 항목을 찾는 빠른 방법은 프로젝트 및 배포 설정에서 오래된 호스트 이름을 검색하는 것입니다. .env 파일, CI 변수, Docker compose 파일 및 모든 편집기 설정을 확인하십시오. 잊고 둔 복사본 하나만으로도 일부 트래픽이 이전 제공자로 전송될 수 있기 때문입니다.

전환 후 스트리밍 및 도구

stream: true를 설정하면 응답이 서버 전송 이벤트로 도착하며, 토큰 사용량은 마지막에 보고됩니다. 도구 호출은 일반적인 tools 및 tool_choice 필드를 사용하며, 스트리밍되는 tool_calls과 결과가 role: "tool"이 포함된 메시지로 반환됩니다. 기존 공급자에 대해 이미 이들을 처리하는 코드가 있다면 계속 작동해야 합니다. 완전히 전환하기 전에 스트리밍 호출 하나와 도구 호출 하나를 실행하여 확인하십시오. 스트리밍 요청은 스트림이 끝날 때까지 동시성 슬롯을 점유합니다.

전환 전 비용 확인

여기서는 토큰 단위 과금입니다: 선불 크레딧에서 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50이며 구독이 없습니다. 실패하거나 거부된 요청은 요금이 부과되지 않으며 크레딧은 만료되지 않습니다. 다른 제공자의 요금은 변경되므로 해당 제공자의 현재 가격 페이지를 확인하십시오.

작동 예시. 요청에 2,000개의 입력 토큰과 500개의 출력 토큰이 있다고 가정합니다:

  • 입력: 2,000 / 1,000,000 x $0.15 = $0.0003
  • 출력: 500 / 1,000,000 x $0.50 = $0.00025
  • 총 비용: 요청당 $0.00055, 1,000회 요청 시 $0.55

최소 충전 금액은 $20이며, 더 큰 금액은 보너스를 제공합니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 충전은 암호화폐(TRC20의 USDT, Base의 USDC)로만 가능합니다. 전체 세부 사항은 가격 책정 페이지에서 확인할 수 있으며, Kimi 중심의 상세 내역은 Kimi API 키 가격 책정에서 확인하십시오.

API 키를 가져와 첫 번째 호출을 실행하세요

Google 또는 이메일과 비밀번호로 로그인한 후 API 키 페이지를 엽니다. 신규 사용자는 한 번의 클릭으로 1인당 $0.50의 체험 크레딧을 청구할 수 있으며, 유효 기간은 7일이고 카드 등록이 필요하지 않습니다. 체험용 키는 동시 요청 2개, 분당 60회로 제한됩니다. 이는 테스트 실행에는 충분합니다.

위 Python 스크립트에 키를 붙여넣고 실행하여 텍스트가 반환되는지 확인하세요. 문서에는 모든 파라미터가 나열되어 있으며, 응답 헤더 X-Request-Id 및 X-Balance-USD는 디버깅과 잔액 추적에 도움이 됩니다. 서비스에 전송된 프롬프트는 학습에 사용되지 않습니다.

자주 묻는 질문

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

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

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

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

질문과 답변

Base URL을 변경할 때 코드를 수정해야 하나요?

보통 세 가지 값만 필요합니다: 기본 URL, API 키 및 모델 ID. 새 공급자가 이를 지원하는 한 메시지 형식, 스트리밍 및 도구 호출은 동일하게 유지됩니다.

Base URL에 /v1이 붙어야 하나요?

이 엔드포인트의 경우 예: https://api.kimiapikey.com/v1. SDK가 /chat/completions을 자동으로 추가하므로 포함하지 마세요.

이 공식 Moonshot API인가요?

아닙니다. 이는 OpenAI 호환 API를 통해 제공되는 독립적인 오픈 웨이트 모델입니다. Moonshot의 서비스가 아니며, 여러 벤더를 라우팅하는 서비스도 아닙니다.

모델 ID는 어디에서 찾나요?

API 키를 사용하여 GET /v1/models를 호출하세요. 이 엔드포인트에서 모델 ID는 uncensored입니다.

키를 받기 위해 양식을 하나만 채우면 됩니다

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

API 키 받기문서 읽기