Uncensored Video/Uncensored Video API 빠른 시작 가이드
Uncensored Video API 빠른 시작 가이드
OpenAI 호환 엔드포인트를 사용하여 비디오 파이프라인에 무검열 비디오 API 텍스트 레이어를 통합하세요. 이 가이드에는 인증, 요청 형식, 스트리밍, 구조화된 출력, 토큰 제한이 포함되어 있습니다.
인증 및 기본 URL
기본 URL을 https://api.uncensoredvideo.cc/v1로 설정하여 무검열 비디오 API에 액세스하세요. Authorization 헤더에 Bearer 토큰 형태로 API 키를 전달하세요. 대시보드를 통해 계정당 하나의 키를 생성합니다. 새 키를 생성하면 이전 키가 즉시 대체됩니다. 이 키는 선불 크레딧에 직접 접근할 수 있으므로 안전하게 보관하세요.
기본 채팅 완료
/v1/chat/completions 엔드포인트로 표준 텍스트 프롬프트를 전송하세요. 모델은 합법적인 성인 주제나 날카로운 주제에 대해 콘텐츠 필터 없이 텍스트로 응답합니다. 창의성과 출력 길이를 제어하기 위해 temperature, top_p 및 stop 시퀀스를 조정할 수 있습니다. 이 엔드포인트는 비디오 대본 생성을 위한 텍스트 레이어의 핵심입니다.
curl https://api.uncensoredvideo.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."}]
}'
스트리밍 응답
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)
구조화된 데이터용 JSON 모드
비디오 메타데이터 또는 자막 파이프라인의 경우 response_format: { "type": "json_object" }를 사용하여 구조화된 출력을 강제하세요. 모델은 엄격하게 유효한 JSON을 반환하므로 스크립트와 장면 설명을 프로그래밍 방식으로 구문 분석하기가 쉬워집니다. 이는 AI 비디오 스택의 후처리 오버헤드를 줄여줍니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredvideo.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)
도구용 함수 호출
요청에 도구를 정의하여 모델이 호출 시기를 결정하도록 하세요. tool_choice를 사용하여 함수 호출을 강제하거나 허용하세요. 이는 LLM이 외부 서비스와 상호작용해야 하는 자동화된 비디오 태그 지정 또는 장면 추출에 유용합니다. 모델은 코드에서 실행할 수 있는 구조화된 도구 호출을 반환합니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredvideo.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);
토큰 제한 및 가격
컨텍스트 창은 100,000 토큰(프롬프트와 완료의 합계)입니다. 최대 출력은 요청당 32,000 토큰이며, max_tokens이 설정되지 않으면 2,048 토큰입니다. 속도 제한은 키당 분당 300 요청이며 최대 동시 요청은 8개입니다. 가격은 입력 토큰 100만 토큰당 $0.25, 출력 토큰 100만 토큰당 $1.00입니다. 오류 및 거부는 무료입니다. 401을 받으면 키를 확인하세요; 402는 크레딧 부족을 의미합니다; 429는 속도 제한에 도달했음을 나타냅니다.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 모델 ID | uncensored |
| 인증 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.uncensoredvideo.cc/v1 |
| JSON 모드 | response_format: {"type": "json_object"} |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 속도 제한 | 키당 분당 300회 |
| 동시 요청 | 키당 동시 8개 |
| 요청 크기 | 최대 8 MB |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 보너스 | $50 이상 +5%, $100 이상 +10% |
| 충전 | USDT (TRC20) 또는 USDC (Base), $10~$500 사이 원하는 정수 금액 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 가격 | 입력 100만 토큰당 $0.25 · 출력 100만 토큰당 $1.00 |
| 무료 체험 | $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입니다. 비디오 파이프라인의 텍스트 레이어(대본, 프롬프트, 메타데이터)를 처리합니다. 실제 비디오나 오디오 생성에는 별도 서비스를 사용해야 합니다.
크레딧을 어떻게 충전하나요?
암호화폐로만 충전하세요(TRC20의 USDT 또는 Base의 USDC). 결제 금액은 $10에서 $500 사이입니다. 신용카드, PayPal, 은행 이체는 받지 않습니다.
내 데이터가 학습에 사용되나요?
아니요. API로 전송된 프롬프트는 모델 학습에 사용되지 않습니다. 계정 생성에는 이메일만 필요하며 전화번호는 수집하지 않습니다.