API 문서 - KimiCode

Base URL 및 인증

기본 URL을 업데이트하고 헤더에 키를 제공하여 API에 코드를 연결하세요. 표준 인증을 지원하므로 기존 OpenAI SDK 클라이언트는 복잡한 설정 없이 즉시 작동합니다. API 키는 Google 또는 이메일로 가입한 후 즉시 표시되며 전화번호 인증이 필요하지 않습니다.

각 계정은 동시에 하나의 활성 키만 보유하며, 새 키를 생성하면 이전 키가 교체됩니다. 요청은 Authorization 헤더를 통해 인증되어 선불 크레딧에 대한 안전한 접근을 보장합니다.

첫 번째 요청

간단한 POST 요청으로 표준 채팅 completion 엔드포인트를 사용하여 첫 번째 메시지를 보내세요. 이는 고급 기능이나 스트리밍 데이터로 들어가기 전에 통합이 작동하는지 확인합니다. 응답은 uncensored 모델에서 텍스트 출력을 반환합니다.

• YOUR_API_KEY를 대시보드의 키로 교체하세요.
• 모델을 'uncensored'로 설정하여 당사 전용 오픈 웨이트 모델을 사용하세요.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Python SDK 통합

기본 URL을 가리켜 우리 API와 상호작용하세요. 이 방법은 친숙한 구문을 활용하여 전체 애플리케이션 로직을 다시 작성하지 않고도 제공업체를 전환할 수 있게 해줍니다. 라이브러리가 토큰화 및 요청 형식을 자동으로 처리합니다.

• pip를 통해 openai 패키지를 설치하세요.
• 기본 URL을 당사 서비스와 연결하세요.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicodepricing.com/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 SDK를 사용하여 JavaScript 또는 TypeScript 애플리케이션에 당사 API를 통합하세요. 이를 통해 프론트엔드와 백엔드 환경 간에 일관된 동작을 보장할 수 있습니다. 표준 OpenAI 호환 서비스와 동일하게 메시지를 전달하고 응답을 받을 수 있습니다.

Copyimport OpenAI from "openai";

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

스트리밍 및 토큰 사용량

서버 전송 이벤트(SSE)를 통해 실시간 토큰 생성을 받도록 스트리밍을 활성화하세요. 이는 사용자의 인지된 지연 시간을 줄이고 부분 결과를 즉시 표시할 수 있게 합니다. 입력 및 출력 횟수를 포함한 토큰 사용량 데이터는 스트림의 마지막 청크에 포함됩니다.

이 방법은 즉각적인 피드백이 중요한 채팅 인터페이스에 이상적입니다. 전체 응답을 기다리지 않고 스트림을 파싱하여 UI를 점진적으로 업데이트할 수 있습니다.

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)

제한 사항, 오류 및 컨텍스트

속도 제한과 일반적인 오류 코드를 이해하여 사용량을 관리하세요. API는 100,000 토큰의 컨텍스트 창을 지원하여 깊은 대화 기록을 허용합니다. 키당 분당 300회 요청 및 최대 8개의 동시 요청으로 제한됩니다.

• 401은 유효하지 않거나 누락된 API 키를 나타냅니다.
• 402는 선불 크레딧이 소진되었음을 신호합니다.
• 429는 속도 제한을 초과했음을 의미합니다.

오류는 크레딧이 소모되지 않으므로 실패한 요청을 패널티 없이 재시도할 수 있습니다.