doubao-seedance-2.5: ролики до 30 секунд, разрешение до 1080p и до 30 референс-изображений в одном запросе.
Доступные модели
Адрес API и авторизация
- Base URL:
https://www.ruapi.ai/v1 - Авторизация: заголовок
Authorization: Bearer sk-ВАШ_КЛЮЧ(создаётся в панели, раздел «API-ключи»)
Отправить задачу
POST /v1/videos → возвращает id задачиОпрашивать статус
GET /v1/videos/{id} → пока status не станет completedСкачать видео
GET /v1/videos/{id}/content → получить MP4Шаг 1. Отправить задачу (текст-в-видео)
id — это номер задачи, он нужен для следующих двух шагов):
Шаг 2. Опрашивать статус
Запрашивайте по маршрутуGET /v1/videos/{id} примерно раз в 5 секунд. status проходит путь queued → in_progress → completed.
metadata.url — ссылка для скачивания):
Шаг 3. Скачать видео
Полный пример: весь процесс одним скриптом
Скопируйте и запустите, подставив свойsk-ВАШ_КЛЮЧ:
То же на curl
Одна команда для macOS, Linux и Windows (Git Bash / WSL): отправляет задачу, ждёт готовности (обычно 2–5 минут) и сохраняетseedance.mp4. Подставьте свой ключ в первой строке. Если что-то пошло не так, команда покажет ответ API с причиной.
Параметры
Поля верхнего уровня:metadata:
480p / 5 секунд, а потом настраивайте.Четыре типа входных данных
input_type обычно указывать не нужно — он определяется по количеству изображений/видео; при желании задаётся явно через metadata.input_type.
doubao-seedance-2.0 и doubao-seedance-2.5. Для референса и первого и последнего кадра у -mini и -fast добавьте "auto_create_assets": true в metadata — см. раздел «Частые вопросы» ниже.Режим 1. Текст-в-видео
Только текстовыйprompt — генерация целиком по описанию.
Режим 2. Изображение-в-видео (1 изображение)
Вmetadata.images — URL одного изображения: оно становится первым кадром ролика, и модель оживляет сцену, начиная с него. В prompt опишите нужное движение / работу камеры. Если картинка нужна только как референс (сохранить персонажа или стиль, не начиная с неё), добавьте в metadata "input_type": "reference".
Режим 3. Первый-последний кадр (2 изображения)
Вmetadata.images — 2 изображения: первое = стартовый кадр, второе = финальный кадр. Генерируется плавный переход от первого ко второму.
Режим 4. Референс-видео (Omni reference, 1 видео)
Вmetadata.videos — URL одного короткого видео; модель переосмысливает его, сохраняя движения объекта (например, меняет стиль или сцену).
doubao-seedance-2.5 есть референс-видео, указывайте "ratio": "adaptive". Когда промпт звучит как «продолжи это видео», модель может сама посчитать задачу продлением видео, а для продления подходит только adaptive: с другим соотношением сторон задача завершится ошибкой с кодом InvalidParameter.TaskTypeConstraint в поле error. Как явно отредактировать или продлить видео — см. раздел «Редактирование и продление видео в Seedance 2.5» ниже.Продвинутое: несколько изображений / видео
images и videos — это массивы, в них можно передать сразу несколько референсов (оба варианта проверены):
- Несколько изображений: передайте в
images3 и более изображений (официально до 9; уdoubao-seedance-2.5— до 30). Модель объединяет объект / сцену / стиль с нескольких картинок. При 3+ изображенияхinput_typeопределяется какreferenceавтоматически. - Несколько видео: передайте в
videos2 и более роликов (официально до 3, суммарная длительность ≤ 15 секунд; уdoubao-seedance-2.5— до 10, суммарно ≤ 30 секунд).
images на videos и передайте несколько коротких роликов (каждый желательно ≤ 7 секунд с чётким объектом, суммарно ≤ 15 секунд; у doubao-seedance-2.5 — суммарно ≤ 30 секунд).Референс-аудио
Вmetadata.audios передайте массив URL аудиофайлов — например, голос или музыку, на которые модель будет ориентироваться. Аудио, как изображения и видео, должно быть доступно по публичному URL.
doubao-seedance-2.0,-fastи-mini— до 3 аудиофайлов и только вместе хотя бы с одним изображением или видео: запрос, где есть только аудио, вернёт400.doubao-seedance-2.5— до 10 аудиофайлов; можно передать и только аудио, без изображений и видео: например, сцена описана текстом, а голос или музыка берутся из референс-аудио.
doubao-seedance-2.5 — не больше 50. Если в запросе есть аудио или видео, изображения работают как референсы, а не как первый кадр. Референс-аудио отдельно не тарифицируется: один и тот же ролик с ним и без него расходует одинаковое число токенов.
Видео без звука
По умолчанию Seedance генерирует видео со звуком. Чтобы получить ролик без звуковой дорожки, передайте"generate_audio": false: в metadata — для POST https://www.ruapi.ai/v1/videos, на верхнем уровне запроса — для формата ModelArk.
Статусы задачи
Сколько задач можно запускать одновременно
У каждого аккаунта одновременно может быть не больше 3 незавершённых видеозадач (в очереди или в работе) — это общий лимит для всех ключей и моделей аккаунта. Следующая задача сразу получает ответ429 с кодом video_concurrency_limit и заголовком Retry-After: 30; деньги за неё не списываются. Дождитесь, пока одна из задач завершится, и отправьте запрос снова.
Если вам нужно больше параллельных задач, напишите в поддержку — на support@ruapi.ai или в Telegram @RuAPI_Support.
Уведомление о готовности (callback)
Вместо того чтобы опрашивать статус, можно попросить RuAPI самому сообщить вашему серверу, что задача завершилась (вебхук). Для этого при создании задачи передайте:callback_url— адрес, на который придёт уведомление: толькоhttps://, только публичный адрес (неlocalhostи не адрес во внутренней сети), без логина и пароля в URL, до 1024 символов;callback_secret(необязательно) — секрет для подписи уведомления, до 256 символов.
POST https://www.ruapi.ai/v1/videos оба поля можно указать в metadata или на верхнем уровне запроса, в формате ModelArk — на верхнем уровне. Если адрес не подходит, задача не создаётся: ответ 400 с кодом invalid_callback, деньги не списываются.
callback_url запрос POST. В теле — тот же JSON, который в этот момент вернул бы запрос статуса: GET https://www.ruapi.ai/v1/videos/{id} для задач, созданных через /v1/videos, или GET https://www.ruapi.ai/v1/contents/generations/tasks/{id} для задач в формате ModelArk. Промежуточные статусы не отправляются.
2xx в течение 10 секунд. Иначе RuAPI повторит отправку примерно через 10 секунд, 1 минуту и 5 минут — всего 4 попытки, после этого отправка прекращается. RuAPI не переходит по редиректам (3xx) и считает такой ответ ошибкой. Отвечайте 200 сразу, а долгую обработку (например, скачивание видео) делайте в фоне. Если все попытки не удались, узнайте статус обычным запросом GET.
Как проверить подпись
Вычисляйте подпись по сырому телу запроса — до разбора JSON — и сверяйте её с заголовком функцией сравнения за постоянное время (hmac.compare_digest, crypto.timingSafeEqual). Уведомления старше нескольких минут лучше отклонять.
Список задач и удаление
Список.GET https://www.ruapi.ai/v1/videos возвращает задачи, созданные тем же API-ключом, с которым сделан запрос: задачи других ключей аккаунта в список не попадают. Получить или удалить конкретную задачу по id можно любым ключом аккаунта.
{"object": "list", "data": [...], "first_id": "...", "last_id": "...", "has_more": false}; в data те же объекты, что возвращает GET https://www.ruapi.ai/v1/videos/{id}.
Удаление. DELETE https://www.ruapi.ai/v1/videos/{id} удаляет завершённую задачу (completed или failed) и возвращает {"id": "...", "object": "video.deleted", "deleted": true}. После удаления задача пропадает из списка, GET https://www.ruapi.ai/v1/videos/{id} возвращает ошибку с кодом task_not_exist, а ссылка на скачивание перестаёт работать — сначала сохраните видео.
Формат BytePlus ModelArk: /v1/contents/generations/tasks
Если у вас уже есть код под API BytePlus ModelArk (Volcengine Ark), переписывать его на/v1/videos не нужно: RuAPI принимает запросы и в этом формате. Замените в коде адрес API (…/api/v3) на https://www.ruapi.ai/v1, ключ — на ключ RuAPI, а имя модели — на название из таблицы выше (например, doubao-seedance-2.5; идентификаторы моделей с датой из документации ModelArk не подойдут). Запросы и ответы — в официальном формате ModelArk; дополнительно есть два поля-расширения RuAPI, которых нет в официальной документации: auto_create_assets и reference_video_task_id; предоплата, тарифы и лимит в 3 задачи — те же, что у /v1/videos.
GET https://www.ruapi.ai/v1/contents/generations/tasks/{id} после завершения:
status:queued→running→succeededилиfailed(причина — вerror). Статусовcancelledиexpiredу RuAPI не бывает.content.video_url— подписанная ссылка на скачивание: API-ключ для неё не нужен, она действует 24 часа с момента запроса статуса, но само видео хранится только 23 часа после завершения задачи. Если срок ссылки истёк (ответ403с кодомlink_expired), запросите статус ещё раз — придёт новая ссылка.- Параметры генерации —
resolution,ratio,duration,generate_audio— передавайте полями JSON. Команды в тексте промпта вроде--dur 10или--rs 1080pне поддерживаются — такой запрос получит400. - Текст в
contentможно не передавать, если в запросе есть изображение, видео или аудио (моделиdoubao-seedance-2.0,doubao-seedance-2.0-fast,doubao-seedance-2.0-miniиdoubao-seedance-2.5): например, только первый кадр. Одно аудио без изображений и видео принимает толькоdoubao-seedance-2.5. Запрос без текста и без медиа получит400. - Ошибки приходят в формате ModelArk:
{"error": {"code": "...", "message": "..."}}. callback_urlиcallback_secretуказываются на верхнем уровне; уведомление придёт в формате ModelArk (см. раздел «Уведомление о готовности» выше).
Режим черновика в Seedance 2.5: проверка перед 1080p
Ролик в 1080p заметно дороже, чем в 480p. В режиме черновика (Draft mode)doubao-seedance-2.5 сначала делает недорогой образец в 480p — по нему видно композицию, движение и звук. Если результат устраивает, из этого же черновика делается финальное видео в 1080p: промпт, референсы, длительность, соотношение сторон, звук и seed берутся из черновика. Если не устраивает, измените промпт и сделайте новый черновик: платить за 1080p не придётся.
Черновики работают только с моделью doubao-seedance-2.5 и только через https://www.ruapi.ai/v1/contents/generations/tasks. В POST https://www.ruapi.ai/v1/videos поле draft не действует — получится обычное видео.
Сделать черновик (480p)
"draft": true. Разрешение — только 480p (можно не указывать; другое значение вернёт 400). Оплата — как за обычное видео 480p той же длительности: например, 4 секунды — около $0.52.Сделать финальное видео (1080p)
succeeded, создайте новую задачу: в content — только ссылка на черновик {"type": "draft_task", "draft_task": {"id": "<id черновика>"}}, и обязательно "resolution": "1080p". Дополнительно можно передать callback_url и callback_secret; текст, изображения, видео, аудио, duration, ratio, generate_audio и seed во втором шаге не принимаются (ответ 400).{"id": "task_..."}: это id черновика. Дождитесь статуса succeeded, посмотрите ролик по content.video_url и, если всё устраивает, выполните второй шаг:
- черновик создан вашим аккаунтом с
"draft": true, завершился успешно и не удалён; - модель та же —
doubao-seedance-2.5; - с момента создания черновика прошло не больше 7 дней (иначе
400с кодомdraft_task_expired).
400 с кодом draft_unavailable — сделайте новый черновик. Финальное видео оплачивается по тарифу 1080p без референс-видео (см. таблицу ниже): предоплата — по длительности черновика, итог — по фактическим токенам.
Редактирование и продление видео в Seedance 2.5
doubao-seedance-2.5 умеет редактировать готовое видео (video editing) или продлевать его (video extension). Добавьте в запрос omni_reference_task_type (task type hint) и передайте исходное видео как референс-видео:
"auto"), модель сама решает по входным материалам и промпту, что делать.
Правила:
- работает только с
doubao-seedance-2.5, другие модели вернут400; - нужно хотя бы одно референс-видео:
metadata.videosили видео с"role": "reference_video"вcontentв формате ModelArk; вместе с изображениями первого и последнего кадра не работает; ratio— только"adaptive"или не указывать (тогда используетсяadaptive, и соотношение сторон берётся из исходного видео);- редактирование: длина результата та же, что у исходного видео, поэтому
duration— только-1или не указывать (в/v1/videosне указывайте иseconds); - продление:
duration— длина нового фрагмента (4–30 секунд, по умолчанию 5). Исходное видео в результат не входит: первый кадр результата — это последний кадр исходного видео. Чтобы получить один длинный ролик, склейте исходное видео и новый фрагмент сами; - с режимом черновика не сочетается.
POST https://www.ruapi.ai/v1/videos — внутри metadata. Пример редактирования (формат ModelArk):
/v1/videos, ещё 4 секунды):
-1, поэтому оценка идёт по максимальному результату в 30 секунд плюс 30 секунд референс-видео (около $4.65 для 480p по стандартной цене), и на балансе должно быть не меньше этой суммы. После завершения сумма пересчитывается по фактическим токенам, излишек возвращается на баланс.
Если в исходном видео есть реальный человек (в том числе в видео, созданном в RuAPI): с doubao-seedance-2.0 и doubao-seedance-2.5 его обычно можно передать напрямую; doubao-seedance-2.0-mini и doubao-seedance-2.0-fast такие видео обычно отклоняют — переключитесь на 2.0 / 2.5 или см. раздел «Повторное использование готового видео: reference_video_task_id» ниже.
Референсному видео нужно не меньше примерно 410 000 пикселей (например, 854×480; видео 480p в формате 4:3 или 21:9 может не дотянуть — используйте 720p): видео меньше отклоняются, деньги не списываются.
Видео в формате MOV в Seedance 2.5
По умолчаниюdoubao-seedance-2.5 выдаёт MP4. Если нужен файл MOV (QuickTime), добавьте "output_format": "mov": на верхнем уровне запроса в формате ModelArk или внутри metadata в POST https://www.ruapi.ai/v1/videos. Цена та же, что у MP4. Для других моделей "mov" вернёт 400.
GET https://www.ruapi.ai/v1/videos/{id}/content вернёт файл MOV (Content-Type: video/quicktime), сохраняйте его с расширением .mov. output_format можно указать в одном запросе с редактированием или продлением; во втором шаге черновика он не поддерживается.
Повторное использование готового видео: reference_video_task_id
Видео с реальным человеком, переданное напрямую как референс-видео,doubao-seedance-2.0 и doubao-seedance-2.5 обычно принимают, а doubao-seedance-2.0-mini и doubao-seedance-2.0-fast обычно отклоняют (код ошибки InputVideoSensitiveContentDetected.PrivacyInformation) — даже если это видео создано в RuAPI. Чтобы отредактировать или продлить такое видео на mini / fast либо сделать по нему новое, укажите в запросе id его задачи в поле reference_video_task_id: по id задачи модель узнаёт собственное видео и может его принять — стоит попробовать. Подходит не каждое видео — см. условия ниже.
Это поле — расширение RuAPI (в официальной документации ModelArk его нет), и работает оно только в формате ModelArk — POST https://www.ruapi.ai/v1/contents/generations/tasks, на верхнем уровне запроса. В POST https://www.ruapi.ai/v1/videos оно не действует: видео передаётся как обычное референс-видео.
reference_video_task_id— id видеозадачи вашего аккаунта (task_...): задача завершилась успешно, не удалена, и с момента завершения прошло не больше 23 часов;- это же видео должно быть в
contentровно один раз, с"role": "reference_video"; адрес —content.video_urlиз ответа на запрос статуса илиhttps://www.ruapi.ai/v1/videos/{id задачи}/content; - модель — та же, что создала исходное видео: при ссылке по id задачи с другой моделью, даже из линеек Seedance 2.0 / 2.5, видео с реальным человеком, скорее всего, будет отклонено (если передать видео напрямую в
doubao-seedance-2.0/doubao-seedance-2.5без id задачи, обычно получается — см. выше); - вместе с
auto_create_assetsиdraft_taskне работает; сам черновик (образец в 480p) так использовать нельзя — сначала сделайте из него финальное видео; - в одном запросе можно указать и
omni_reference_task_type(редактирование, продление), иoutput_format, если это поддерживается там, где создано исходное видео (иначе —unsupported_by_channel).
400 с кодом unsupported_by_channel, деньги не списываются. Сейчас это работает с видео, созданными с auto_create_assets; с остальными — не всегда. Для видео без реальных людей поле не нужно: скачайте видео и передайте его как обычное референс-видео по своему публичному URL.
Оплата — как за обычный запрос с референс-видео: длительность исходного видео тоже учитывается в токенах (см. абзац «Тарификация» в разделе «Редактирование и продление видео в Seedance 2.5» выше).
Ошибки этой функции (все — 400, деньги не списываются):
Тарификация
Видео тарифицируется по токенам: токены ≈ ширина × высота × секунды × 24 ÷ 1024 (480p — около 10 тыс. токенов в секунду). Цена за токен зависит от разрешения и от того, есть ли референс-видео. Цена за 1 млн токенов в зависимости от разрешения и референс-видео (стандартные цены — как на странице цен при выборе «Обычные», 6 ноября 2026; для новых аккаунтов при первом пополнении и для аккаунтов с пополнениями от $100 — дешевле):doubao-seedance-2.0-mini. С референс-видео цена за токен ниже, но токены самого референс-видео тоже учитываются. Оплачиваются только успешно созданные видео.
При отправке списывается предоплата — оценка с запасом:
- разрешение — указанное в запросе; если его нет, видео генерируется и оплачивается в
720p; - длительность — указанная в запросе; если её нет — 5 секунд; для
-1— максимальная: 15 секунд, уdoubao-seedance-2.5— 30; - токены в секунду — по самому «тяжёлому» для этого разрешения соотношению сторон;
- референс-видео — у моделей 2.0 к длительности добавляется по 15 секунд за каждое референс-видео (учитывается не больше трёх); у
doubao-seedance-2.5все референс-видео вместе считаются как 30 секунд.
Частые вопросы
Модель недоступна (503) или 404
Модель недоступна (503) или 404
model (например, doubao-seedance-2.0-fast) — иначе придёт 503 с кодом model_not_found; и верен ли адрес https://www.ruapi.ai/v1/videos (с /v1) — иначе 404.Долго висит queued / in_progress
Долго висит queued / in_progress
Скачанный файл пустой / не открывается
Скачанный файл пустой / не открывается
410 или 502), и вместо видео в файл сохраняется текст ошибки. Скачивайте сразу после генерации.Задача с референс-видео завершилась ошибкой (failed)
Задача с референс-видео завершилась ошибкой (failed)
Ошибка input_contains_real_person / PrivacyInformation: реальный человек на фото или видео
Ошибка input_contains_real_person / PrivacyInformation: реальный человек на фото или видео
input_contains_real_person (при отправке задачи) или InputImageSensitiveContentDetected.PrivacyInformation (в поле error готовой задачи). Модель строго проверяет фотографии реальных людей (защита от дипфейков) и может их отклонить; в RuAPI фото обычных людей, как правило, можно использовать — в зависимости от модели и режима (см. выше). Если ошибка всё же появилась:- Фото обычного человека (не публичной персоны). Отправьте тот же запрос ещё раз и добавьте в
metadataполе"auto_create_assets": true(в формате ModelArk — на верхнем уровне запроса). Фото пройдёт отдельную проверку только для этого ролика: это может добавить 1–2 минуты, и проверку оно может не пройти. Работает только с изображениями по публичному URL (http/https), с видео — нет. Если с параметром фото снова отклонено, скорее всего, на нём публичная персона — см. следующий вопрос. - Реальный человек в референс-видео (
input_contains_real_personпри отправке,InputVideoSensitiveContentDetected.PrivacyInformationв готовой задаче). Обычно помогает переключиться наdoubao-seedance-2.0илиdoubao-seedance-2.5:-miniи-fastтакие видео обычно не принимают.auto_create_assetsработает только с фото, не с видео. Если видео создано в RuAPI не больше 23 часов назад, попробуйте использовать его по id задачи той же моделью — см. раздел «Повторное использование готового видео: reference_video_task_id» выше. - Без реальных людей. Замените изображение на иллюстрацию, персонажа, предмет или пейзаж либо опишите сцену только текстом.
Ошибка input_copyright_restricted / PolicyViolation: публичные персоны и персонажи
Ошибка input_copyright_restricted / PolicyViolation: публичные персоны и персонажи
input_copyright_restricted (при отправке задачи) или InputImageSensitiveContentDetected.PolicyViolation (в поле error готовой задачи). Изображения с публичными персонами (знаменитости, блогеры) и с персонажами, защищёнными авторским правом (кино, сериалы, игры), модель не принимает; то же относится к запросам, где такой персонаж назван в тексте — параметр auto_create_assets здесь не помогает. Используйте свои изображения или фото обычных людей. Предоплата за отклонённую задачу возвращается на баланс. Если вашему проекту действительно нужна публичная персона и у вас есть её согласие, напишите в поддержку — на support@ruapi.ai или в Telegram @RuAPI_Support. Разбор всех кодов модерации Seedance — на странице Seedance: PolicyViolation и SensitiveContentDetected.Ошибка 400 при вызове Seedance через /v1/chat/completions
Ошибка 400 при вызове Seedance через /v1/chat/completions
/v1/chat/completions, /v1/responses, /v1/messages или /v1/images/generations. Такой запрос сразу получает 400 с подсказкой, деньги не списываются. Создавайте задачу через POST https://www.ruapi.ai/v1/videos (или POST https://www.ruapi.ai/v1/contents/generations/tasks в формате ModelArk). Если эту ошибку показывает проверка моделей в клиенте вроде Cherry Studio — это нормально: такие клиенты проверяют все модели как чат-модели.По какому адресу запрашивать задачу?
По какому адресу запрашивать задачу?
GET /v1/videos/{id}. Это OpenAI-совместимый формат, и metadata.url в ответе сразу является ссылкой для скачивания.