Kimicode: 5분 내 첫 요청

기본 URL 및 인증

클라이언트를 기본 URL로 설정하세요: https://api.kimicode.top/v1. 모든 요청에 API 키가 필요합니다. 사이트에서 API 키 받기를 클릭하여 생성하세요. Google 로그인 또는 이메일과 비밀번호를 사용합니다. 전화번호는 필요하지 않습니다. 키는 생성 직후 표시됩니다. 안전하게 보관하세요. 계정당 활성 키는 하나입니다. 새 키를 생성하면 이전 키는 더 이상 작동하지 않습니다. Authorization 헤더에 베어러 토큰으로 키를 전달하세요.

첫 번째 요청

채팅 완료 엔드포인트로 첫 번째 프롬프트를 보내세요. 모델 ID는 uncensored를 사용하세요. API는 표준 OpenAI 호환 형식을 받아들입니다. 입력이 들어가면 텍스트가 나옵니다. 오류와 거부는 무료이므로 성공적인 토큰 사용에만 요금이 부과됩니다. 간단한 프롬프트로 연결성을 테스트하세요.

복사curl https://api.kimicode.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."}]
  }'

키가 유효하지 않으면 401 오류가 발생합니다. 크레딧이 부족하면 402가 발생합니다. 요청이 예상치 않게 실패할 경우 계정 잔액을 확인하세요.

Python SDK 통합

공식 OpenAI Python SDK를 사용하세요. 기본 URL을 엔드포인트로 설정하세요. API 키를 전달하세요. 클라이언트는 요청 형식을 자동으로 처리합니다. OpenAI 호환 클라이언트를 지원하는 모든 언어에서 작동합니다. pip를 통해 라이브러리를 설치하세요. 기본 URL과 키로 클라이언트를 구성하세요. 채팅 완료 엔드포인트를 사용하여 메시지를 보내세요. 응답에는 생성된 텍스트가 포함됩니다. 응답 객체에서 내용을 직접 구문 분석할 수 있습니다.

복사from openai import OpenAI

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

코드에서 예외를 적절히 처리하세요. 네트워크 문제나 속도 제한으로 인해 재시도가 필요할 수 있습니다.

Node SDK 사용법

Node.js SDK도 동일하게 작동합니다. 클라이언트를 가져오세요. 기본 URL과 API 키를 구성하세요. 채팅 완료 메서드를 호출하세요. 모델 ID와 메시지 배열을 전달하세요. 응답 구조는 OpenAI 형식과 일치합니다. 어시스턴트 메시지 내용을 추출하세요. 이 접근 방식은 서버 측 생성 또는 엣지 함수에 적합합니다. 기본 URL 변경 외에도 추가 구성이 필요하지 않습니다.

복사import OpenAI from "openai";

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

상태 코드를 확인하여 오류를 처리하세요. 속도 제한은 429를 반환합니다. 자금 부족은 402를 반환합니다.

스트리밍 응답

stream: true를 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE)를 반환합니다. 각 청크에는 부분 콘텐츠가 포함됩니다. 토큰 사용 세부 정보는 마지막 청크에 나타납니다. 이는 긴 출력의 지각된 지연 시간을 줄입니다. 스트림 종료를 적절히 처리하세요. 스트림이 끝나거나 오류가 발생하면 연결을 닫으세요. 스트리밍은 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)

클라이언트가 청크를 올바르게 버퍼링하도록 하세요. 최종 응답을 형성하려면 콘텐츠를 연결하세요.

제한, 오류 및 컨텍스트

컨텍스트 창은 총 100,000 토큰입니다. 별도의 출력 제한이 없습니다. max_tokens이 설정되지 않은 경우 응답은 창 끝까지 이어질 수 있습니다. 속도 제한은 키당 분당 300 요청입니다. 동시 요청 제한은 8개입니다. 요청 본문 최대 크기는 8 MB입니다. 오류에는 유효하지 않은 키에 대한 401, 크레딧 없음에 대한 402, 속도 제한 오류(429)가 포함됩니다. 크레딧은 만료되지 않습니다. 오류는 무료입니다. 구독 함정이 없습니다.