빠른 시작: AI 여자친구 API 통합

기본 URL 및 인증

당사의 API는 OpenAI chat-completions 표준을 따르므로 기존 클라이언트와의 통합이 간단합니다. 모든 요청의 Authorization 헤더에 API 키를 포함해야 합니다. 모든 엔드포인트의 기본 URL은 https://api.roleplayapi.com/v1입니다. 공식 SDK를 사용할 경우 base_url 구성을 이 주소로 업데이트하고 api_key로 키를 제공하세요. 이 설정은 표준 로직 변경 없이 요청이 전용 무검열 엔드포인트에 도달하도록 보장합니다.

응답 받기

/v1/chat/completions에 POST 요청을 보내 대화를 시작하세요. 모델 식별자는 uncensored입니다. 컨텍스트를 설정하거나 새로운 대화를 시작하기 위해 messages 배열에 여러 개의 메시지를 전달할 수 있습니다. 응답에는 모델의 텍스트 출력이 포함되어 있으며, 이를 스트리밍하거나 JSON 객체로 파싱할 수 있습니다. 이 엔드포인트는 캐릭터 기반 앱에 필요한 핵심 텍스트 입력 및 출력 상호작용을 처리합니다.

Copycurl https://api.roleplayapi.com/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."}]
  }'

Python SDK 통합

공식 openai Python 라이브러리를 사용하여 최소한의 보일러플레이트로 API와 상호작용하세요. 기본 URL과 API 키로 클라이언트를 구성한 후, chat.completions.create를 uncensored 모델 ID와 함께 호출하세요. 이 방식은 기존 타입 힌트와 오류 처리 메커니즘을 활용하므로 HTTP 파싱보다 애플리케이션 로직에 집중할 수 있습니다. 응답 객체는 생성된 콘텐츠에 직접 접근할 수 있게 합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.roleplayapi.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 통합

JavaScript 및 TypeScript 프로젝트의 경우 OpenAI Node SDK는 API 호출을 위한 깔끔한 인터페이스를 제공합니다. 사용자 지정 기본 URL과 비밀 키로 클라이언트를 초기화하세요. uncensored 모델을 사용하여 채팅 완성 엔드포인트를 호출하세요. 이 방법은 비동기 요청을 효율적으로 관리해야 하는 웹 서버나 엣지 함수에 이상적입니다. SDK는 JSON 페이로드의 직렬화 및 역직렬화를 자동으로 처리합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.roleplayapi.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)를 활성화하여 지각된 지연 시간을 줄이세요. 요청에서 stream 매개변수를 true로 설정하세요. 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회의 속도 제한을 따릅니다. 이를 초과하면 API는 429 상태 코드를 반환합니다. 인증 실패는 401 오류를 발생시키고, 선불 크레딧 부족은 402 오류를 트리거합니다. 컨텍스트 창은 프롬프트와 응답의 합계가 최대 100,000 토큰까지 지원됩니다. 사용 가능한 모델을 확인하려면 /v1/models에 GET 요청을 보내십시오. 요청 본문이 8 MB를 초과하지 않도록 하십시오.