Unfiltered Video API 텍스트: 스크립트를 위한 LLM 워크플로우
필터 없는 비디오 API 텍스트를 검색하셨다면 유용한 구분은 다음과 같습니다. 렌더러가 픽셀을 생성하고, 텍스트 LLM API가 스크립트부터 샷 리스트, 자막 및 설명에 이르기까지 모든 텍스트를 작성합니다. 이 가이드는 OpenAI 호환 엔드포인트에 텍스트 부분을 구축합니다.

주요 포인트
- API는 텍스트 전용입니다. 스크립트, 샷 리스트, 자막 및 설명을 작성하며 비디오, 이미지, 오디오를 렌더링하지 않습니다.
- 스트리밍은 작성되는 대로 스크립트 초안을 제공하며, JSON 모드는 코드에서 구문 분석할 수 있는 샷 리스트를 제공합니다.
- 100,000토큰 컨텍스트 창은 긴 트랜스크립트와 지시문을 하나의 요청에 담습니다.
- 비디오 한 편에 대한 전체 텍스트 처리 비용은 토큰 100만 개당 $0.15(입력) 및 $0.50(출력) 기준이며, 1센트에도 미치지 않는 금액입니다.
텍스트가 비디오 파이프라인에서 하는 역할
이 사이트의 API는 비디오를 생성하지 않습니다. 텍스트 전용이며, 이미지, 오디오, 비디오 출력, 임베딩, 파인튜닝 기능이 없습니다. 이 점이 중요한 이유는 해당 구문이 두 가지 방식으로 해석되기 때문입니다. 일부 사용자는 클립을 렌더링하는 모델을 원하며, 이를 위해서는 별도의 비디오 모델이 필요합니다. 다른 사용자는 이미 렌더러, 스톡 라이브러리 또는 편집기를 보유하고 있으며, 합법적이지만 불편할 수 있는 주제(호러 스크립트, 실제 범죄 재연, 다크 코미디, 전쟁 다큐멘터리 내레이션, 성인을 위한 성숙한 소설)에 대해 거부하지 않고 주변 텍스트를 작성하는 LLM이 필요합니다.
두 번째 그룹이 이 기사의 대상입니다. 실제로 비디오 주변 텍스트 작업은 네 가지 작업으로 나뉩니다:
- 스크립트 초안 작성. 개요나 노트 더미를 일관된 어조로 내레이션으로 변환하세요.
- 샷 리스트. 스크립트를 장면별로 분할합니다. 각 장면에는 지속 시간, 시각적 설명, 내레이션 문장 각 하나가 포함되며, 편집 코드가 읽을 수 있는 JSON 형식으로 만드세요.
- 캡션 및 자막 정리. 원본 대본의 문장 부호와 화자 라벨을 수정하거나 화면 텍스트를 작성하세요.
- 제목, 설명 및 태그. 짧은 출력이 많기 때문에 토큰 기반 가격 책정이 유리합니다.
엔드포인트 뒤의 모델은 독립적인 제공자가 실행하는 오픈 웨이트 모델 중 하나로, 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 조정되었습니다. 이는 벤더 간 라우터가 아니며 다른 사람의 공식 API가 아닙니다. 하나의 고정 제한이 적용됩니다: 미성년자가 관련된 성적 콘텐츠는 허용되지 않습니다. 여전히 스택의 오디오 및 비디오 절반이 어떻게 맞물리는지 결정 중이라면 비디오 파이프라인 페이지이 노동 분담을 다룹니다.
클라이언트 연결
엔드포인트는 OpenAI 채팅 완성 형식을 사용하므로 base URL과 키 두 가지 값을 변경하면 모든 OpenAI SDK가 작동합니다. 모델 ID는 uncensored이며 인증은 표준 Bearer 토큰입니다. 두 가지 메서드가 있습니다: POST /v1/chat/completions 및 GET /v1/models.
from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")
# sanity check: the model list should include "uncensored"
print([m.id for m in client.models.list().data])
MODEL = "uncensored"
셸을 선호하신다면 동일한 확인은 하나의 요청으로 가능합니다:
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 two-line cold open for a ghost-story video."}]}'
API 키 페이지에서 키를 얻을 수 있습니다. 신규 계정은 카드 없이 7일 동안 유효한 $0.50 무료 체험 크레딧을 한 번에 청구할 수 있으며, 이는 아래 모든 작업에 충분합니다.
1단계: 스크립트 초안 스트리밍
스크립트는 파이프라인에서 가장 긴 출력물이므로 스트리밍할 가치가 있습니다. stream: true로 서버는 생성되는 대로 SSE를 통해 토큰을 보내고 사용량 숫자는 스트림 끝에 도착합니다. 편집 도구는 전체 생성 동안 멈추는 대신 초안이 성장하는 것을 보여줄 수 있습니다.
from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")
outline = """Cold open: abandoned lighthouse at night.
Act 1: the keeper's logbook, last entry torn out.
Act 2: the tide table that does not match the moon.
Close: the lamp turns on by itself."""
stream = client.chat.completions.create(
model="uncensored",
stream=True,
temperature=0.9,
messages=[
{"role": "system", "content": "You write narration for short horror videos. Second person, present tense, about 90 seconds spoken."},
{"role": "user", "content": outline},
],
)
script = []
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
piece = chunk.choices[0].delta.content
script.append(piece)
print(piece, end="", flush=True)
if getattr(chunk, "usage", None):
print("\n\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)
script = "".join(script)
두 가지 세부 사항은 놓치기 쉽습니다. 첫째, 마지막 청크는 사용량을 포함하지만 선택 항목을 포함하지 않을 수 있으므로 루프는 인덱싱 전에 chunk.choices를 확인합니다. 둘째, 스트리밍 요청은 스트림이 끝날 때까지 동시성 슬롯을 유지합니다. 도구에서 사용자가 여러 초안을 동시에 시작할 수 있는 경우 제한에 대해 열린 스트림을 세십시오.
목소리는 시리즈 전반에 걸쳐 변화하는 요소입니다. 채널의 규칙을 시스템 메시지에 넣고 고정하십시오: 화자 1/2/3인칭과 시제, 문장 길이, 피해야 할 단어, 콜드 오픈이 어떻게 끝나야 하는지. 스크립트가 절대 하지 말아야 할 것들의 짧은 목록을 추가하십시오. 안정적인 시스템 메시지는 비디오 간 토큰 수를 예측 가능하게 만들어 나중에 예산을 책정할 때 도움이 됩니다.
프롬프트를 조정하며 반복적인 초안을 작성할 때 고정된 seed 값과 낮은 temperature을 전달하세요. 첫 번째 창의적 작업에는 0.8~1.0의 온도가 더 자유롭고 생동감 있는 내레이션을 제공하며, 다듬는 단계에서는 낮출 수 있습니다.
2단계: 스크립트를 샷 리스트로 변환
편집 코드는 단락이 아닌 구조를 원합니다. JSON 모드는 모델이 단일 JSON 객체를 반환하도록 요청하며, response_format로 활성화합니다. 프롬프트에 JSON이라는 단어를 말하고 원하는 모양을 설명하십시오. 이 둘은 출력을 모양에 유지합니다.
import json, os
from openai import OpenAI
client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")
def shot_list(script_text):
resp = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
temperature=0.3,
messages=[
{"role": "system", "content": (
"Return JSON only: {\"shots\": [{\"n\": int, \"seconds\": number, "
"\"visual\": string, \"narration\": string}]}. "
"Keep each shot between 3 and 8 seconds."
)},
{"role": "user", "content": script_text},
],
)
data = json.loads(resp.choices[0].message.content)
return data["shots"]
for s in shot_list(script):
print(s["n"], s["seconds"], s["visual"][:60])
JSON 모드는 나쁜 출력을 드물게 만들지만 불가능하게 만들지는 않습니다. json.loads를 try 블록으로 감싸고, 온도를 낮춰서 한 번 다시 시도하며, 의존하는 필드를 검증하십시오. 누락된 seconds 값이 있는 샷 리스트는 약간 어색한 문장보다 타임라인을 훨씬 더 크게 깨뜨립니다.
visual 문자열들을 영상 생성 또는 선택 도구에 전달하십시오. 모델이 주제에 대해 신중하도록 요청되지 않았기 때문에, 어둡거나 긴장감 있는 장면의 설명은 정중한 거부보다는 작성된 브리프 형태로 돌아옵니다. 게시할 모든 것에 대해 자체 검토 단계를 루프에 유지하십시오.
3단계: 긴 트랜스크립트에서 자막 및 설명 생성
컨텍스트 창은 프롬프트와 완성 텍스트를 합쳐서 100,000 토큰입니다. 비디오의 텍스트 작업에 대해 이는 관대합니다: 긴 인터뷰 녹취록, 채널 스타일 가이드 및 세 가지 예제 설명이 하나의 요청에 들어갈 수 있으므로 작은 창으로 잘라서 연결할 필요가 없습니다. usage 필드에서 실제 크기를 확인하고 출력에 대한 공간을 남겨두십시오.
import OpenAI from "openai";
import fs from "node:fs";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.unfilteredvideo.com/v1",
});
const transcript = fs.readFileSync("interview.txt", "utf8");
const res = await client.chat.completions.create({
model: "uncensored",
temperature: 0.4,
messages: [
{ role: "system", content: "You write video metadata. Reply with a title under 70 characters, a 3 sentence description, and 8 tags separated by commas." },
{ role: "user", content: transcript },
],
});
console.log(res.choices[0].message.content);
console.log(res.usage);
자막 정리에는 크기가 아닌 시간 기준으로 분할하세요. 타임스탬프를 그대로 유지하라는 지시와 함께 원본 트랜스크립트의 몇 분을 한 번에 보내고 병합하세요. 하우스 스타일과 일치하는 화면 자막도 필요한 경우 시스템 메시지에 스타일 규칙을 넣고 호출 간에 동일하게 유지하세요. 이는 출력을 일관되게 만들고 토큰 수를 예측 가능하게 만듭니다.
함수 호출도 지원됩니다. 예를 들어 촬영 목록을 작성하는 동안 영상 라이브러리에서 일치하는 클립을 찾는 lookup_asset 함수를 호출하도록 모델을 설정할 수 있습니다. 도구를 정의하고 응답에서 tool_calls을 읽은 후 실행한 결과를 role: "tool" 메시지로 다시 전송하세요.
파이프라인을 형성하는 제한 사항
전체 키는 8개의 동시 요청과 분당 300개의 요청을 허용합니다. 체험 키는 2개의 동시 요청과 분당 60개의 요청을 허용합니다. 본문 제한은 8 MB로 텍스트로 전송할 모든 대본보다 훨씬 큽니다. 한도를 초과하면 HTTP 429 오류 코드 rate_limited (분당 너무 많음) 또는 concurrency (동시에 너무 많음)이 발생합니다. 일시적 과부하 시에도 429가 발생하며 Retry-After: 5 헤더가 있습니다.
간단한 규칙: 429가 발생하면 헤더 값이 있으면 해당 값을 기다리고, 없으면 몇 초 동안 대기 후 재시도하세요. 실패하거나 거부된 요청은 요금이 부과되지 않으므로 재시도해도 비용이 들지 않습니다. 응답에는 지원 문의를 위한 X-Request-Id 및 자체 도구 내에서 남은 크레딧을 표시하는 데 유용한 X-Balance-USD이 포함됩니다.
많은 비디오를 병렬로 렌더링할 때, 초안의 급증으로 인해 샷 리스트 단계가 자원 고갈되지 않도록 텍스트 단계에 4~6개의 작은 워커 풀을 제공하십시오. 스트림은 열린 동안 내내 동시성 제한에 포함되므로, 반쯤 읽은 초안에서 떠나는 사용자는 완료될 때까지 슬롯을 유지합니다.
비디오 한 편 텍스트 처리 비용
가격은 구독 없이 선불 크레딧에서 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 90초 비디오의 현실적인 텍스트 패스 계산은 다음과 같습니다:
| 단계 | 입력 토큰 | 출력 토큰 | 비용 |
|---|---|---|---|
| 스크립트 초안 | 600 | 1,200 | 600 × $0.15/1M = $0.00009, 1,200 × $0.50/1M = $0.0006, 총 $0.00069 |
| 샷 리스트 | 1,500 | 900 | $0.000225 + $0.00045 = $0.000675 |
| 제목, 설명, 태그 | 1,800 | 300 | $0.00027 + $0.00015 = $0.00042 |
세 단계는 비디오당 $0.001785로 합산됩니다. 천 개의 비디오는 텍스트에 $1.785가 듭니다. 실제 프롬프트가 3배 더 길더라도, 작성이 작업의 저렴한 부분입니다. $0.50의 무료 체험 크레딧만으로도 이러한 크기에서 250개 이상의 비디오를 커버할 수 있습니다. $0.50을 $0.001785로 나누면 약 280이기 때문입니다.
체험 후, 크레딧은 $20에서 $500까지의 전체 금액으로 충전하여 암호화폐(USDT on TRC20 또는 USDC on Base)로 지불합니다. 더 큰 충전에는 보너스가 적용됩니다: $50부터 +5%, $100부터 +10%, $200부터 +15%. 크레딧은 만료되지 않으며 프롬프트는 학습에 사용되지 않습니다. 요금제 페이지에 세부 사항이 나열되어 있으며, 빠른 시작에는 몇 가지 더 많은 언어로 동일한 요청 형식이 있습니다.
더 많은 가이드
질문과 답변
이 API로 비디오를 생성할 수 있나요?
아니요. 텍스트 전용이며 이미지, 오디오, 비디오 생성 기능이 없습니다. 스크립트, 샷 리스트, 자막 및 설명에 사용하고 선택한 렌더러나 편집기와 함께 사용하세요.
어두운 소재나 성숙한 주제를 거부하나요?
이 모델은 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 따라서 호러, 범죄, 성인 대상 성숙한 소설은 가능합니다. 미성년자가 관련된 성 콘텐츠는 단호히 거부합니다.
어떤 모델 ID와 Base URL을 사용해야 하나요?
모델 ID uncensored와 base URL https://api.unfilteredvideo.com/v1을 사용하여 모든 OpenAI 호환 SDK를 사용하세요. Bearer 토큰으로 인증합니다.
무료 티어가 있나요?
무료 티어가 없습니다. 신규 사용자는 카드 없이 7일 동안 유효한 일회성 $0.50 체험 크레딧을 받을 수 있습니다. 이후 $20부터 크레딧을 충전하세요.