RU ▾

API-текст Unfiltered Video: рабочий процесс LLM для сценариев

Если вы искали API текста для видео без фильтров, полезное разделение такое: ваш рендерер генерирует пиксели, а текстовый API LLM пишет всё вокруг них — от сценариев и раскадровок до субтитров и описаний. Это руководство строит текстовую часть на OpenAI-совместимом эндпоинте.

Обновлено

Пленка, превращающаяся в блоки текста в терминале, иллюстрирующая текстовый рабочий процесс LLM для видео

Ключевые моменты

  • API работает только с текстом. Он пишет сценарии, списки кадров, субтитры и описания; он не рендерит видео, изображения или аудио.
  • Потоковая передача позволяет получить черновик сценария по мере его написания, а JSON-режим предоставляет раскадровку, которую ваш код может распарсить.
  • Окно на 100 000 токенов вмещает длинную расшифровку и ваши инструкции в одном запросе.
  • Полная обработка одного видео стоит доли цента: $0,15 и $0,50 за 1 млн токенов.

Где текст вписывается в конвейер создания видео

API этого сайта не генерирует видео. Только текст: нет вывода изображений, аудио или видео, нет эмбеддингов, нет дообучения. Это важно, так как фраза понимается двояко. Некоторые хотят модель, которая рендерит клипы, для этого нужна отдельная видео-модель. Другие уже имеют рендерер, библиотеку стоковых материалов или редактор и нуждаются в LLM, который пишет окружающий текст, не отказываясь от тем, которые законны, но некомфортны: сценарии ужасов, реконструкции реальных преступлений, тёмная комедия, озвучка военных документалок, художественная литература, написанная для взрослых.

Для второй группы эта статья и предназначена. На практике текстовая работа вокруг видео делится на четыре задачи:

  • Написание сценария. Превратите план или набор заметок в озвучку с единым стилем.
  • Раскадровки. Разбейте сценарий на сцены с длительностью, визуальным описанием и строкой озвучки каждая, в формате JSON, который может прочитать ваш код редактирования.
  • Титры и очистка субтитров. Исправьте пунктуацию и метки говорящих в сыром транскрипте или напишите текст на экране.
  • Заголовки, описания и теги. Короткие выходные данные, их много, и именно здесь ценообразование за токен выгодно вам.

Модель, стоящая за эндпоинтом, — это модель с открытыми весами от независимого провайдера, настроенная на ответы без отказов по контенту для законного использования взрослыми. Это не роутер между поставщиками и не официальное API чьей-либо другой модели. Одно строгое ограничение: отсутствие сексуального контента с участием несовершеннолетних. Если вы всё ещё решаете, как аудио- и видеозвенья вашего стека сочетаются друг с другом, страница о видеопайплайнах описывает разделение труда.

Подключение клиента

Эндпоинт использует формат chat completions OpenAI, поэтому любой SDK OpenAI работает после изменения двух значений: базового URL и ключа. 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-ключей. Новые аккаунты могут получить $0,50 пробного баланса в один клик, действительного в течение 7 дней без привязки карты, чего достаточно для всего ниже перечисленного.

Шаг 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)

Два момента легко упустить. Во-первых, последний фрагмент может содержать данные об использовании и не содержать массив choices, поэтому цикл проверяет chunk.choices перед индексацией. Во-вторых, потоковый запрос удерживает слот параллельности до конца потока. Если ваш инструмент позволяет пользователям запускать несколько черновиков одновременно, учитывайте каждый открытый поток в вашем лимите.

Стиль — это то, что меняется в серии. Поместите правила канала в системное сообщение и держите их неизменными: лицо и время рассказчика, длина предложений, слова для избегания, как должен заканчиваться холодное вступление (cold open). Добавьте короткий список того, чего сценарий никогда не должен делать, например, раскрывать сюжетный ход заранее. Стабильное системное сообщение также делает ваши подсчёты токенов предсказуемыми от одного видео к другому, что помогает при планировании бюджета позже.

Для повторяемых черновиков при настройке промпта передавайте 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, чтобы всплеск черновиков не оставил шаг создания раскадровки без ресурсов. Потоки учитываются в лимите параллельных запросов всё время, пока они открыты, поэтому пользователь, оставивший на полпути черновик, всё ещё занимает слот, пока он не завершится.

Сколько стоит текстовая часть одного видео

Ценообразование: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов из предоплаченного баланса без подписки. Вот реалистичный текстовый проход для 90-секундного видео с математикой:

ШагВходные токеныВыходные токеныСтоимость
Черновик сценария6001 200600 × $0,15/1 млн = $0,00009, плюс 1 200 × $0,50/1 млн = $0,0006, всего $0,00069
Раскадровка1 500900$0,000225 + $0,00045 = $0,000675
Заголовок, описание, теги1,800300$0,00027 + $0,00015 = $0,00042

Три шага в сумме дают $0,001785 за видео. Тысяча видео — это $1,785 текста. Даже если ваши реальные промпты в три раза длиннее этих, написание — самая дешевая часть работы. Одного пробного баланса в $0,50 хватит более чем на 250 видео при таких объемах, так как $0,50, деленные на $0,001785, дают около 280.

После пробного периода кредит пополняется на любую целую сумму от $20 до $500, оплачиваемую криптовалютой (USDT в сети TRC20 или USDC в сети Base). Бонусы применяются при крупных пополнениях: +5% от $50, +10% от $100, +15% от $200. Кредит не сгорает, а промпты не используются для обучения. На странице цен указаны детали, а quickstart имеет тот же формат запроса на нескольких дополнительных языках.

Вопросы и ответы

Может ли этот API генерировать видео?

Нет. Это только текст, без генерации изображений, аудио или видео. Используйте его для сценариев, раскадровок, титров и описаний и подключите к рендеру или редактору по вашему выбору.

Отказывается ли он от темного или зрелого содержания?

Модель настроена на ответы без отказов по контенту для законного использования взрослыми, поэтому ужасы, криминал и взрослая художественная литература вполне подходят. Сексуальный контент с участием несовершеннолетних — строгий запрет.

Какой ID модели и базовый URL использовать?

Используйте ID модели uncensored и базовый URL https://api.unfilteredvideo.com/v1 с любым OpenAI-совместимым SDK. Аутентификация с помощью токена Bearer.

Есть ли бесплатный тариф?

Бесплатного тарифа нет. Новые пользователи могут получить единовременный пробный баланс в размере $0,50, действительный в течение 7 дней, без привязки карты; после этого вы пополняете баланс от $20.

Ваш ключ — в одной форме от вас

Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.

Получить API-ключ