무검열 채팅 완료를 위한 API 문서

빠른 시작: Python 또는 JavaScript로 연결

베이스 URL을 업데이트하고 API 키를 설정하여 API에 연결하세요. 엔드포인트는 표준 채팅 완료 요청을 받아 텍스트를 반환합니다. 인터페이스가 그들의 사양과 정확히 일치하므로 공식 OpenAI SDK를 사용할 때 사용자 정의 라이브러리를 설치할 필요가 없습니다.

연결성을 확인하기 위해 간단한 HTTP 요청으로 시작하세요. 아래 curl 명령을 사용하여 기본 프롬프트를 전송하세요. uncensored 모델입니다. 다음을 교체하십시오. YOUR_API_KEY 대시보드에서 생성한 키를 사용하세요.

Copycurl https://api.aiplayrolebest.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set the character persona to a grumpy detective"}]
  }'

Python 개발자의 경우 프로세스는 거의 동일합니다. 키와 올바른 base URL을 사용하여 클라이언트를 초기화하세요. 이렇게 하면 모든 요청이 기존 도구와의 호환성을 유지하면서 저희의 제한 없는 서버로 라우팅됩니다.

Copyfrom openai import OpenAI

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

JavaScript 사용자는 Node SDK를 사용하여 동일한 결과를 얻을 수 있습니다. 다음을 설정하세요 baseURL 엔드포인트에 속성 추가. 이 방식은 최소한의 코드 변경으로 API를 웹 서버나 백엔드 서비스에 통합할 수 있게 해줍니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.aiplayrolebest.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 키 관리

인증은 헤더에 전달되는 단일 API 키에 기반합니다. 이 키를 다음에 전달하세요. Authorization 모든 요청에 대한 header. 키가 없거나 유효하지 않으면 API는 즉시 401 오류를 반환합니다. 이는 선불 크레따에 대한 안전한 접근을 보장합니다.

대시보드에서 키를 생성하세요. 키는 생성 시 한 번만 표시됩니다. 환경 변수에 안전하게 저장하세요. 공개적으로 공유하지 마세요. 각 계정당 동시에 하나의 활성 키만 지원됩니다. 새 키를 생성하면 이전 키가 즉시 무효화됩니다.

요청에서 키를 다음과 같이 사용하세요: Authorization: Bearer YOUR_API_KEY. 이 표준 헤더 형식은 모든 주요 SDK와 함께 작동합니다. 개발 중 빠른 반복을 위해 키를 가까이 두세요.

채팅 완료 엔드포인트 매개변수

다음으로 요청을 보내세요 /v1/chat/completions 엔드포인트입니다. messages 배열을 포함하고 모델을 uncensored다음과 같은 매개변수를 조정할 수 있습니다 temperature 및 top_p 창의성을 제어합니다. 높은 값은 더 다양한 응답을 생성합니다.

設定 max_tokens 출력 길이를 제한합니다. 지정되지 않은 경우 기본값은 2,048 토큰입니다. 모델은 프롬프트와 완성을 합쳐 100,000개의 토큰 컨텍스트 창을 지원합니다. 이는 잘림 없이 긴 대화를 가능하게 합니다. 다음을 조정하세요 presence_penalty 및 frequency_penalty 역할극 시나리오에서 반복을 줄입니다.

을 사용하세요 stop 특정 구절에서 생성을 중단하기 위한 매개변수입니다. 이는 대화 구조를 강제하는 데 도움이 됩니다. The seed 매개변수는 테스트를 위한 재현 가능한 출력을 보장합니다. 이러한 도구는 모델 동작에 대한 정밀한 제어를 제공합니다.

스트리밍 응답 및 사용량 데이터

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. API는 생성되는 대로 텍스트 청크를 반환합니다. 이는 최종 사용자의 지각된 지연 시간을 줄여줍니다. 각 청크에는 부분 텍스트와 메타데이터가 포함됩니다.

사용량 데이터는 마지막 청크에 표시됩니다. 여기에는 입력 및 출력 토큰 수가 포함됩니다. 다음을 확인하세요. usage field in the last response object. This allows accurate billing verification without separate API calls. Track token consumption in real-time.

스트림 종료를 신중하게 처리하세요. 연결을 닫기 전에 모든 청크를 처리했는지 확인하세요. 마지막 청크에는 완전한 사용량 통계가 포함되어 있습니다. 이 데이터는 프로덕션 애플리케이션에서 비용과 성능을 모니터링하는 데 필수적입니다.

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는 키당 분당 300개의 요청을 제한합니다. 동시 요청은 키당 8개로 제한됩니다. 요청 본문은 8 MB를 초과할 수 없습니다. 이 제한을 초과하면 429 오류가 발생합니다. 일시적인 급증을 처리하려면 지수 백오프를 구현하세요.

자주 발생하는 오류에는 키가 잘못되어 401, 크레딧 부족으로 402가 포함됩니다. 402 응답은 선불 잔액이 고갈되었음을 나타냅니다. 서비스를 계속하려면 계정에 충전하십시오. 오류는 토큰을 소모하지 않으므로 문제를 해결한 후 재시도는 무료입니다.

자세한 오류 메시지를 확인하세요. API는 오류 유형과 메시지를 포함하는 JSON 객체를 반환합니다. 이 정보를 사용하여 문제를 빠르게 디버깅하세요. 적절한 오류 처리는 트래픽이 많은 기간 동안 사용자에게 매끄러운 경험을 보장합니다.

JSON 모드 및 함수 호출 가이드

JSON 모드를 설정하여 사용하세요 response_format 수신하여 {"type": "json_object"}. 이는 모델이 유효한 JSON을 출력하도록 강제합니다. 구조화된 데이터 추출이나 API 응답에 이상적입니다. 원하는 스키마를 명확하게 설명하는 프롬프트를 사용하세요.

함수 호출(Function calling)은 모델이 도구를 호출할 수 있게 합니다. 요청 본문에 도구를 정의하세요. 모델은 적절한 경우 도구 호출을 반환합니다. 이러한 호출은 애플리케이션 로직에서 처리해야 합니다. 이를 통해 복잡한 다단계 워크플로우를 구현할 수 있습니다.

JSON 모드를 함수 호출과 결합하여 견고한 통합을 구현하세요. 클라이언트 측에서 JSON 출력을 검증하세요. tool_choice 함수 호출 시점을 제어하는 파라미터입니다. 이 유연성은 다양한 애플리케이션 아키텍처를 지원합니다. 최적의 성능을 위해 도구를 명확하게 정의하세요.

모델 세부 정보 및 컨텍스트 윈도우 제한

The uncensored 모델은 100,000 토큰의 컨텍스트 윈도우를 지원합니다. 여기에는 입력 프롬프트와 출력 완성문이 모두 포함됩니다. 요청당 최대 출력은 16,000 토큰입니다. 이를 통해 문장 중간에 잘리지 않고 광범위한 롤플레이 시나리오를 실행할 수 있습니다.

이 모델은 오픈 웨이트이며 제한 없는 콘텐츠에 맞춰 튜닝되었습니다. 합법적인 성인 주제를 거부하지 않습니다. GPT, Claude 또는 기타 벤더의 모델이 아닙니다. 요청은 전용 서버에서 처리됩니다. 이는 일관된 성능과 낮은 지연 시간을 보장합니다.

컨텍스트 사용량을 모니터링하여 한도 내에 머무르세요. API는 토큰 사용량을 정확하게 추적합니다. 오류와 거절은 토큰을 소모하지 않습니다. 이러한 투명한 과금 모델은 비용 예측에 도움이 됩니다. 컨텍스트 윈도우를 계획하여 가치를 극대화하세요.