Как пользоваться Seedance 2.0 API? Первое видео за 5 минут

TL;DR

• Seedance 2.0 — это модель генерации видео от ByteDance; на HiAPI она доступна в трёх версиях: Mini, Fast и стандартная, откройте страницу модели и генерируйте онлайн, новым пользователям при регистрации начисляется 200 кредитов.
• Оплата по секундам: Mini 720p — $0.0586 за секунду, стандартная версия 720p — $0.293 за секунду, 1080p через линию ext — $0.342 за секунду; звук без наценки.
• В API всего два шага: отправить POST /v1/tasks, получить taskId и проверить результат. Примеры на curl и Python ниже можно скопировать и сразу запустить.

Что умеет Seedance 2.0?

• Текст в видео: от 4 до 15 секунд, от 480p до 4K, шесть форматов кадра: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9; при генерации из изображения можно использовать adaptive, чтобы следовать исходному изображению.
• Видео из изображения: передайте первый кадр (first_frame_url), при желании добавьте последний кадр (last_frame_url), чтобы задать финальное изображение.
• Мультимодальные референсы: до 9 референсных изображений, 3 референсных видео и 3 референсных аудио для фиксации персонажа, движения камеры или ритма.
• Нативный звук: generate_audio включён по умолчанию, окружающий звук и звуковые эффекты генерируются синхронно с изображением.

Этот 5-секундный ролик продукта в 720p сгенерирован напрямую по одному промпту:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Сгенерировать по этому промпту →

Два пути для старта

Онлайн-попробовать (без кода)

1. Откройте страницу модели Seedance 2.0, зарегистрируйтесь или войдите.
2. Вставьте промпт, выберите длительность, разрешение и формат кадра.
3. Нажмите «Сгенерировать» и скачайте готовое видео (три 5-секундных образца с латте в 720p на странице цен — от отправки до завершения ушло 168–230 секунд).

Вызов через API

1. Создайте API Key в консоли.
2. Отправьте задачу через POST https://api.hiapi.ai/v1/tasks, в ответе придёт taskId.
3. Проверяйте статус через GET /v1/tasks/{taskId}; когда status равен success, скачайте видео по output[0].url.

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",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Ответ:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Проверка результата:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

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

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

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

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **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)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

При отладке промпта замените model на seedance-2.0-mini, а разрешение укажите 480p — 5 секунд обойдутся всего в $0.136; когда промпт будет готов, переключитесь на стандартную версию или линию ext для генерации в высоком качестве.

Видео из изображения и мультимодальные референсы

Видео из первого кадра: добавьте в input поле first_frame_url, а в качестве формата кадра укажите adaptive, чтобы следовать пропорциям изображения:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Референсные изображения, видео и аудио: используйте соответственно reference_image_urls (референсные изображения вместе с первым и последним кадром — максимум 9 штук), reference_video_urls (не более 3 роликов общей длительностью до 15 секунд), reference_audio_urls (не более 3 фрагментов общей длительностью до 15 секунд).

Комбинации входных данных для Mini: в Mini выбирается что-то одно из первого кадра, референсных изображений и референсного видео, поля duration и resolution обязательны; в стандартной версии обязателен aspect_ratio.

Линия ext: добавьте на верхний уровень "route": "ext", название модели не меняется. В ext доступны только 720p, 1080p и 4K, цена за секунду ниже, но референсные видео не принимаются.

Что учесть перед запуском в продакшен

• Используйте колбэки вместо опроса: добавьте на верхний уровень запроса "callback": {"url": "https://ваш-домен/hiapi/callback"}, и HiAPI сам уведомит о завершении задачи (успешном или неуспешном); дедуплицируйте по taskId.
• Видео по умолчанию хранится около 7 дней: получив output[0].url, сразу перенесите файл в собственное хранилище; для долгосрочного хранения можно использовать постоянное хранилище HiAPI (оплачивается отдельно по объёму).
• Указывайте все параметры: явно задавайте duration, resolution и aspect_ratio, чтобы расходы совпадали с бюджетом.
• Автоматический возврат при ошибке: за неуспешные задачи плата не списывается, оплачиваются только секунды успешно сгенерированного видео.

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

Как выбрать между Mini, Fast и стандартной версией?

Для отладки промптов — Mini, для коротких видео в соцсетях — Mini или Fast 720p, для 1080p / 4K — стандартная версия или линия ext. Подробные цены см. в ценах на Seedance 2.0 API.

Можно ли писать промпты на китайском?

Можно. Поддерживаются и китайский, и английский; надёжнее всего описывать кадр, действие, освещение и звук отдельными фразами.

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

Можно. Укажите aspect_ratio как 9:16, а при генерации из изображения — adaptive, чтобы следовать пропорциям первого кадра.

Сколько ждать одно видео?

Три 5-секундных образца с латте в 720p на странице цен генерировались от отправки до завершения 168–230 секунд. В продакшене получайте результат через колбэк, а не полагайтесь на фиксированное время ожидания.

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