API 문서: OpenAI 호환 엔드포인트

인증 및 Base URL

고유한 키와 기본 URL을 환경 변수에 설정하여 API에 액세스하세요. 엔드포인트는 다음에 위치합니다 https://api.apikeykimi.com/v1헤더 Authorization: Bearer YOUR_API_KEY 매번 요청 시 포함됩니다. 이 키는 Google 또는 이메일을 통해 가입하는 즉시 생성됩니다. 인증에 필요한 유일한 자격 증명이며, 추가적인 범위나 권한 설정이 필요하지 않습니다.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

채팅 완료 엔드포인트

표준 /v1/chat/completions 엔드포인트입니다. 모델 ID를 uncensored 요청 본문에서. API는 프롬프트 기록에 기반하여 생성된 텍스트를 반환합니다. 창의력을 제어하기 위해 온도와 top_p와 같은 매개변수를 조정할 수 있습니다. 모델은 구조화된 출력을 위해 함수 호출 및 JSON 모드를 지원합니다.

Copyfrom openai import OpenAI

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

스트리밍 응답 (SSE)

다음 설정하여 실시간 토큰 전달 활성화 stream: true 요청에 포함됩니다. 서버는 응답이 완료될 때까지 부분 텍스트를 포함하는 청크를 반환합니다. 이는 채팅 인터페이스와 라이브 코딩 디스플레이에 이상적입니다. 토큰 사용량 세부 정보는 스트림의 마지막 청크에 나타납니다.

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)

함수 호출 & JSON 모드

도구를 정의하거나 JSON 출력을 강제하려면 response_format 파라미터. json_object 유효한 JSON 응답을 보장합니다. 함수 호출을 위한 도구 정의도 전달할 수 있습니다. 모델은 이러한 제약 조건을 엄격히 준수합니다. 이를 통해 외부 서비스와의 신뢰할 수 있는 통합이 가능합니다. 사용 tool_choice 도구 호출 방식을 제어합니다.

토큰 제한 & 제약 조건

컨텍스트 윈도우는 입력과 출력을 합쳐 최대 100,000개의 토큰을 지원합니다. 요청당 최대 출력은 16,000개 토큰입니다. 설정하지 않을 경우 max_tokens, 제한은 기본값이 2,048 토큰입니다. 요청 본문 크기는 8 MB로 제한됩니다. 분당 300회 요청이 제한됩니다. 키당 동시에 실행할 수 있는 요청은 8개입니다.

오류 처리 & 사용량 제한

HTTP 상태 코드를 확인하여 오류를 처리하세요. 401은 유효하지 않거나 만료된 API 키를 나타냅니다. 402 오류는 사전 지불 크레딧이 고갈되었음을 의미합니다. 429 응답은 1분당 300개 요청의 속도 제한을 초과했음을 신호합니다. 오류 및 거부는 토큰을 소모하지 않습니다. 중단되지 않도록 대시보드에서 잔액을 확인하세요.

Node.js

Copyimport OpenAI from "openai";

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