Tekst API Unfiltered Video: Przepływ pracy LLM dla scenariuszy
Jeśli szukałeś niefiltrowanego API tekstowego wideo, przydatny podział jest taki: twój renderer tworzy piksele, a API tekstowe LLM pisze wszystko wokół nich, od scenariuszy i list ujęć po napisy i opisy. Ten przewodnik buduje tę tekstową część na endpointzie kompatybilnym z OpenAI.

Kluczowe punkty
- API jest tylko tekstowe. Pisze scenariusze, listy ujęć, napisy i opisy; nie renderuje wideo, obrazów ani audio.
- Strumieniowanie daje ci szkic scenariusza w miarę jego pisania, a tryb JSON daje ci listę ujęć, którą twój kod może przeanalizować.
- Okno 100 000 tokenów mieści długi transkrypt wraz z twoimi instrukcjami w jednym zapytaniu.
- Jednorazowe przetworzenie tekstu dla jednego filmu kosztuje ułamek centa przy cenie $0,15 i $0,50 za 1M tokenów.
Gdzie tekst pasuje do potoku wideo
API tej strony nie generuje wideo. Obsługuje tylko tekst: brak obrazu, dźwięku ani wideo, brak embeddingów ani dostrajania. Ma to znaczenie, bo frazę tę można odczytać na dwa sposoby. Niektórzy chcą modelu, który renderuje klipy — do tego potrzebujesz osobnego modelu wideo. Inni mają już renderer, bibliotekę materiałów lub edytor i potrzebują LLM, który pisze tekst towarzyszący, nie odmawiając tematów zgodnych z prawem, choć niewygodnych: scenariusze horrorów, rekonstrukcje zbrodni, czarna komedia, narracja w dokumentach wojennych, powieści dla dorosłych.
Druga grupa to adresat tego artykułu. W praktyce praca tekstowa wokół wideo dzieli się na cztery zadania:
- Pisanie scenariusza. Zamień szkic lub stos notatek w narrację o spójnym tonie.
- Listy ujęć. Podziel scenariusz na sceny z czasem trwania, opisem wizualnym i jedną linią narracji dla każdej, w formacie JSON, który kod edytora może odczytać.
- Napisy i czyszczenie napisów. Popraw interpunkcję i etykiety mówców w surowym transkrypcie lub napisz tekst na ekranie.
- Tytuły, opisy i tagi. Krótkie wyjścia, wiele z nich, gdzie model wyceniania za token jest dla ciebie łaskawy.
Model stojący za tym endpointem to model o otwartych wagach obsługiwany przez niezależnego dostawcę, dostrojony do odpowiadania bez odmów dotyczących treści dla użytku dorosłego, który jest zgodny z prawem. Nie jest to router między dostawcami ani oficjalne API modelu innego podmiotu. Obowiązuje jeden ścisły limit: brak treści seksualnych z udziałem nieletnich. Jeśli nadal zastanawiasz się, jak połączyć ze sobą komponenty audio i wideo w swoim stacku, strona dotycząca potoków wideo omawia podział obowiązków.
Połącz klienta
Endpoint mówi w formacie uzupełnień czatu OpenAI, więc dowolne SDK OpenAI działa po zmianie dwóch wartości: adresu URL bazowego i klucza. ID modelu to uncensored, a uwierzytelnianie to standardowy token bearer. Istnieją dwie metody: POST /v1/chat/completions i 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"
Jeśli wolisz powłokę, to samo sprawdzenie to jedno zapytanie:
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."}]}'
Klucz API uzyskasz na stronie klucza API. Nowe konta mogą jednym kliknięciem uzyskać $0,50 kredytu próbnego ważnego przez 7 dni bez potrzeby podawania karty — to wystarczy na wszystko, co poniżej.
Krok 1: strumieniuj szkic scenariusza
Scenariusz to najdłuższe wyjście w potoku, więc to właśnie warto strumieniować. Przy stream: true serwer wysyła tokeny przez SSE w miarę ich generowania, a metryki zużycia trafiają na koniec strumienia. Twoje narzędzie edytorskie może pokazywać powstający szkic zamiast zawieszać się na czas całego generowania.
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)
Dwa szczegóły łatwo przeoczyć. Po pierwsze, ostatni fragment może zawierać zużycie, ale nie wybory, dlatego pętla sprawdza chunk.choices przed indeksowaniem. Po drugie, zapytanie strumieniowe rezerwuje slot równoległości do końca strumienia. Jeśli Twoje narzędzie pozwala użytkownikom na uruchomienie kilku szkiców naraz, każdy otwarty strumień liczy się do Twojego limitu.
Ton jest rzeczą, która dryfuje w serii. Włóż zasady kanału w wiadomość systemową i utrzymaj je stałe: osoba i czas narratora, długość zdania, słowa do uniknięcia, jak powinna kończyć się zimna otwarta scena. Dodaj krótką listę rzeczy, których scenariusz nigdy nie powinien robić, np. wyjaśniania zwrotu akcji wcześnie. Stabilna wiadomość systemowa sprawia też, że liczniki tokenów są przewidywalne od jednego filmu do drugiego, co pomaga przy budżetowaniu później.
Dla powtarzalnych szkiców podczas szlifowania promptu przekaż seed z ustaloną wartością i niższym temperature. Dla pierwszego twórczego przebiegu temperatura około 0,8–1,0 daje luźniejszą, żywszą narrację; możesz ją zmniejszyć, gdy zaczniesz poprawiać tekst.
Krok 2: zamień scenariusz na listę ujęć
Kod edytora potrzebuje struktury, nie akapitów. Tryb JSON prosi model o zwrócenie jednego obiektu JSON; włączasz go za pomocą response_format. Podaj też słowo JSON w swoim promptie i opisz żądaną strukturę; te dwa elementy razem utrzymują wyjście w wymaganym kształcie.
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])
Tryb JSON sprawia, że złe wyjścia są rzadkie, nie niemożliwe. Owiń json.loads w bloku try, ponów próbę raz z niższą temperaturą i zwaliduj pola, na których polegasz. Lista ujęć z brakującą wartością seconds spowoduje awarię timeline znacznie głośniej niż nieco niezręczne zdanie.
Przekaż ciągi visual do dowolnego generatora lub selekcjonera materiału. Ponieważ model nie jest proszony o ostrożność w kwestii tematyki, opisy ponurych lub napiętych scen powracają jako krótkie opisy, a nie uprzejme odmowy. Zachowaj własny etap weryfikacji w pętli dla wszystkiego, co publikujesz.
Krok 3: napisy i opisy z długiego transkryptu
Okno kontekstu ma 100 000 tokenów, prompt i uzupełnienie razem. Dla pracy tekstowej na wideo jest to hojne: długi transkrypt wywiadu, przewodnik stylu twojego kanału i trzy przykładowe opisy mieszczą się w jednym zapytaniu, więc nie musisz kroić i sklejać tak, jak przy małym oknie. Sprawdź rzeczywisty rozmiar z pola usage zamiast zgadywać i zostaw miejsce na wyjście.
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);
Dla czyszczenia subtytułów dziel przez czas, nie przez rozmiar. Wyślij kilka minut surowego transkryptu naraz z instrukcją zachowania znaczników czasu bez zmian, a następnie scal. Jeśli potrzebujesz też napisów na ekranie pasujących do stylu domu, włóż zasady stylu w wiadomość systemową i utrzymaj je identyczne we wszystkich wywołaniach; sprawia to, że wyjścia są spójne i sprawia, że licznik tokenów jest przewidywalny.
Dostępne jest też wywoływanie funkcji, jeśli chcesz, aby model wywoływał Twoje własne funkcje, np. funkcję lookup_asset sprawdzającą bibliotekę materiałów wideo pod kątem pasującego klipu podczas pisania listy ujęć. Zdefiniuj narzędzia, odczytaj tool_calls z odpowiedzi, uruchom je i wyślij wyniki z powrotem jako komunikaty role: "tool".
Ograniczenia kształtujące potok
Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę. Klucz próbny pozwala na 2 równoległe i 60 na minutę. Limit ciała to 8 MB, co jest znacznie powyżej dowolnego transkryptu, który wyślesz jako tekst. Po przekroczeniu limitu otrzymujesz HTTP 429 z kodem błędu rate_limited (za dużo na minutę) lub concurrency (za dużo naraz). Przy tymczasowym przeciążeniu otrzymujesz również 429, z nagłówkiem Retry-After: 5.
Prosta zasada: przy dowolnym 429, poczekaj na wartość nagłówka, jeśli jest, w przeciwnym razie cofnij się o kilka sekund, a następnie ponów próbę. Nieudane lub odrzucone zapytania nie są naliczane, więc ponowne próby nie kosztują cię. Odpowiedzi zawierają X-Request-Id dla pytań o wsparcie i X-Balance-USD, co jest przydatne do pokazywania pozostałego kredytu wewnątrz twojego własnego narzędzia.
Gdy renderujesz wiele filmów równolegle, przydziel etapowi tekstowemu własną, małą pulę workerów (4–6), aby nagły wzrost liczby szkiców nie zagłodził etapu listy ujęć. Strumienie liczą się do limitu równoległych zapytań przez cały czas ich otwarcia, więc użytkownik, który opuści półprzeczytany szkic, nadal rezerwuje slot do jego ukończenia.
Ile kosztuje tekstowa strona jednego filmu
Cennik to $0,15 za 1 mln tokenów wejściowych i $0,50 za 1 mln tokenów wyjściowych, pobierane z przedpłaconego kredytu bez subskrypcji. Oto realistyczny przebieg tekstu dla 90-sekundowego filmu, z podaną kalkulacją:
| Krok | Tokeny wejściowe | Tokeny wyjściowe | Koszt |
|---|---|---|---|
| Szkic scenariusza | 600 | 1,200 | 600 × $0.15/1M = $0.00009, plus 1 200 × $0.50/1M = $0.0006, razem $0.00069 |
| Lista ujęć | 1,500 | 900 | $0.000225 + $0.00045 = $0.000675 |
| Tytuł, opis, tagi | 1,800 | 300 | $0.00027 + $0.00015 = $0.00042 |
Trzy kroki dają łącznie $0,001785 za film. Tysiąc filmów to $1,785 za tekst. Nawet jeśli Twoje rzeczywiste prompty są trzykrotnie dłuższe niż te przykłady, pisanie jest najtańszą częścią zadania. Sam kredyt próbny $0,50 pokrywa więcej niż 250 filmów przy tych rozmiarach, ponieważ $0,50 podzielone przez $0,001785 daje około 280.
Po zakończeniu okresu próbnego kredyt pochodzi z doładowań w dowolnej kwocie całkowitej od $20 do $500, płatnych w kryptowalutach (USDT w sieci TRC20 lub USDC na Base). Bonusy stosuje się przy większych doładowaniach: +5% od $50, +10% od $100, +15% od $200. Kredyt nie wygasa, a prompty nie są używane do trenowania. Szczegóły znajdziesz na stronie z cenami, a poradnik szybkiego startu zawiera ten sam format zapytania w kilku dodatkowych językach.
Więcej przewodników
Pytania i odpowiedzi
Czy to API generuje wideo?
Nie. Obsługuje tylko tekst, bez generowania obrazu, audio lub wideo. Użyj go do scenariuszy, list ujęć, napisów i opisów, łącząc go z wybranym renderem lub edytorem.
Czy odrzuca mroczne lub dojrzałe tematy?
Model jest dostrojony do odpowiadania bez odmów treści dla użytku dorosłych zgodnego z prawem, więc horror, kryminał i powieści dla dorosłych są łatwe do obsłużenia. Treści seksualne z udziałem nieletnich to sztywna odmowa.
Którego ID modelu i base URL użyć?
Użyj identyfikatora modelu uncensored i bazowego URL https://api.unfilteredvideo.com/v1 z dowolnym SDK kompatybilnym z OpenAI. Uwierzytelnij się tokenem Bearer.
Czy jest dostępny darmowy plan?
Nie ma darmowego planu. Nowi użytkownicy mogą odebrać jednorazowy kredyt próbny w wysokości $0,50 ważny przez 7 dni bez podania karty; po tym okresie doładowujesz konto od kwoty $20.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.