Перейти к основному содержанию
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-ВАШ_КЛЮЧ (создаётся в панели, раздел «Токены»)
Генерация асинхронная, всего три шага:
1

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

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

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

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

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

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")

​
Параметры

Поля верхнего уровня:
ПолеТипОписание
modelstringdoubao-seedance-2.0-fast или doubao-seedance-2.0
promptstringОбязательно. Текстовое описание сцены
secondsstringДлительность (сек), 4–15, например "5", "10"
metadataobjectРазрешение, соотношение сторон, входные изображения/видео — см. таблицу ниже
Поля внутри metadata:
ПолеТипОписание
resolutionstring"480p" / "720p" / "1080p"
ratiostringСоотношение сторон, например "16:9", "9:16", "1:1"
input_typestringТип входа (обычно можно не указывать — определяется автоматически): text_to_video / first_last_frame / reference
imagesstring[]Массив URL изображений (для изображение-в-видео)
videosstring[]Массив URL видео (для референс-видео)
Чем выше разрешение и длиннее ролик, тем больше токенов и дороже. Если сомневаетесь — начните с 480p / 5 секунд, а потом настраивайте.

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

input_type обычно указывать не нужно — он определяется по количеству изображений/видео; при желании задаётся явно через metadata.input_type.
РежимКак передать входОпределяемый input_type
Текст-в-видеотолько prompttext_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 (doubao-seedance-2.0-fast) и верен ли адрес https://www.ruapi.ai/v1/videos (с /v1).
Это нормально. Генерация обычно занимает 1–3 минуты, просто продолжайте опрос и не делайте интервал слишком коротким.
Скорее всего прошло более 7 дней и ссылка истекла. Скачивайте сразу после генерации.
Режим требователен ко входу. Убедитесь, что референс-видео длится ≤ 15 секунд, содержит чёткий объект и доступно как публичный MP4. Мультфильмы и ролики без явного объекта часто не проходят.
По маршруту во множественном числе GET /v1/videos/{id}. Это OpenAI-совместимый формат, и metadata.url в ответе сразу является ссылкой для скачивания.

​
Дальше