빠른 시작: 무검열 채팅 API 연동
빠른 시작 가이드를 사용하여 NSFW 비디오 생성 파이프라인에 무검열 채팅 API를 연동하세요. 표준 OpenAI 호환 클라이언트를 사용하여 성인 콘텐츠에 대한 프롬프트 엔지니어링, 스크립트 작성, 메타데이터 추출을 처리하세요.
인증 및 기본 URL
API는 https://api.nsfwvideogenerator.cc/v1에 호스팅됩니다. 인증하려면 Authorization 헤더에 API 키를 Bearer 토큰으로 포함하세요. API 키 받기 페이지에서 Google 또는 이메일 비밀번호로 가입하면 키를 즉시 생성할 수 있습니다. 키는 생성 후 한 번만 표시되므로 안전하게 저장하세요. 각 계정당 동시에 활성 상태인 키는 하나만 지원되며, 새 키를 생성하면 이전 키가 대체됩니다. 시작하려면 전화번호나 신용카드가 필요하지 않지만, 지속적인 사용에는 선불 크레딧이 필요합니다.
첫 번째 요청
POST 요청을 /v1/chat/completions 엔드포인트로 전송하세요. 이 엔드포인트는 텍스트 입력을 받아 텍스트 출력을 반환합니다. 모델 식별자는 uncensored입니다. 요청 본문에 model, messages, max_tokens 필드를 포함해야 합니다. 이 엔드포인트는 텍스트-비디오 파이프라인의 프롬프트 엔지니어링 레이어의 핵심입니다. 컨텍스트 창 관리 및 응답 형식을 처리합니다.
curl https://api.nsfwvideogenerator.cc/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 SDK를 사용하여 API와 상호 작용하세요. base_url 및 api_key을 우리 인프라를 가리키도록 구성하세요. SDK는 JSON 직렬화 및 HTTP 전송을 자동으로 처리합니다. 이 방법은 백엔드 서비스 및 데이터 처리 파이프라인에 이상적입니다. 클라이언트를 가져와 자격 증명으로 인스턴스화하세요.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwvideogenerator.cc/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)
모델 이름 uncensored으로 chat.completions.create()를 호출하세요. SDK는 생성된 콘텐츠를 구문 분석할 수 있는 응답 객체를 반환합니다. 이 방법은 배치 처리 및 스크립트 생성 작업에 신뢰할 수 있습니다.
Node SDK 연동
JavaScript 환경에서는 OpenAI Node SDK를 사용하세요. basePath을 API URL로 설정하고 API 키를 제공하세요. 이 설정은 서버리스 함수 및 웹 백엔드와 원활하게 작동합니다. SDK는 동기식 및 비동기식 호출을 모두 지원합니다. 클라이언트를 한 번 구성하고 여러 요청에 재사용하세요.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwvideogenerator.cc/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);
uncensored 모델로 채팅 완료 엔드포인트를 호출하세요. 응답 객체에는 생성된 텍스트와 메타데이터가 포함됩니다. 이 통합은 웹 애플리케이션의 실시간 캡션 및 메타데이터 추출에 적합합니다.
스트리밍 응답
요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE)로 데이터를 반환합니다. 각 청크는 생성된 텍스트의 일부를 포함합니다. 이는 실시간 사용자 인터페이스 및 점진적 스크립트 렌더링에 유용합니다. 마지막 청크에는 총 토큰 사용량이 포함됩니다.
stream = 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)
각 청크를 순차적으로 처리하세요. 텍스트를 집계하여 전체 응답을 구성하세요. 스트리밍은 장문 콘텐츠 생성에 대한 지각된 지연 시간을 줄입니다. 실시간 캡션 또는 대화형 프롬프트 개선에 이상적입니다.
제한, 오류 및 컨텍스트
컨텍스트 창은 100,000 토큰이며, 요청당 최대 출력은 32,000 토큰입니다. max_tokens이 설정되지 않으면 제한은 2,048 토큰입니다. 속도 제한은 분당 300 요청 및 키당 8개의 동시 요청입니다. 요청 본문은 8 MB를 초과할 수 없습니다. 오류에는 잘못된 키에 대한 401, 잔액 부족에 대한 402, 속도 제한에 대한 429가 포함됩니다. 경미한 콘텐츠에 대한 거절은 무료입니다. 오류는 크레딧을 소모하지 않습니다. 429 응답에는 지수 백오프를 사용하세요.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 인증 | Authorization: Bearer YOUR_KEY |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.nsfwvideogenerator.cc/v1 |
| 모델 ID | uncensored |
| JSON 모드 | response_format: {"type": "json_object"} |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 컨텍스트 창 | 64,000 토큰 (입력 + 출력) |
| 최대 출력 | 64,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 속도 제한 | 키당 분당 300회 |
| 동시 요청 | 키당 동시 8개 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 요청 크기 | 최대 8 MB |
| 보너스 | $50 이상 +5%, $100 이상 +10% |
| 가격 | 입력 100만 토큰당 $0.25 · 출력 100만 토큰당 $1.00 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $10~$500 사이 원하는 정수 금액 |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
이 API는 비디오나 오디오를 직접 생성합니까?
아니요, 텍스트 전용 API입니다. 파이프라인의 텍스트 레이어를 제공하며 프롬프트 엔지니어링, 스크립트 생성, 메타데이터 추출을 처리합니다. 출력물은 별도 비디오 또는 오디오 생성 모델을 구동하는 데 사용됩니다.
계정에 크레딧을 추가하려면 어떻게 하나요?
USDT(TRC20) 또는 USDC(Base)와 같은 암호화폐로만 충전할 수 있습니다. 결제 금액은 $10~$500이며, 고액 충전 시 보너스 크레딧이 제공됩니다. 신용카드나 PayPal는 지원되지 않습니다.
가격 정책은 어떻게 되나요?
입력 토큰 100만 개당 $0.25, 출력 토큰 100만 개당 $1.00입니다. 크레딧은 선불이며 만료되지 않습니다. 오류 및 거절은 크레딧을 소모하지 않으므로 성공한 응답에만 요금이 부과됩니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.