Kimicode 사용자를 위한 Quickstart

사전 준비

코드를 작성하기 전에 kimicode.cc에서 Google 또는 이메일로 계정을 생성하세요. 즉시 단일 API 키를 받게 됩니다. 전화번호 인증과 신용카드 모두 필요하지 않습니다. 계정은 7일 동안 유효한 무료 체험 크레딧 $0.50으로 시작됩니다. 더 많은 용량이 필요하면 USDT(TRC20) 또는 USDC(Base)를 통해 암호화폐로 충전할 수 있으며 최소 $10부터 가능합니다. 크레딧은 만료되지 않으며, 오류나 거절은 토큰을 소모하지 않습니다.

개발 환경에 Node.js(v18+) 또는 Python 3.8+가 설치되어 있어야 합니다. 이 API는 openai 클라이언트 사양을 엄격히 따르므로 라이브러리 로직을 변경하지 않고도 엔드포인트를 교체할 수 있습니다. 우리는 ID uncensored의 무검열 모델을 제공합니다.

SDK 설치

선호하는 언어에 대한 공식 OpenAI SDK를 설치하세요. 이는 스트리밍, 함수 호출, JSON 모드 기능과의 호환성을 보장합니다.

Python의 경우 pip를 사용하여 표준 라이브러리를 설치하세요:

• pip install openai

Node.js의 경우 npm 패키지를 설치하세요:

• npm install openai

이 라이브러리들은 HTTP 포맷팅을 자동으로 처리합니다. 벤더별 클라이언트가 필요하지 않습니다. kimicode API는 temperature, top_p, max_tokens과 같은 표준 매개변수를 지원합니다.

클라이언트 초기화

kimicode 기본 URL과 API 키로 클라이언트 객체를 구성하세요. 기본 URL은 https://api.kimicode.cc/v1입니다. api_key을 가입 시 받은 값으로 설정하세요. 이 구성은 기본 api.openai.com 엔드포인트를 대체합니다.

• 기본 URL: https://api.kimicode.cc/v1
• 모델: uncensored
• 인증: api_key를 통한 Bearer 토큰

이 키를 다른 벤더와 혼용하지 마세요. 이 키는 kimicode 엔드포인트와만 작동합니다. 클라이언트는 첫 번째 요청에서 키를 검증합니다. 키가 유효하지 않으면 즉시 401 오류가 발생합니다.

요청 보내기

표준 채팅 완료 요청을 보내세요. 모델 ID는 uncensored이어야 합니다. max_tokens은 최대 32,000까지 조정할 수 있습니다. 생략하면 기본값은 2,048입니다. 컨텍스트 창은 프롬프트와 완료를 합쳐 총 100,000 토큰입니다.

• 입력: messages 배열의 텍스트 메시지.
• 출력: choices[0].message.content의 텍스트 응답.

이 엔드포인트는 response_format: {"type": "json_object"}를 통해 JSON 모드를 지원합니다. 임베딩, 이미지 또는 오디오는 지원되지 않습니다. 합법적인 성인 주제에 대한 콘텐츠 거절 없이 고품질 텍스트 생성에 집중하세요.

스트리밍 응답

stream: true을 설정하여 스트리밍을 활성화하세요. API는 Server-Sent Events(SSE)를 반환합니다. 각 청크에는 부분 텍스트가 포함됩니다. 토큰 사용 통계는 스트림의 마지막 청크에 포함됩니다. 이를 통해 전체 응답을 기다리지 않고도 출력을 실시간으로 표시할 수 있습니다.

• 스트림 플래그: 요청 본문에서 true로 설정하세요.
• 이벤트 유형: chat.completion.chunk
• 데이터: 텍스트 부분에는 delta.content이 포함됩니다.

스트리밍은 가격 책정에 영향을 주지 않습니다. 처리된 총 토큰에 대해 지불합니다. 스트리밍 중 오류는 정상적으로 처리됩니다. 연결이 끊기면 요청을 다시 시작할 수 있습니다. 무검열 모델은 100k 제한 내에서 긴 스트리밍에서도 일관성을 유지합니다.

제한, 오류 및 컨텍스트 창

사용량 제한을 모니터링하세요: 키당 분당 300개 요청, 동시 요청 8개, 요청 본문 8 MB. 속도 제한을 초과하면 429 오류가 발생합니다. 선불 크레딧이 고갈되면 402 오류가 발생하며, 크립토로 충전하여 계속하세요. 401 오류는 유효하지 않거나 누락된 API 키를 나타냅니다. 실패한 요청과 거부는 토큰을 소모하지 않습니다. 콘텐츠 제한은 미성년자 관련 성적인 콘텐츠를 차단합니다. 기타 모든 합법적인 성인 콘텐츠는 허용됩니다.

함수 호출

tools 매개변수에서 도구를 정의하세요. 모델은 응답에서 함수 호출을 반환합니다. tool_choice을 사용하여 특정 동작을 강제하세요. 이 기능은 OpenAI 표준과 동일하게 작동합니다. 코드에서 함수 호출을 구문 분석하고 실행하세요. 결과를 후속 메시지로 보내세요. kimicode API는 도구 정의를 효율적으로 처리합니다. JSON 스키마가 유효한지 확인하세요. 함수 호출은 토큰 사용량 외에 추가 크레딧이 필요하지 않습니다. 에이전트 구축 또는 구조화된 데이터 추출 워크플로우에 이상적입니다.

cURL

Copycurl https://api.kimicode.cc/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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.cc/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

Copyimport OpenAI from "openai";

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

스트리밍

Copystream = 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)