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

ГлавнаяРуководство

Обновлено

Генератор сценариев для видео на базе LLM API

Генератор сценариев для видео — это текстовая модель с хорошо подобранным промптом. В этом руководстве показано, как создать такой генератор на базе API, совместимого с OpenAI, с использованием шаблона на Python и расчётом реальной стоимости за сценарий.

Развёртка кинопленки из терминала, каждый кадр содержит набросок сцены, что символизирует генерацию сценария через API
Стеклянная емкость, заполняющаяся светящимися блоками, пока стрелка образует цикл вокруг нее, изображая контекстное окно агента

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

  1. API генерирует только текст: сценарии, списки кадров и текст озвучки. Он не рендерит видео.
  2. Запросите JSON, чтобы каждая сцена попадала в поле, которое ваш редактор или видеоприложение сможет прочитать.
  3. Скрипт длительностью 60 секунд со списком кадров стоит около одной десятой цента при цене $0,15 и $0,50 за 1 млн токенов.
  4. Сохраняйте краткое описание, тон и предыдущие сцены в промпте; контекстное окно рассчитано на 100 000 токенов.

Карта не нужна. После регистрации получите $0,50 бесплатного пробного баланса в один клик (один раз на человека).

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

Что на самом деле делает генератор сценариев

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

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

В одном запросе стоит запросить три вывода: текст озвучки (то, что говорит диктор), раскадровку (то, что видит зритель) и оценку времени для каждой сцены. Разделение их на отдельные поля упрощает последующие шаги.

Настройка клиента

Эндпоинт совместим с OpenAI, поэтому стандартный SDK работает. Получите ключ на странице API-ключей, затем укажите клиенту базовый URL и используйте ID модели uncensored.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.aivideogenapi.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a 3-line hook for a video about night trains."}],
)
print(resp.choices[0].message.content)
print(resp.usage)

Тот же запрос работает в curl или Node.js, изменив только базовый URL и ключ. Полные сведения о параметрах см. в документации API. Новые аккаунты могут получить $0,50 пробного баланса в один клик на странице ключей, чего хватит, чтобы многократно протестировать всё, описанное в этой статье.

Шаблон промпта, возвращающий готовые сцены

Размытый запрос даёт размытые сценарии. Хороший шаблон фиксирует четыре вещи: аудиторию, длину, тон и формат вывода. Поместите правила в системное сообщение, а идею — в сообщение пользователя.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")

SYSTEM = """You write short video scripts.
Return JSON only, with this shape:
{"title": str, "hook": str,
 "scenes": [{"n": int, "seconds": int, "voiceover": str,
             "shot": str, "on_screen_text": str}]}
Rules:
- Total length matches the requested duration.
- Voiceover is spoken language: short sentences, no stage directions.
- 'shot' describes what the camera shows, in one sentence.
- First scene is a hook that works without sound."""

def make_script(idea, seconds=60, tone="dry, curious", audience="adults"):
    user = f"Idea: {idea}\nDuration: {seconds} seconds\nTone: {tone}\nAudience: {audience}"
    r = client.chat.completions.create(
        model="uncensored",
        temperature=0.8,
        response_format={"type": "json_object"},
        messages=[{"role": "system", "content": SYSTEM},
                  {"role": "user", "content": user}],
    )
    return json.loads(r.choices[0].message.content), r.usage

script, usage = make_script("why night trains are coming back")
for s in script["scenes"]:
    print(s["n"], s["seconds"], s["voiceover"])

JSON-режим (response_format со значением json_object) гарантирует, что ответ можно будет распарсить. Всё равно оборачивайте json.loads в блок try и повторяйте запрос один раз при ошибке, так как любая модель иногда может выдать битую строку. Температура 0,7–0,9 даёт разнообразие формулировок; снизьте её до 0,3, когда нужна почти идентичная структура в пакетной обработке.

Проверяйте длину, прежде чем доверять результату

Модели плохо считают секунды. Надёжное правило: около 150 произнесённых слов в минуту для спокойного диктора, немного больше для быстрых социальных клипов. После каждого запроса подсчитайте слова во всех полях озвучки и сравните их с целевым значением.

def spoken_seconds(script, wpm=150):
    words = sum(len(s["voiceover"].split()) for s in script["scenes"])
    return round(words / wpm * 60)

est = spoken_seconds(script)
if abs(est - 60) > 8:
    print("Off target:", est, "seconds. Ask for a rewrite.")

Если сценарий слишком длинный, отправьте второе сообщение с фактическими цифрами: «Озвучка занимает около 78 секунд; сократите до 60, не теряя зацепку». Конкретная обратная связь работает лучше, чем «сделай короче». Сохраните первый ответ в списке сообщений, чтобы модель видела, что она написала.

Раскадровки и озвучка как отдельные проходы

Для более длинных видео один вызов для всего даёт слабый результат. Используйте два прохода. Сначала запросите план с названиями сцен и краткими целями. Затем генерируйте каждую сцену отдельным вызовом, передавая план и текст озвучки предыдущей сцены, чтобы сохранить тон.

  • Проход 1, план: от 6 до 12 сцен, каждая с целью и примерной продолжительностью.
  • Проход 2, сцены: текст озвучки и кадр для одной сцены за раз, с планом и двумя последними сценами в контексте.
  • Проход 3, доработка: прослушайте полную озвучку и попросите варьировать повторяющиеся фразы.

Контекстное окно составляет 100 000 токенов для промпта и ответа вместе, поэтому даже сценарий документального фильма на 20 минут с полным планом помещается в один разговор. О том, как ведёт себя память в длинных сессиях и каковы практические ограничения, рассказывается на странице контекстного окна. Потоковая передача (stream: true) полезна, если вы показываете сценарий человеку по мере его написания.

Сколько стоит скрипт

Стоимость составляет $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, оплата с предоплаченного баланса. Возьмём типичный 60-секундный сценарий с раскадровкой. Скажем, промпт занимает 1 200 токенов (правила плюс идея), а ответ — 1 800 токенов.

ЧастьТокеныМатематикаСтоимость
Входные1 2001 200 / 1 000 000 × $0,15$0,00018
Выходные1 8001 800 / 1 000 000 × $0,50$0,0009
Итого3 000$0,00108

Это около одной десятой цента за сценарий. Канал, выпускающий 1 000 сценариев, платит примерно $1,08 за использование модели. Повторные запросы и доработки добавляют к этой сумме, но даже три вызова за сценарий держат стоимость около цента за штуку. Сбойные или отклонённые запросы не оплачиваются. Баланс не сгорает, а на странице цен указаны суммы пополнения — от $20 до $500 — и бонусные уровни.

Поле usage в каждом ответе даёт точное количество токенов, поэтому вы можете фиксировать реальную стоимость за сценарий, а не оценивать её на глаз.

Лимиты и привычки, экономящие время

Полный ключ позволяет выполнять 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет выполнять 2 параллельных и 60 запросов в минуту. При пакетной обработке множества скриптов используйте небольшой пул воркеров из 4–6 единиц и снижайте частоту запросов, когда видите HTTP 429. Код ошибки указывает, какой лимит вы исчерпали: rate_limited для запросов в минуту, concurrency для лимита параллельных запросов. При временной перегрузке в ответе будет заголовок Retry-After: 5, поэтому подождите пять секунд и повторите запрос.

  • Сохраняйте каждый сценарий вместе с промптом, чтобы вы могли воспроизвести удачный вариант. Параметр seed передаётся дальше, если вам нужны воспроизводимые запуски.
  • Храните гайдлайн по стилю (запрещённые фразы, повторяющиеся имена персонажей, бренд-голос) в системном промпте и используйте его для всех видео.
  • Логируйте X-Request-Id из каждого ответа; это поможет, когда вы будете обращаться в поддержку по поводу конкретного вызова.
  • Читайте каждый сценарий перед публикацией. Модель пишет связный текст, но не проверяет факты.
import time

def call_with_retry(fn, tries=4):
    for i in range(tries):
        try:
            return fn()
        except Exception as e:
            if "429" in str(e) and i < tries - 1:
                time.sleep(5 * (i + 1))
                continue
            raise

Промпты не используются для обучения. Сексуальный контент с участием несовершеннолетних запрещён независимо от контекста.

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

Может ли этот API создать само видео?

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

Какой максимальной длины может быть сценарий?

Контекстное окно составляет 100 000 токенов для промпта и ответа вместе, а max_tokens является опциональным, поэтому очень длинные сценарии помещаются. Для всего, что длится дольше нескольких минут, проход с планом, за которым следуют вызовы для каждой сцены, даёт лучшее качество.

Нужно ли платить, чтобы попробовать?

Нет. Новые пользователи могут получить $0,50 пробного баланса одним нажатием на странице API-ключа после входа. Последующие пополнения осуществляются криптовалютой (USDT в сети TRC20 или USDC в сети Base).

Откажется ли модель от тёмных или зрелых сюжетных тем?

Модель настроена на ответы без отказов по контенту для законного использования совершеннолетними. Контент с участием несовершеннолетних в сексуальном контексте никогда не разрешён.

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

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

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