빠른 시작: 코드에 무검열 LLM 통합하기
이 OpenAI 호환 빠른 시작 가이드를 사용하여 비디오 파이프라인에 무검열 LLM을 통합하세요. Base URL을 구성하고, 첫 번째 요청을 보내며, 표준 SDK를 사용하여 스트리밍 또는 구조화된 출력을 처리하세요.
사전 준비: SDK 설치
요청을 보내기 전에 개발 환경에 적절한 클라이언트 라이브러리가 설치되어 있는지 확인하세요. Python 및 Node.js용 표준 OpenAI 호환 SDK를 지원합니다. Python의 경우 openai 패키지를 설치하세요. Node.js의 경우 npm install openai를 사용하세요. 이러한 라이브러리는 인증 헤더, JSON 직렬화 및 스트리밍 이벤트를 자동으로 처리하므로 비디오 콘텐츠의 프롬프트 엔지니어링 및 대본 생성에 집중할 수 있습니다.
구성: Base URL 및 키
당사의 API는 표준 /v1/chat/completions 엔드포인트를 사용하지만 다른 제공업체와 구분하기 위해 특정 Base URL이 필요합니다. base_url을 https://api.unfilteredvideo.com/v1로 설정하고 대시보드에서 생성한 API 키를 제공하세요. 회원가입에 전화번호가 필요 없으며, 계정 생성 시 키가 즉시 발급됩니다. 이 구성은 비디오 파이프라인 도구가 무검열 모델 엔드포인트를 올바르게 인식하도록 보장합니다.
요청 보내기: 채팅 완료
대본이나 자막을 생성하기 위해 표준 채팅 완료 요청을 보내세요. 합법적인 성인 또는 논쟁적인 주제에 대한 거부 응답을 줄이기 위해 조정된 오픈 웨이트 모델에 액세스하려면 모델 ID uncensored를 사용하세요. 다음 예제는 기본 curl 요청을 보여줍니다:
curl https://api.unfilteredvideo.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 통합
Python 프로젝트의 경우 키와 올바른 Base URL을 사용하여 클라이언트를 초기화하세요. 다음 코드 스니펫은 비디오 장면의 대본을 요청하는 방법을 보여줍니다:
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredvideo.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)이 접근 방식은 HTTP 세부 정보를 추상화하여 응답 객체를 직접 구문 분석할 수 있게 합니다. 창의력을 제어하려면 temperature 및 top_p을 조정할 수 있습니다. 이 모델은 합법적인 성인 콘텐츠를 필터링하지 않으므로 예상치 못한 거부 없이 다양한 비디오 장르에 적합합니다.
Node SDK 및 스트리밍
Node.js 개발자는 공식 SDK를 사용하여 스트리밍 응답을 효율적으로 처리할 수 있습니다. 이는 진행 상황을 표시하거나 토큰을 실시간으로 텍스트 음성 변환 엔진에 파이프하려는 긴 대본에 유용합니다. 다음 예제는 스트리밍을 보여줍니다:
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)스트리밍은 토큰을 순차적으로 반환합니다. 마지막 청크에는 청구를 위한 토큰 수를 포함한 사용량 통계가 포함됩니다. 이 방법은 무거운 텍스트 생성 작업 중에도 애플리케이션이 응답 가능하도록 유지합니다.
제한, 오류 및 컨텍스트 창
API의 컨텍스트 창은 100,000 토큰입니다(입력+출력). 별도의 출력 제한이 없으며, max_tokens이 설정되지 않은 경우 응답이 창 끝까지 이어질 수 있습니다. 속도 제한은 분당 300 요청이며 키당 동시 요청은 8개입니다. 일반적인 오류로는 401(잘못된 키), 402(크레딧 부족), 429(속도 제한 초과)가 있습니다. 오류는 크레딧을 소모하지 않습니다. 구조화된 데이터 추출을 위해 response_format: {"type": "json_object"}를 통해 JSON 모드를 사용할 수 있습니다. 함수 호출을 사용하여 외부 도구를 파이프라인에 통합하세요.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unfilteredvideo.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);API 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| 인증 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.unfilteredvideo.com/v1 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| JSON 모드 | response_format: {"type": "json_object"} |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 동시 요청 | 키당 동시 8개 |
| 속도 제한 | 키당 분당 300회 |
| 요청 크기 | 최대 8 MB |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 로그인 | 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입니다. 프롬프트 생성, 대본 작성, 자막 생성 등 텍스트 중심의 비디오 워크플로우 단계에 최적화되었습니다. 오디오, 이미지 또는 비디오 파일을 생성하지 않습니다.
가격 모델은 무엇인가요?
입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50을 청구합니다. 암호화폐(TRC20의 USDT 또는 Base의 USDC)를 통해 선불 크레딧을 충전하고, 오류는 무료입니다. 크레딧은 만료되지 않습니다.
모델은 무검열입니까?
네, 이 모델은 합법적인 성인, 픽션 또는 논쟁적인 주제를 거부하지 않습니다. 그러나 미성년자가 관련된 성 콘텐츠는 항상 차단됩니다. 이 모델은 GPT, Claude 또는 기타 벤더의 모델이 아닙니다.