채팅봇 API 통합: 앱에 채팅 엔드포인트 연결하기
채팅봇 API 연동에는 건너뛸 수 없는 규칙이 하나 있습니다: 브라우저는 API 키를 절대 보유하지 않습니다. 중간에 작은 백엔드 프록시를 두고 스트리밍으로 응답을 전달하면 나머지는 일반적인 웹 개발입니다.
업데이트

주요 포인트
- 브라우저는 서버와 통신하고, 서버는 키를 사용하여 채팅 API와 통신합니다.
- 서버 전송 이벤트를 사용하여 스트리밍하면 응답이 단어 단위로 나타납니다.
- 기록을 제한하고 사용자별 제한을 설정하며, 짧은 대기 시간으로 429 응답을 처리하세요.
- 이 엔드포인트는 OpenAI 호환 형식이므로 Base URL 변경 후 공식 SDK가 작동합니다.
하나의 그림으로 보는 패턴
모든 안전한 채팅봇 API 연동은 위에서 보았을 때 동일해 보입니다. 브라우저의 페이지가 사용자의 메시지를 자신의 엔드포인트로 전송합니다. 서버는 시스템 프롬프트를 추가하고, 대화 기록을 잘라내고, API 키를 첨부한 후 호출을 전달합니다. 응답은 같은 방식으로 스트리밍되어 돌아옵니다.
Browser --POST /api/chat--> Your server --POST /v1/chat/completions--> Chat API
Browser <--SSE stream------ Your server <--SSE stream----------------- Chat API
프록시는 네 가지 이유로 존재합니다: 키를 숨기고, 호출자를 확인하며, 사용자별 비용 한도를 설정하고, 나중에 모델 설정을 변경할 수 있는 단일 위치를 제공합니다. 프론트엔드 JavaScript에 배치된 키는 페이지가 로드되는 순간 공개되며, 다른 사람이 선불 크레딧을 사용할 수 있습니다.
API는 OpenAI 형식을 따릅니다. Base URL은 https://api.uncensoredchatbotapi.com/v1이며, 모델은 uncensored이고, 인증은 Authorization: Bearer YOUR_KEY입니다. 키 페이지에서 키를 얻으세요.
1단계: 서버 프록시
이 Express 서버는 대화를 받아 시스템 프롬프트를 추가하고 스트리밍으로 API를 호출한 후 텍스트를 중계합니다. npm i express openai로 의존성을 설치하고 환경에 CHAT_API_KEY을 설정하세요.
import express from "express";
import OpenAI from "openai";
const app = express();
app.use(express.json({ limit: "200kb" }));
app.use(express.static("public"));
const client = new OpenAI({
baseURL: "https://api.uncensoredchatbotapi.com/v1",
apiKey: process.env.CHAT_API_KEY,
});
const SYSTEM = "You are a helpful companion for adults. Keep replies under 150 words.";
app.post("/api/chat", async (req, res) => {
const incoming = Array.isArray(req.body.messages) ? req.body.messages : [];
const clean = incoming
.filter((m) => ["user", "assistant"].includes(m.role) && typeof m.content === "string")
.slice(-20)
.map((m) => ({ role: m.role, content: m.content.slice(0, 4000) }));
res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache" });
try {
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "system", content: SYSTEM }, ...clean],
stream: true,
});
for await (const part of stream) {
const t = part.choices[0]?.delta?.content;
if (t) res.write(`data: ${JSON.stringify(t)}\n\n`);
}
res.write("data: [DONE]\n\n");
} catch (e) {
res.write(`event: error\ndata: ${JSON.stringify(e.status === 429 ? "busy" : "failed")}\n\n`);
}
res.end();
});
app.listen(3000);
필터에 주목하세요. 클라이언트는 어떤 것이든 보낼 수 있으므로 서버는 user 및 assistant 메시지만 유지하고, 각각을 잘라내며 브라우저가 삽입하려는 system 메시지를 무시합니다. 시스템 프롬프트는 항상 코드에서 제공됩니다.
2단계: 브라우저 측
브라우저는 fetch로 스트림을 읽고 도착하는 텍스트를 추가합니다. 라이브러리가 필요하지 않습니다.
const messages = [];
async function send(text, out) {
messages.push({ role: "user", content: text });
const res = await fetch("/api/chat", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ messages }),
});
const reader = res.body.getReader();
const dec = new TextDecoder();
let reply = "", buf = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
const events = buf.split("\n\n");
buf = events.pop();
for (const ev of events) {
if (ev === "data: [DONE]") break;
if (ev.startsWith("data: ")) {
reply += JSON.parse(ev.slice(6));
out.textContent = reply;
}
}
}
messages.push({ role: "assistant", content: reply });
}
버퍼가 중요합니다. 네트워크 청크는 이벤트 경계와 일치하지 않으므로 빈 줄에서 나누고 다음 읽기를 위해 완료되지 않은 꼬리 부분을 유지합니다. 페이지 자체에 대한 설명은 웹 채팅 튜토리얼을 참조하고, 사이트에 봇을 추가하는 더 넓은 그림에 대해서는 웹사이트에 채팅봇 구현 방법을 참조하세요.
제한, 오류 및 재시도
전용 키는 동시 요청 8개와 분당 300개의 요청을 허용합니다. 체험 키는 각각 2개와 60개를 허용합니다. 스트리밍 요청은 스트림이 끝날 때까지 슬롯을 점유하므로, 8개의 슬롯이 있으면 동시에 최대 8개의 실시간 응답만 처리할 수 있습니다. 사이트의 동시 사용자가 이보다 많다면 서버에서 요청을 큐에 넣고 실패하는 대신 "잠시만 기다려 주세요"라고 응답하세요.
concurrency가 포함된 429: 진행 중인 요청이 너무 많습니다. 큐에 넣고 재시도하세요.- 429 (
rate_limited): 분당 요청 수가 너무 많습니다. 요청 속도를 줄이세요. Retry-After: 5헤더가 포함된 429: 일시적 과부하입니다. 5초 동안 기다린 후 다시 시도하세요.- 401: 키가 잘못되었거나 누락되었습니다.
- 8 MB를 초과하는 본문: 거부됨, 전송할 내용을 잘라내세요.
서버가 최대 8개의 업스트림 스트림만 열 수 있도록 작은 메모리 내 카운터를 추가하세요:
let active = 0;
const MAX = 8;
app.use("/api/chat", (req, res, next) => {
if (active >= MAX) return res.status(503).json({ error: "busy" });
active++;
res.on("close", () => { active--; });
next();
});
채팅 라우트 전에 이 미들웨어를 등록하세요. close 이벤트는 응답이 끝나거나 사용자가 떠날 때 발생하므로 카운터가 누출되지 않습니다.
각 대화의 비용 제어
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 각 턴에서 기록이 다시 전송되므로 기록의 한도가 가장 큰 변수입니다. 마지막 20개 메시지(각각 약 60 토큰)와 100 토큰 시스템 프롬프트를 사용하면 요청에는 약 1,300개의 입력 토큰이 포함됩니다. 150 토큰의 응답은 출력을 추가합니다.
턴당 비용: 1,300 / 1,000,000 x $0.15 = $0.000195, 여기에 150 / 1,000,000 x $0.50 = $0.000075를 더해 총 $0.00027입니다. 이 크기의 30턴 세션은 초기 턴이 더 짧으므로 최대 $0.0081이 소요됩니다. 사용자별 일일 제한(예: 100개 메시지)이 있는 경우, 사용자당 하루 최대 비용은 100 x $0.00027 = $0.027로 제한됩니다. 사이트 봇 가격 책정에 대해 더 자세히 알아보려면 웹사이트 비용의 채팅봇 페이지를 읽고, max_tokens과 같은 매개변수를 위해 문서를 사용하십시오.
누가 프록시를 호출하고 있나요?
프록시는 키를 보호하지만, URL을 찾은 누구나 사용할 수 있는 무료 채팅 엔드포인트가 됩니다. 출시 전에 누가 이를 사용할 수 있는지 결정하세요.
공개 사이트의 경우 로그인 시 설정된 서명된 세션 쿠키가 일반적인 해결책입니다. 라우트 상단에서 이를 확인하고 누락 시 401을 반환하세요. 빠른 프로토타입의 경우 express-rate-limit과 같은 패키지를 사용한 IP당 제한이 나을 수 있지만, 공유 네트워크는 IP 제한을 무뎌지게 만듭니다. 선택한 것에 관계없이 연결당이 아닌 사용자당 메시지를 세고, 재시작으로 초기화될 수 없는 곳에 계수를 저장하세요.
앱이 성장하면 대화 기록을 서버에 보관하세요. 모든 턴에서 브라우저에서 전체 기록을 보내는 것은 구축하기 쉽지만 사용자가 이를 편집할 수 있습니다. 대화 ID로 데이터베이스에 메시지를 저장하고, 각 요청마다 마지막 20개를 로드한 후 스트림이 끝난 후 응답을 추가하세요. 이렇게 하면 사용자가 탭을 닫고 같은 채팅으로 돌아올 수도 있습니다.
출시 전
짧은 체크리스트는 출시 당일의 혼란을 줄입니다.
- 키는 서버의 환경 변수에만 존재하며, 저장소에는 포함되지 않습니다.
- 서버는 클라이언트에서 오는 모든 시스템 메시지를 무시합니다.
- 각 사용자는 하루 메시지 한도 및 메시지 길이 한도가 있습니다.
- 오류는 친절한 메시지를 표시하며 내부 세부 정보를 콘솔에 출력하지 않습니다.
X-Request-Id헤더의 요청 ID와 토큰 수를 로그에 남기고, 전체 텍스트는 남기지 않습니다.X-Balance-USD를 모니터링하고 크레딧이 부족할 때 알림을 받습니다.- 약관에는 성인 전용 대상이 명시되어 있으며, 봇은 미성년자가 포함된 성적인 콘텐츠를 생성하지 않습니다.
마지막 항목은 성인 채팅봇 안전성 가이드와 공유됩니다. 이 API의 모델은 합법적인 성인 사용에 콘텐츠 거부 없이 답변하도록 조정되어 있어, 자체적인 연령 제한 및 검열 규칙이 덜 중요한 것이 아니라 더 중요합니다. 여기서 충전은 암호화폐(USDT on TRC20 또는 USDC on Base)로만 가능하며, $20부터 $500까지이며, 신규 사용자는 먼저 $0.50 체험 크레딧을 청구할 수 있습니다.
더 많은 가이드
질문과 답변
브라우저에서 JavaScript로 API를 직접 호출할 수 없는 이유는 무엇인가요?
네트워크 탭을 연 모든 사람이 API 키를 볼 수 있기 때문입니다. 백엔드 프록시는 키를 서버에 보관하고 사용자별 제한을 추가할 수 있게 해줍니다.
API가 스트리밍을 지원하나요?
네. stream을 true로 설정하면 API는 서버 전송 이벤트를 전송하며, 끝에 사용 내역이 포함됩니다. 프록시는 이러한 이벤트를 브라우저로 전달할 수 있습니다.
어떤 SDK를 사용해야 하나요?
어떤 OpenAI SDK나 HTTP 클라이언트든 작동합니다. Base URL을 https://api.uncensoredchatbotapi.com/v1로 변경하고 API 키를 설정한 후, 모델을 uncensored로 설정하세요.
너무 많은 사용자가 동시에 채팅하면 어떻게 되나요?
전용 키는 동시 요청 8개를 허용합니다. 그 이상일 경우 API는 동시성 코드로 429를 반환하므로, 추가 요청을 서버에서 큐에 넣고 잠시 후 재시도하세요.