Seedance 2.0 Mini API: видеоинтерфейс за $0.0272 в секунду

TL;DR

• seedance-2.0-mini — облегчённая версия Seedance 2.0 от ByteDance. Одно имя модели позволяет создавать видео из текста, из изображения (первый кадр или первый и последний кадры) и по референсам, со встроенным синхронным звуком.Откройте страницу модели, чтобы генерировать онлайн — новым пользователям при регистрации дают 200 кредитов.
• Это одна из самых дешёвых видеомоделей на HiAPI: 480p — $0.0272 в секунду, 720p — $0.0586 в секунду. 5 секунд 480p стоят всего $0.136.
• resolution — обязательное поле, без него будет ошибка. Ниже приведены примеры curl и Python, все параметры и расчёт стоимости для каждого из трёх режимов.

Сначала посмотрите результат

Три видео из текста, все 5 секунд 480p, каждое $0.136.

A slow dolly-in toward a steaming bowl of ramen on a worn wooden counter in a dim izakaya. Warm amber lantern light, soft volumetric haze, gentle steam curling upward, shallow depth of field, the broth surface rippling slightly. Cinematic, photoreal.

Сгенерировать с этим промптом →（5 секунд, 480p）

seedance-2.0-mini, текст-в-видео, 480p, 5 секунд, $0.136.

A cozy fireplace crackling in a log cabin at night, orange embers popping and drifting, a cast-iron kettle gently steaming on the hearth, rain streaking the dark window behind. Static locked-off shot. Native audio: crackling fire, soft rain on glass, a low wind.

Сгенерировать с этим промптом →（5 секунд, 480p）

seedance-2.0-mini, текст-в-видео, 480p, 5 секунд, с нативным звуком, $0.136.

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

A border collie sprints across a sunlit beach toward the camera, kicking up wet sand, ears flapping, tongue out, water spray catching the low golden light. Tracking shot moving backward to keep the dog centered, motion blur on the paws, joyful energy, photoreal.

Сгенерировать с этим промптом →（5 секунд, 480p）

seedance-2.0-mini, текст-в-видео, 480p, 5 секунд, $0.136.

curl: первое видео

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "input": {
      "prompt": "雨夜霓虹赛博朋克街道，镜头缓缓推近，湿漉路面倒影斑斓，电影级氛围",
      "resolution": "480p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 секунд 480p, $0.136. После получения data.taskId проверьте через GET /v1/tasks/{taskId}, что status равен success, затем скачайте output[0].url.

Python: отправка, опрос, скачивание

# pip install requests; сначала export HIAPI_KEY=ваш_ключ
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "seedance-2.0-mini", "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 图生视频：让一张图动起来，720p 5 秒（$0.293）
url = generate(
    prompt="镜头缓缓拉远，云雾在山峰间流动，金色晨光",
    first_frame_url="https://your-cdn.example.com/first-frame.jpg",
    resolution="720p", duration=5, generate_audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Одна модель, три режима

Какой параметр передадите — в такой режим и попадёте:

Режим	Что передавать	Описание
Текст-в-видео	Только prompt
Изображение-в-видео	first_frame_url, опционально last_frame_url	Нельзя смешивать с референсными изображениями и видео
Генерация по референсам	reference_image_urls, reference_video_urls, reference_audio_urls	Референсных видео и аудио — не больше 3 каждого, суммарная длительность каждого типа не более 15 секунд

Обзор параметров

Параметр	Значения	Описание
prompt	строка, обязательно	Можно на китайском или английском
resolution	480p / 720p, обязательно	Без него вернётся 400
duration	целое от 4 до 15, обязательно (в примере 5)	в секундах
aspect_ratio	1:1 4:3 3:4 16:9 9:16 21:9 adaptive, по умолчанию 16:9
generate_audio	по умолчанию true	Нативный синхронный звук
first_frame_url / last_frame_url	адрес изображения	jpeg/png/webp/bmp/tiff/gif, сторона 300–6000 px, одно изображение меньше 30 MB
reference_image_urls	адрес изображения	Вместе с первым и последним кадрами — не больше 9 изображений
reference_video_urls	не больше 3 штук	mp4/mov, 480p или 720p, каждое 2–15 секунд, суммарно не более 15 секунд
reference_audio_urls	не больше 3 штук	wav/mp3, каждое 2–15 секунд, суммарно не более 15 секунд

Посчитаем стоимость

Длительность	480p ($0.0272/сек)	720p ($0.0586/сек)
4 секунды	$0.1088	$0.2344
5 секунд	$0.136	$0.293
10 секунд	$0.272	$0.586
15 секунд	$0.408	$0.879

При передаче reference_video_urls тариф другой: 480p — $0.0172 в секунду, 720p — $0.0358 в секунду. На $10 в 480p можно сгенерировать около 367 секунд. Рекомендуем сначала отлаживать промпты в 480p, а после финализации выводить в 720p; если нужно 1080p — переходите на Seedance 2.0 или Seedance 2.5.

Перед запуском в продакшен

• Используйте callback вместо опроса: на верхнем уровне запроса (на одном уровне с input) добавьте "callback": {"url": "https://ваш-домен/hiapi/callback"} и дедуплицируйте по taskId.
• Своевременно сохраняйте: output[0].url — временная ссылка.
• Повторные попытки с ключом идемпотентности: добавьте в заголовки Idempotency-Key — повтор с тем же ключом создаст задачу только один раз.
• Автоматический возврат при ошибке: оплата взимается только за успешно сгенерированные видео.

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

Как выбрать между Seedance 2.0 Mini и Seedance 2.0?

В 480p цена Mini примерно в пять раз ниже, чем у 2.0 ($0.0272 против $0.136 в секунду), но максимум — только 720p. Для черновиков, массовой генерации коротких видео для соцсетей и тестирования промптов используйте Mini; если нужно 1080p или 4K — переходите на Seedance 2.0.

Почему без resolution возникает ошибка?

Для этой модели resolution — обязательное поле, нужно явно указать "480p" или "720p".

Есть ли звук?

По умолчанию есть. Укажите в промпте, какой звук нужен; если звук не нужен, установите generate_audio в false.

Какая максимальная длительность одного видео?

От 4 до 15 секунд.

Больше вариантов написания промптов — в руководстве по промптам Seedance 2.0; также можно сразу сгенерировать рамен на странице модели.