API 문서

빠른 시작: 첫 번째 요청 보내기

uncensored 모델에 즉시 첫 번째 메시지를 보내세요. 텍스트 생성을 위해 표준 chat-completions 엔드포인트를 사용하세요. 모델은 합법적인 성인 사용에 대한 콘텐츠 거부 없이 자연어 프롬프트에 응답합니다. 이 설정은 모든 OpenAI 호환 클라이언트와 함께 작동합니다.

선호하는 언어용 SDK를 설치하세요. 그런 다음 API 키를 구성하세요. 다음 예시는 연결성을 테스트하기 위한 기본 curl 요청을 보여줍니다.

temperature과 같은 매개변수를 조정하여 무작위성을 제어할 수 있습니다. 응답은 생성된 텍스트를 직접 반환합니다. 이 간단한 흐름을 통해 복잡한 로직을 구축하기 전에 API가 작동하는지 확인할 수 있습니다.

Copycurl https://api.apiaicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API rate limit status?"}]
  }'

Base URL 및 인증

이 API를 위한 전용 베이스 URL을 사용하여 연결하세요. 기본 엔드포인트를 우리 호스팅 서버 주소로 교체하세요. 이렇게 하면 요청이 비제약 모델에 직접 도달합니다. 인증은 계정당 단일 API 키에 의존합니다.

대시보드에서 키를 생성하세요. Authorization 헤더에 Bearer 토큰으로 전달하세요. 이 방법은 표준 OpenAI SDK와 호환됩니다. 기본 URL과 키만 변경하여 공급자를 전환할 수 있습니다.

키는 안전하게 보관하세요. 이 키는 선불 크레딧에 대한 전체 접근 권한을 부여합니다. 키는 생성 시 이전 활성 키를 즉시 대체합니다.

엔드포인트: 채팅 완료

chat completions 엔드포인트를 통해 모델과 상호작용합니다. 유일한 텍스트 생성 엔드포인트이며 메시지를 받아 생성된 텍스트를 반환합니다. 임베딩, 이미지, 오디오는 지원되지 않습니다.

채팅 라우트로 POST 요청을 보내십시오. 본문에 시스템 및 사용자 메시지를 포함하십시오. 모델은 컨텍스트를 처리하고 응답을 생성합니다. 구조화된 출력을 위해 JSON 모드를 사용할 수 있습니다.

함수 호출이 지원됩니다. 도구를 정의하고 모델이 언제 사용할지 결정하게 하세요. 이 유연성은 복잡한 에이전트 워크플로우를 가능하게 합니다. 응답에는 생성된 콘텐츠와 토큰 사용량이 포함됩니다.

Copyfrom openai import OpenAI

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

파라미터: Temperature, Top P, Stop

표준 파라미터를 사용하여 출력 스타일을 제어하세요. temperature를 조정하여 창의성을 변경하세요. 낮은 값은 응답을 더 결정론적으로 만듭니다. 높은 값은 더 많은 다양성을 도입합니다.

top P를 사용하여 가능성이 낮은 단어를 필터링하세요. 이는 창의성을 허용하면서 일관성을 유지하는 데 도움이 됩니다. 특정 마커에서 생성을 종료하기 위해 stop 시퀀스를 설정하세요. 이는 대화 구조를 제어하는 데 유용합니다.

seed 파라미터는 재현 가능한 결과를 제공합니다. 프롬프트 디버깅 시 사용하세요. 이러한 파라미터는 모델 동작에 정밀한 제어를 제공합니다. 애플리케이션의 요구 사항에 맞게 미세 조정하세요.

Copyimport OpenAI from "openai";

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

스트리밍 및 토큰 사용량

서버 전송 이벤트를 사용하여 실시간으로 응답을 받아보세요. 스트리밍은 사용자에게 지각된 지연 시간을 줄여줍니다. API는 토큰이 생성되는 대로 토큰을 전송합니다. 이는 더 부드러운 읽기 경험을 제공합니다.

토큰 사용량은 마지막 청크에 보고됩니다. 이를 통해 비용을 정확하게 추적할 수 있습니다. 청구는 실제 소비된 토큰을 기준으로 합니다. 오류 및 거절에는 요금이 부과되지 않습니다.

데이터를 처리하기 위해 스트림 핸들러를 구현하세요. 토큰이 도착할 때 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)

속도 제한 및 제약 조건

서비스 중단 방지를 위한 제한 사항을 이해하세요. 키당 분당 300개의 요청을 보낼 수 있습니다. 동시 요청은 최대 8개로 제한됩니다. 요청 본문은 8MB를 초과할 수 없습니다.

오류를 우아하게 처리하세요. 401 상태는 키가 유효하지 않음을 의미합니다. 402 상태는 크레딧이 부족함을 나타냅니다. 429 상태는 속도 제한에 도달했음을 신호합니다.

컨텍스트 윈도우는 프롬프트와 완성 텍스트를 합해 총 100,000개의 토큰을 지원합니다. 요청당 최대 출력은 16,000개 토큰입니다. 출력 길이를 제어하려면 max_tokens을 설정하세요. 오류는 무료이므로 재시도 로직이 안전합니다.