Seedance 2.5 текст-в-видео: создание коротких роликов с помощью API hiapi

Короткие видео — это игра в количества: TikTok, Reels и Shorts вознаграждают частоту публикаций, а вручную снимать B-roll для каждого поста невозможно масштабировать. Эндпоинт текст-в-видео Seedance 2.5 за один вызов API превращает один промпт в готовый вертикальный клип с синхронизированным звуком — без камеры, без монтажной шкалы, без отдельной озвучки.

В этом руководстве мы полностью разберём один реальный клип, сгенерированный нами через API hiapi от начала до конца: точный промпт, асинхронный рабочий процесс, который его создаёт, проверенные цены и схема, готовая к серийному производству, для создания набора коротких видео, а не разрозненных отдельных фрагментов. Полную справку по параметрам всех трёх эндпоинтов seedance-2.5 см. в полном руководстве по API.

Почему контент для коротких видео хорошо подходит для текст-в-видео

Платформам коротких видео не нужна кинематографическая длина — им нужен стабильный поток клипов по 6–15 секунд, которые бесшовно зацикливаются и захватывают зрителя за секунду. seedance-2.5/text-to-video точно соответствует этой потребности:

• До 30 секунд на клип с поддержкой семи соотношений сторон, включая 9:16 для TikTok/Reels/Shorts.
• Нативная синхронизация звука — модель генерирует фоновые звуки и аудиосигналы в соответствии с действиями в промпте, а не создаёт беззвучный клип, который вам придётся озвучивать позже.
• Промпты поддерживают 11 языков, что полезно, если вы локализуете кампании коротких видео.
• Два разрешения (480p и 720p), поэтому вы можете недорого генерировать черновики и платить по тарифу 720p только за клипы, которые действительно будут опубликованы.

Один реальный клип, от начала до конца

Вот клип, который мы сгенерировали для этого руководства: крупный план наливания латте-арта, вертикальная композиция, для короткого видео кофейни.

Точный промпт, который мы отправили, без правок:

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

Параметры: aspect_ratio: "9:16", resolution: "720p", duration: 8. Приведённый выше результат — настоящий, неотредактированный результат задачи: 8,06 секунды, звук наливания и фоновый гул кофейни сгенерированы самой моделью, а не добавлены на постпродакшене.

Рабочий процесс API

seedance-2.5/text-to-video работает через асинхронный API задач hiapi — отправить, опросить, скачать. Синхронного эндпоинта для видео нет; каждый клип — это фоновая задача.

import time
import requests

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"

def generate_clip(prompt: str, aspect_ratio: str = "9:16",
                   resolution: str = "720p", duration: int = 8) -> str:
    submit = requests.post(
        f"{BASE}/tasks",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedance-2.5/text-to-video",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
                "duration": duration,
            },
        },
        timeout=30,
    )
    task_id = submit.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        ).json()["data"]
        if poll["status"] == "success":
            return poll["output"][0]["url"]   # 临时链接——立即下载
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "Твёрдая рука бариста наливает взбитое молоко из кувшина из нержавеющей стали "
    "в белую керамическую чашку для эспрессо, молочная струя складывается в "
    "закручивающийся узор розетты латте-арта, формирующийся в реальном времени, "
    "тёплый свет золотого часа косо скользит по стойке, круассаны и выпечка "
    "мягко размыты на фоне, крупный вертикальный кадр, лёгкий пар, фоновые звуки кофейни."
)

# Выходной URL истекает (есть метка времени expireAt) — скачайте сразу и
# сохраните в собственное хранилище, не оставляйте его как горячую ссылку
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

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

Цены: два тарифа, без 1080p

Проверено в реальном времени по эндпоинту цен hiapi — seedance-2.5/text-to-video тарифицируется по секундам выходного видео, с двумя разрешениями, без варианта 1080p:

Разрешение	Цена за секунду	Клип на 8 секунд
480p	$0.1395	около $1.12
720p	$0.3019	около $2.42

Цена за секунду в 720p примерно в 2,2 раза выше, чем в 480p — стоит сначала генерировать черновики в 480p, а платить за 720p только после того, как промпт отлажен. Полные параметры и детали ценообразования — на странице модели seedance-2.5/text-to-video; тарифы действительны по состоянию на 2026-08 и могут меняться, поэтому перед бюджетированием крупных объёмов проверяйте эту страницу.

Создание набора коротких видео, а не одного

Один клип — это лишь демонстрация; контент-календарю нужно серийное производство. Рассматривайте каждый клип как идемпотентную задачу с ключом по промпту, чтобы повторный запуск после сбоя не приводил к двойной оплате:

import hashlib

PROMPTS = [
    "Бариста наливает взбитое молоко в чашку для эспрессо, формируется розетта латте-арта, свет золотого часа, крупный вертикальный кадр.",
    "Пар поднимается, пока свежесваренный кофе капает через бумажный фильтр, утренний свет через окно кофейни, вертикальный кадр.",
    "Рука слегка стучит мешком с кофейными зёрнами по деревянным весам, зёрна оседают, мягкая атмосфера кофейни, крупный вертикальный кадр.",
]

def job_key(prompt: str) -> str:
    return hashlib.sha1(prompt.encode()).hexdigest()[:12]

results = {}
for prompt in PROMPTS:
    key = job_key(prompt)
    if key in results:          # 本轮已生成过
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # 立即持久化每个结果——参见上面的下载步骤

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

Сравнение с Seedance 2.0

Если вы использовали Seedance 2.0, уровень текст-в-видео в 2.5 сохраняет ту же форму задачи «отправить-опросить-скачать» — на стороне интеграции ничего не меняется. Практические различия, которые стоит знать перед миграцией конвейера: 2.5 по умолчанию добавляет нативную синхронизацию звука к каждому клипу, и его шкала разрешений проще (только 480p/720p, тогда как у 2.0 есть дополнительные уровни). Если ваш рабочий процесс зависит от разрешения, которого нет в 2.5, перед тем как предполагать паритет, проверьте актуальные спецификации на странице этой модели.

Частые вопросы

Поддерживает ли seedance-2.5/text-to-video 1080p? Нет — по состоянию на 2026-08 модель предлагает только 480p и 720p. Если вам нужен вывод 1080p, прежде чем строить конвейер вокруг этого эндпоинта, найдите модель, которая его поддерживает, в каталоге моделей.

Звук настоящий, или его нужно добавлять отдельно? Он генерируется моделью как часть задачи — звук наливания и фоновый гул кофейни в демонстрационном клипе выше не добавлены на постпродакшене. Если вам нужна собственная брендовая музыка или озвучка, вы всё равно можете наложить свой звук позже.

Сколько времени занимает генерация клипа? Время выполнения задачи зависит от длительности и разрешения; примерно от одной до нескольких минут на клип, и обязательно опрашивайте, а не предполагайте фиксированное время ожидания.

Можно ли повторно использовать один и тот же промпт для разных соотношений сторон на разных платформах? Да — aspect_ratio является отдельным от промпта параметром, поэтому один и тот же промпт можно повторно отправить в 9:16 для TikTok/Reels и в 16:9 для YouTube, не переписывая описание сцены.

Что делать, если выходной URL истечёт до того, как я скачаю? Вам придётся повторно отправить задачу — output[0].url является временной ссылкой, привязанной к метке времени expireAt, а не постоянным хранилищем. Скачивайте и сохраняйте каждый клип сразу после того, как задача сообщит success.

Главное

• seedance-2.5/text-to-video — это эндпоинт «промпт на входе, клип на выходе» для контента коротких видео — выбирайте 480p для черновиков и заполнения соцсетей, 720p, когда клип является финальным активом.
• Бюджетируйте по длительности, а не по клипам: стоимость секунды в 720p примерно в 2,2 раза выше, чем в 480p, поэтому 8-секундный клип в 720p стоит уже около $2.42.
• Выходные URL задач истекают — после успешного опроса сразу скачивайте и сохраняйте в постоянное хранилище.
• Нативная синхронизация звука означает, что для заполнения коротких видео обычно не требуется отдельная озвучка или обработка звуковых эффектов.
• В настоящее время у модели нет уровня 1080p — прежде чем строить конвейер, предполагающий его наличие, проверьте страницу модели.

Готовы попробовать? Перейдите на страницу модели seedance-2.5/text-to-video, чтобы увидеть полную справку по параметрам, или просмотрите полный каталог видеомоделей hiapi, чтобы сравнить её с такими вариантами изображение-в-видео, как Kling 3.0 Turbo, и подготовиться к следующей партии коротких видео.