업데이트
무검열 AI 역할극 앱: API로 구축하기
AI 여자친구 API는 대규모 언어 모델을 사용하여 로맨틱하거나 동반자 같은 상호작용을 시뮬레이션하는 채팅 애플리케이션을 위한 전용 인터페이스를 제공합니다. 이 가이드는 표준 콘텐츠 거부 없이 역할극 컨텍스트를 처리하는 무검열 모델에 초점을 맞춰 기술적 접근 방식을 비교합니다.

아키텍처 한 장의 그림
브라우저가 사용자의 메시지를 서버로 보냅니다. 서버는 페르소나와 최근 히스토리를 추가하고 stream: true로 모델에 호출한 후 각 청크를 다시 전달합니다. 그 외에는 아무것도 필요하지 않습니다.
- 브라우저: 텍스트 상자와 토큰이 도착할 때마다 커지는 div.
- 서버: API 키를 유지하고, 메시지 목록을 구성하며, 자체 사용자별 제한을 적용합니다.
- 모델 API:
POST /v1/chat/completions, 엔드포인트https://api.nofilterai.top/v1, 모델uncensored. - 저장소: 대화별 메시지 테이블 또는 파일. SQLite는 시작하기에 충분합니다.
이 모델은 합법적인 성인 사용을 위해 콘텐츠 거부 없이 답변하도록 조정된 단일 오픈 웨이트 모델입니다. 텍스트 전용입니다. 캐릭터 아트나 음성을 원하면 다른 서비스를 직접 추가해야 합니다.
시스템 프롬프트 설계
역할극에서 시스템 프롬프트가 대부분의 작업을 수행합니다. 세계, 캐릭터, 형식 규칙이라는 세 가지 짧은 블록으로 나누어 각각 독립적으로 교체할 수 있게 하세요.
{
"world": "A rain-soaked port city in 1920s Europe, run by rival smuggling families.",
"character": "Ilse, a sharp-tongued ferry captain who trusts nobody but her brother.",
"format": "Write in third person past tense. 2 to 4 short paragraphs. Never write the user's actions or lines."
}
요청 시점에 이들을 하나의 시스템 메시지로 결합하세요. 별도로 유지하면 사용자가 세계와 캐릭터를 독립적으로 선택할 수 있어 역할극 앱의 대부분을 충족합니다. 합법적인 성인 사용을 위해 성인 소설이 허용되므로 자체 이용약관에 한 번 명시하고 연령 확인 장치를 추가하세요. API가 생성하지 않는 유일한 것은 미성년자가 관련된 성적 콘텐츠이며, 앱도 시도하지 않아야 합니다.
스트리밍 백엔드
이 Express 라우트는 대화 ID와 메시지를 받아 히스토리를 로드하고 서버 전송 이벤트로 스트림을 브라우저에 전달합니다. 공식 openai 패키지를 사용합니다.
import express from "express";
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nofilterai.top/v1",
apiKey: process.env.API_KEY,
});
const app = express();
app.use(express.json());
const store = new Map(); // conversationId -> messages
app.post("/chat", async (req, res) => {
const { id, text, persona } = req.body;
const history = store.get(id) ?? [];
history.push({ role: "user", content: text });
res.setHeader("Content-Type", "text/event-stream");
res.setHeader("Cache-Control", "no-cache");
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: persona }, ...trim(history)],
stream: true,
temperature: 0.9,
});
let reply = "";
for await (const chunk of stream) {
const piece = chunk.choices[0]?.delta?.content ?? "";
if (piece) {
reply += piece;
res.write("data: " + JSON.stringify(piece) + "\n\n");
}
}
history.push({ role: "assistant", content: reply });
store.set(id, history);
res.write("data: [DONE]\n\n");
res.end();
});
app.listen(3000);
스트림의 마지막 청크에는 사용량 정보가 포함되어 있어 각 대화의 비용을 확인할 수 있습니다. 프로덕션에서는 Map을 데이터베이스로 교체하고 호출 주위에 오류 처리를 추가하세요.
100k 창 내에서 히스토리 트리밍
프롬프트와 생성을 합한 컨텍스트 창은 100,000 토큰입니다. 역할극 세션은 천천히 성장하지만 성장합니다. 크기를 기준으로 잘라내는 함수는 놀라움을 피합니다. 토큰당 약 4자라는 대략적인 추정은 예산 책정에 충분합니다.
function trim(history, maxChars = 120000) {
let total = 0;
const kept = [];
for (let i = history.length - 1; i >= 0; i--) {
total += history[i].content.length;
if (total > maxChars) break;
kept.unshift(history[i]);
}
return kept;
}
120,000자는 약 30,000 토큰으로 한도보다 훨씬 낮으며 각 호출을 저렴하게 유지합니다. 이야기의 긴 기억력이 필요할 때만 높이세요. 비용 규칙을 기억하세요: 모든 턴은 유지된 히스토리를 입력으로 다시 보내며 토큰 100만 개당 $0.15이므로, 30,000 토큰 프롬프트는 응답 전 턴당 30,000 / 1,000,000 x $0.15 = $0.0045의 비용이 듭니다.
브라우저 클라이언트
페이지는 fetch로 SSE 스트림을 읽고 텍스트가 도착할 때마다 추가합니다. 요청이 POST이므로 EventSource은 적합하지 않으므로 스트림을 수동으로 구문 분석해야 합니다.
async function send(text) {
const out = document.getElementById("reply");
out.textContent = "";
const r = await fetch("/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ id: "demo", text, persona: PERSONA }),
});
const reader = r.body.getReader();
const dec = new TextDecoder();
let buf = "";
while (true) {
const { value, done } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
const parts = buf.split("\n\n");
buf = parts.pop();
for (const p of parts) {
if (p === "data: [DONE]") break;
if (p.startsWith("data: ")) {
out.textContent += JSON.parse(p.slice(6));
}
}
}
}앱처럼 느끼게 하는 기능
- 재생성 및 편집. 메시지 ID를 유지하세요. 재생성은 마지막 어시스턴트 메시지를 삭제하고 동일한 이력으로 API를 다시 호출하는 것을 의미합니다. 편집은 다음 호출 전에 저장된 메시지를 다시 작성하는 것을 의미합니다.
- 캐릭터별 설정.
temperature,top_p및 페널티를 각 캐릭터와 함께 저장하세요. 차분한 캐릭터는 0.7을, 혼란스러운 캐릭터는 1.0을 선호합니다. 재현 가능한 테스트 실행을 원할 때seed을 전달하세요. - 비용 표시.
X-Balance-USD응답 헤더를 읽거나GET /v1/balance를 호출하여 사용자에게 남은 크레딧 금액을 표시하세요. 자신의 사용자에게 접근 권한을 재판매하는 경우 이는 많은 지원 질문을 줄여줍니다. - 자체 안전 레일. 성인 전용 게이트, 신고 버튼 및 미성년자가 관련된 요청을 API에 도달하기 전에 차단하는 규칙을 추가하세요. 플랫폼도 이 제한을 적용하지만 앱도 그래야 합니다.
제한, 오류 및 예산
전체 키는 8개의 동시 요청과 분당 300개의 요청을 허용합니다. 스트리밍 요청은 스트리밍이 끝날 때까지 동시성 슬롯을 유지하므로, 20명의 활성 사용자가 있는 역할극 앱은 바쁜 분 동안 한도에 도달할 수 있습니다. API는 concurrency 또는 rate_limited 코드로 HTTP 429를 응답하며, 일시적 과부하 시 Retry-After: 5를 추가합니다. 서버에서 요청을 큐에 넣고 해당 지연 시간 후에 다시 시도하세요.
실패하거나 거부된 요청은 요금이 부과되지 않으므로 재시도 시 비용이 발생하지 않습니다. 예산 계획을 위해 입력 토큰 3,000개와 출력 토큰 300개로 구성된 일반적인 턴은 $0.00045 + $0.00015 = $0.0006이 소요됩니다. 크레딧은 $20부터 선불로 충전되며 만료되지 않습니다. 이 사이트는 암호화폐, TRC20의 USDT 또는 Base의 USDC를 받습니다. 가격 페이지에서 $50 이상의 보너스를 확인하세요.
다음 단계
API 키를 발급받아 무료 체험 크레딧으로 테스트하세요: API 키 페이지에서는 로그인 후 7일 동안 유효한 $0.50의 크레딧을 제공하며 결제 정보는 필요하지 않습니다. 체험용 키는 동시 요청 2개까지 허용하므로 단일 사용자 프로토타입에 적합합니다. 문서에는 주사위 굴리기나 인벤토리 처리를 함수 호출로 처리하고 싶은 경우를 포함해 모든 파라미터가 나열되어 있습니다.
단일 지속 캐릭터를 가진 동반자 스타일 변형의 경우 AI 동반자 API 기사를 참조하세요. 서버 내부의 채팅 봇의 경우 Discord 봇 가이드를 읽으세요.
더 많은 가이드
질문과 답변
브라우저에서 API를 직접 호출할 수 있나요?
가능하지만 모든 방문자에게 키가 노출됩니다. 키를 서버에 보관하고 자신만의 라우트만 노출하세요.
모델이 내 캐릭터의 행동을 작성하는 것을 어떻게 방지하나요?
시스템 프롬프트에 명시하고, 전사 형식을 사용하는 경우 중단 시퀀스를 추가하세요. 둘 다 전달 매개변수와 함께 작동합니다.
앱이 대화 기록을 저장해야 하나요?
API 자체는 상태가 없으므로 매 턴마다 히스토리를 다시 전송합니다. 프롬프트는 학습에 사용되지 않습니다.
프로토타입을 만드는 가장 저렴한 방법은 무엇인가요?
시험용 키와 메모리의 Map을 사용하세요. 루프가 작동하면 데이터베이스와 충전된 키로 이동하세요.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.
API 키 받기