Генерация видео: Seedance 2.0

Seedance 2.0 (ByteDance) — мультимодальная модель генерации видео. Поддерживает четыре типа входных данных: текст-в-видео, изображение-в-видео, первый-последний кадр и референс-видео, а сгенерированное видео по умолчанию содержит синхронный звук. RuAPI предоставляет OpenAI-совместимый асинхронный API: отправить задачу → опрашивать статус → скачать видео. Оплата в USDT, без зарубежной карты.

Звук включён по умолчанию — видео Seedance 2.0 содержит синхронную аудиодорожку (реплики / фоновый звук / эффекты), никаких дополнительных параметров не нужно.

Готовое видео хранится только 7 дней. Скачайте и сохраните его сразу после генерации — по истечении срока ссылка перестанет работать.

Доступные модели

ID модели	Описание
`doubao-seedance-2.0-fast`	Быстрее и дешевле, вариант по умолчанию
`doubao-seedance-2.0`	Полная версия с более высоким качеством

Актуальные цены — на странице цен (видео тарифицируется по токенам).

Адрес API и авторизация

Base URL: https://www.ruapi.ai/v1
Авторизация: заголовок Authorization: Bearer sk-ВАШ_КЛЮЧ (создаётся в панели, раздел «Токены»)

Генерация асинхронная, всего три шага:

Отправить задачу

POST /v1/videos → возвращает id задачи

Опрашивать статус

GET /v1/videos/{id} → пока status не станет completed

Скачать видео

GET /v1/videos/{id}/content → получить MP4

Шаг 1. Отправить задачу (текст-в-видео)

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
    "seconds": "5",
    "metadata": { "resolution": "720p", "ratio": "16:9" }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
        "seconds": "5",
        "metadata": {"resolution": "720p", "ratio": "16:9"},
    },
)
task_id = resp.json()["id"]
print("Задача отправлена:", task_id)

const resp = await fetch("https://www.ruapi.ai/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk-ВАШ_КЛЮЧ",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "doubao-seedance-2.0-fast",
    prompt: "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
    seconds: "5",
    metadata: { resolution: "720p", ratio: "16:9" },
  }),
});
const { id } = await resp.json();
console.log("Задача отправлена:", id);

Ответ (id — это номер задачи, он нужен для следующих двух шагов):

{
  "id": "task_guXmm9BZpLpYaxfky7mkR2kSlRtgDSe9",
  "object": "video",
  "model": "doubao-seedance-2.0-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1783579686
}

Шаг 2. Опрашивать статус

Запрашивайте по маршруту GET /v1/videos/{id} примерно раз в 5 секунд. status проходит путь queued → in_progress → completed.

curl https://www.ruapi.ai/v1/videos/task_ВАШ_ID_ЗАДАЧИ \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ"

import requests

r = requests.get(
    f"https://www.ruapi.ai/v1/videos/{task_id}",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
).json()
print(r["status"], r.get("progress"))

После завершения (metadata.url — ссылка для скачивания):

{
  "id": "task_guXmm9BZpLpYaxfky7mkR2kSlRtgDSe9",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "metadata": {
    "url": "https://www.ruapi.ai/v1/videos/task_guXmm9BZpLpYaxfky7mkR2kSlRtgDSe9/content"
  }
}

Шаг 3. Скачать видео

curl -L https://www.ruapi.ai/v1/videos/task_ВАШ_ID_ЗАДАЧИ/content \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -o seedance.mp4

video = requests.get(
    f"https://www.ruapi.ai/v1/videos/{task_id}/content",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
)
with open("seedance.mp4", "wb") as f:
    f.write(video.content)
print("Сохранено: seedance.mp4")

Полный пример: весь процесс одним скриптом

Скопируйте и запустите, подставив свой sk-ВАШ_КЛЮЧ:

Python

import time
import requests

BASE = "https://www.ruapi.ai/v1"
HEADERS = {"Authorization": "Bearer sk-ВАШ_КЛЮЧ"}

# 1) Отправить задачу
resp = requests.post(
    f"{BASE}/videos",
    headers=HEADERS,
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
        "seconds": "5",
        "metadata": {"resolution": "720p", "ratio": "16:9"},
    },
)
resp.raise_for_status()
task_id = resp.json()["id"]
print("Задача отправлена:", task_id)

# 2) Опрашивать до завершения (обычно 1–3 минуты)
while True:
    r = requests.get(f"{BASE}/videos/{task_id}", headers=HEADERS).json()
    print("Статус:", r.get("status"), r.get("progress"))
    if r.get("status") == "completed":
        break
    if r.get("status") == "failed":
        raise RuntimeError(f"Ошибка генерации: {r.get('error')}")
    time.sleep(5)

# 3) Скачать (результат хранится 7 дней — сохраните сразу)
video = requests.get(f"{BASE}/videos/{task_id}/content", headers=HEADERS)
with open("seedance.mp4", "wb") as f:
    f.write(video.content)
print("Сохранено: seedance.mp4")

Параметры

Поля верхнего уровня:

Поле	Тип	Описание
`model`	string	`doubao-seedance-2.0-fast` или `doubao-seedance-2.0`
`prompt`	string	Обязательно. Текстовое описание сцены
`seconds`	string	Длительность (сек), 4–15, например `"5"`, `"10"`
`metadata`	object	Разрешение, соотношение сторон, входные изображения/видео — см. таблицу ниже

Поля внутри metadata:

Поле	Тип	Описание
`resolution`	string	`"480p"` / `"720p"` / `"1080p"`
`ratio`	string	Соотношение сторон, например `"16:9"`, `"9:16"`, `"1:1"`
`input_type`	string	Тип входа (обычно можно не указывать — определяется автоматически): `text_to_video` / `first_last_frame` / `reference`
`images`	string[]	Массив URL изображений (для изображение-в-видео)
`videos`	string[]	Массив URL видео (для референс-видео)

Чем выше разрешение и длиннее ролик, тем больше токенов и дороже. Если сомневаетесь — начните с 480p / 5 секунд, а потом настраивайте.

Четыре типа входных данных

input_type обычно указывать не нужно — он определяется по количеству изображений/видео; при желании задаётся явно через metadata.input_type.

Режим	Как передать вход	Определяемый `input_type`
Текст-в-видео	только `prompt`	`text_to_video`
Изображение-в-видео	`metadata.images` — 1 изображение	`reference`
Первый-последний кадр	`metadata.images` — 2 изображения	`first_last_frame`
Референс-видео	`metadata.videos` — 1 видео	`reference`

Изображения / видео должны быть по публично доступному URL (сервер должен их скачать); изображения — JPG / PNG / WebP, видео — MP4. base64 не поддерживается (слишком большое тело запроса приведёт к ошибке).

Ниже для каждого режима показан только шаг 1 «Отправить»; шаги 2 (опрос) и 3 (скачивание) одинаковы для всех режимов.

Режим 1. Текст-в-видео

Только текстовый prompt — генерация целиком по описанию.

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
    "seconds": "5",
    "metadata": { "resolution": "720p", "ratio": "16:9" }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Ночной город, неон отражается на мокром асфальте, киберпанк, камера медленно наезжает",
        "seconds": "5",
        "metadata": {"resolution": "720p", "ratio": "16:9"},
    },
)
print(resp.json()["id"])  # получите task id, затем опрашивайте и скачивайте как в полном скрипте выше

Режим 2. Изображение-в-видео (1 изображение)

В metadata.images — URL одного изображения; оно берётся за основу для оживления. В prompt опишите нужное движение / работу камеры.

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Человек на фото улыбается и естественно машет рукой, камера медленно наезжает",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "images": ["https://ваш-домен/portrait.jpg"]
    }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Человек на фото улыбается и естественно машет рукой, камера медленно наезжает",
        "seconds": "5",
        "metadata": {
            "resolution": "720p",
            "ratio": "16:9",
            "images": ["https://ваш-домен/portrait.jpg"],
        },
    },
)
print(resp.json()["id"])

Режим 3. Первый-последний кадр (2 изображения)

В metadata.images — 2 изображения: первое = стартовый кадр, второе = финальный кадр. Генерируется плавный переход от первого ко второму.

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Плавный переход от первого кадра ко второму, естественное движение камеры, кинематографично",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "images": [
        "https://ваш-домен/first.jpg",
        "https://ваш-домен/last.jpg"
      ]
    }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Плавный переход от первого кадра ко второму, естественное движение камеры, кинематографично",
        "seconds": "5",
        "metadata": {
            "resolution": "720p",
            "ratio": "16:9",
            "images": [
                "https://ваш-домен/first.jpg",
                "https://ваш-домен/last.jpg",
            ],
        },
    },
)
print(resp.json()["id"])

Режим 4. Референс-видео (1 видео)

В metadata.videos — URL одного короткого видео; модель переосмысливает его, сохраняя движения объекта (например, меняет стиль или сцену).

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Сохранить движения человека из видео, сменить стиль на неоновый киберпанк-квартал",
    "seconds": "5",
    "metadata": {
      "resolution": "480p",
      "ratio": "9:16",
      "videos": ["https://ваш-домен/dance.mp4"]
    }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Сохранить движения человека из видео, сменить стиль на неоновый киберпанк-квартал",
        "seconds": "5",
        "metadata": {
            "resolution": "480p",
            "ratio": "9:16",
            "videos": ["https://ваш-домен/dance.mp4"],
        },
    },
)
print(resp.json()["id"])

Референс-видео требовательно ко входу: используйте короткий ролик длительностью ≤ 15 секунд с чётким объектом (например, человеком). Мультфильмы, ролики без явного объекта или слишком длинные видео часто приводят к ошибке. Желательно, чтобы соотношение сторон референса совпадало с целевым ratio (например, вертикальный источник → 9:16).

Продвинутое: несколько изображений / видео

images и videos — это массивы, в них можно передать сразу несколько референсов (оба варианта проверены):

Несколько изображений: передайте в images 3 и более изображений (официально до 9). Модель объединяет объект / сцену / стиль с нескольких картинок. При 3+ изображениях input_type определяется как reference автоматически.
Несколько видео: передайте в videos 2 и более роликов (официально до 3, суммарная длительность ≤ 15 секунд).

curl https://www.ruapi.ai/v1/videos \
  -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "prompt": "Объедини объект и стиль с этих изображений в цельное видео, естественное движение камеры",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "images": [
        "https://ваш-домен/ref1.jpg",
        "https://ваш-домен/ref2.jpg",
        "https://ваш-домен/ref3.jpg"
      ]
    }
  }'

import requests

resp = requests.post(
    "https://www.ruapi.ai/v1/videos",
    headers={"Authorization": "Bearer sk-ВАШ_КЛЮЧ"},
    json={
        "model": "doubao-seedance-2.0-fast",
        "prompt": "Объедини объект и стиль с этих изображений в цельное видео, естественное движение камеры",
        "seconds": "5",
        "metadata": {
            "resolution": "720p",
            "ratio": "16:9",
            "images": [
                "https://ваш-домен/ref1.jpg",
                "https://ваш-домен/ref2.jpg",
                "https://ваш-домен/ref3.jpg",
            ],
        },
    },
)
print(resp.json()["id"])

С видео аналогично: замените images на videos и передайте несколько коротких роликов (каждый желательно ≤ 7 секунд с чётким объектом, суммарно ≤ 15 секунд).

Статусы задачи

`status`	Значение
`queued`	В очереди
`in_progress`	Генерируется
`completed`	Готово, `metadata.url` — ссылка для скачивания
`failed`	Ошибка, причина в поле `error`

Тарификация

Видео тарифицируется по токенам (разрешение × длительность). При отправке списывается предоплата, а после завершения сумма пересчитывается по фактическому расходу — разница возвращается. Итог — по фактическому списанию. Цены — на странице цен.

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

Ошибка model_not_found / 404

Проверьте две вещи: правильно ли написано имя model (doubao-seedance-2.0-fast) и верен ли адрес https://www.ruapi.ai/v1/videos (с /v1).

Долго висит queued / in_progress

Это нормально. Генерация обычно занимает 1–3 минуты, просто продолжайте опрос и не делайте интервал слишком коротким.

Скачанный файл пустой / не открывается

Скорее всего прошло более 7 дней и ссылка истекла. Скачивайте сразу после генерации.

Задача с референс-видео завершилась ошибкой (failed)

Режим требователен ко входу. Убедитесь, что референс-видео длится ≤ 15 секунд, содержит чёткий объект и доступно как публичный MP4. Мультфильмы и ролики без явного объекта часто не проходят.

По какому адресу запрашивать задачу?

По маршруту во множественном числе GET /v1/videos/{id}. Это OpenAI-совместимый формат, и metadata.url в ответе сразу является ссылкой для скачивания.

Дальше

Цены и правила тарификации
Вопросы? [email protected]

Начало работы

Руководства

Справочник API

Гайды по моделям

Интеграции

Возможности

Рецепты

Юридическая информация

Генерация видео: Seedance 2.0

Доступные модели

Адрес API и авторизация

Шаг 1. Отправить задачу (текст-в-видео)

Шаг 2. Опрашивать статус

Шаг 3. Скачать видео

Полный пример: весь процесс одним скриптом

Параметры

Четыре типа входных данных

Режим 1. Текст-в-видео

Режим 2. Изображение-в-видео (1 изображение)

Режим 3. Первый-последний кадр (2 изображения)

Режим 4. Референс-видео (1 видео)

Продвинутое: несколько изображений / видео

Статусы задачи

Тарификация

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

Дальше

​Доступные модели

​Адрес API и авторизация

​Шаг 1. Отправить задачу (текст-в-видео)

​Шаг 2. Опрашивать статус

​Шаг 3. Скачать видео

​Полный пример: весь процесс одним скриптом

​Параметры

​Четыре типа входных данных

​Режим 1. Текст-в-видео

​Режим 2. Изображение-в-видео (1 изображение)

​Режим 3. Первый-последний кадр (2 изображения)

​Режим 4. Референс-видео (1 видео)

​Продвинутое: несколько изображений / видео

​Статусы задачи

​Тарификация

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

​Дальше

Доступные модели

Адрес API и авторизация

Шаг 1. Отправить задачу (текст-в-видео)

Шаг 2. Опрашивать статус

Шаг 3. Скачать видео

Полный пример: весь процесс одним скриптом

Параметры

Четыре типа входных данных

Режим 1. Текст-в-видео

Режим 2. Изображение-в-видео (1 изображение)

Режим 3. Первый-последний кадр (2 изображения)

Режим 4. Референс-видео (1 видео)

Продвинутое: несколько изображений / видео

Статусы задачи

Тарификация

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

Дальше