Видео генерируется по текстовому описанию, а иногда и по картинке, которую нужно оживить. Задача долгая — минуты, а не секунды, — поэтому работа устроена в три шага: создать задачу, дождаться готовности, забрать файл.

POST /v1/videos принимает модель и описание. В ответ приходит не видео, а идентификатор задачи и её текущий статус.

curl "https://api.proxyapi.ru/v1/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "bytedance/seedance-2.0",
        "prompt": "Дрон летит над осенним лесом на рассвете",
        "resolution": "720p",
        "duration": 5
    }'

Ответ выглядит так:

{
    "id": "job-abc123",
    "status": "pending",
    "polling_url": "https://api.proxyapi.ru/v1/videos/job-abc123"
}

id — то, по чему дальше отслеживается задача. Рядом лежит polling_url — готовый адрес для проверки статуса, собирать его вручную не нужно.

Статус запрашивается по тому же идентификатору. Пока видео готовится, значение остаётся рабочим; в конце оно становится completed либо failed.

curl "https://api.proxyapi.ru/v1/videos/job-abc123" \
    -H "Authorization: Bearer <КЛЮЧ>"

У готовой задачи в ответе появляются ссылки на файлы:

{
    "id": "job-abc123",
    "status": "completed",
    "unsigned_urls": ["https://api.proxyapi.ru/v1/videos/job-abc123/content?index=0"]
}

Видео скачивается по этой ссылке — или тем же запросом напрямую:

curl "https://api.proxyapi.ru/v1/videos/job-abc123/content" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    --output video.mp4

Разрешение, длительность, соотношение сторон и наличие звука задаются полями resolution, duration, aspect_ratio и generate_audio; вместо разрешения можно указать точный размер полем size. Если ничего не передать, подставятся значения по умолчанию для этой модели.

Каждое значение сверяется с возможностями конкретной модели ещё до начала генерации. Неподдерживаемое сочетание — например, длительность, которой у модели нет, — вернёт ошибку 400, и деньги при этом не списываются.

Модели, которые умеют работать с картинкой на входе, принимают её в frame_images или input_references. Если модель этого не умеет, запрос тоже отклоняется. У Seedance 2.x эти поля нельзя смешивать в одном запросе: либо кадры, либо референсы.

У Seedance 2.5 с frame_images, а также у всех Seedance 2.x в режимах редактирования и продолжения, форма ролика берётся с входного кадра или видео. Поля aspect_ratio и size в таком запросе не передаются, допустимо только "aspect_ratio": "adaptive". Подробнее — в разделе Соотношение сторон по первому кадру.

Seedance 2.x принимает в input_references не только картинки, но и видео и аудио. Каждый элемент — объект с типом и ссылкой: image_url, video_url или audio_url. Типы можно сочетать в одном запросе, а в описании ссылаться на них по порядку: «девушка с первой картинки», «музыка из записи».

Картинки задают внешность героя, предмет, место или стиль. Seedance 2.0, 2.0 fast и 2.0 mini принимают до 9 изображений, Seedance 2.5 — до 30.

curl "https://api.proxyapi.ru/v1/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "bytedance/seedance-2.0",
        "prompt": "Девушка с первой картинки идёт по улице со второй",
        "resolution": "720p",
        "duration": 5,
        "input_references": [
            {"type": "image_url", "image_url": {"url": "https://example.com/girl.png"}},
            {"type": "image_url", "image_url": {"url": "https://example.com/street.png"}}
        ]
    }'

Ролик на входе задаёт движение, ракурс или исходный материал, который нужно перерисовать. Ссылка — только https://. Seedance 2.0, 2.0 fast и 2.0 mini принимают до 3 роликов, каждый от 2 до 15 секунд, вместе не больше 15 секунд. Seedance 2.5 — до 10 роликов, каждый от 2 до 30 секунд, вместе не больше 30 секунд.

curl "https://api.proxyapi.ru/v1/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "bytedance/seedance-2.0",
        "prompt": "Перерисуй ролик в стиле акварели, движение камеры сохрани",
        "resolution": "720p",
        "duration": 6,
        "input_references": [
            {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}}
        ]
    }'

Видео на входе оплачивается вместе с результатом: считаются секунды готового ролика плюс секунды входа. Вход засчитывается по фактической длине, но не меньше ⅔ длины результата. Например, к 6-секундному результату с 3-секундным клипом засчитается 6 + 4 = 10 секунд. При создании задачи стоимость оценивается по максимальной длине входа — 15 секунд у Seedance 2.0, 2.0 fast и 2.0 mini, 30 секунд у Seedance 2.5, — а после завершения списывается по фактической длине. Цена секунды для такого режима своя — на странице модели она подписана «с видео на входе».

Запись задаёт голос, музыку или звуковое сопровождение. Передаётся в audio_url: ссылкой https:// или строкой data:audio/...;base64,.... Seedance 2.0, 2.0 fast и 2.0 mini принимают до 3 записей, каждая от 2 до 15 секунд, вместе не больше 15 секунд. Seedance 2.5 — до 10 записей, каждая от 2 до 30 секунд, вместе не больше 30 секунд. У Seedance 2.0, 2.0 fast и 2.0 mini аудио работает только в паре с картинкой или видео в тех же input_references — само по себе запрос отклоняется. Seedance 2.5 принимает и одни записи, с описанием или без. Отдельно аудио не оплачивается.

curl "https://api.proxyapi.ru/v1/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "bytedance/seedance-2.0",
        "prompt": "Герой с картинки произносит фразу из записи",
        "resolution": "720p",
        "duration": 5,
        "input_references": [
            {"type": "image_url", "image_url": {"url": "https://example.com/hero.png"}},
            {"type": "audio_url", "audio_url": {"url": "https://example.com/voice.mp3"}}
        ]
    }'

Все модели Seedance 2.x — 2.0, 2.0 fast, 2.0 mini и 2.5 — умеют менять готовый ролик и продолжать его. Режим задаётся полем omni_reference_task_type, а сам ролик передаётся одним видео в input_references:

  • edit — правка по описанию: заменить предмет, цвет, фон. Длина результата совпадает с исходником, поэтому duration не передаётся. Исходник — не короче 4 секунд.
  • extend — продолжение: модель дописывает новые кадры, duration задаёт длину результата.

Соотношение сторон в обоих режимах берётся из исходного ролика, поля aspect_ratio и size не передаются. Оплата — как за видео на входе.

curl "https://api.proxyapi.ru/v1/videos" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    -d '{
        "model": "bytedance/seedance-2.5",
        "prompt": "Замени синюю куртку на красную",
        "resolution": "720p",
        "omni_reference_task_type": "edit",
        "input_references": [
            {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}}
        ]
    }'

Для продолжения меняются режим и длительность:

{
    "model": "bytedance/seedance-2.5",
    "prompt": "Камера отъезжает, герой уходит вдаль",
    "resolution": "720p",
    "duration": 5,
    "omni_reference_task_type": "extend",
    "input_references": [
        {"type": "video_url", "video_url": {"url": "https://example.com/clip.mp4"}}
    ]
}

"aspect_ratio": "adaptive" подстраивает форму ролика под входные материалы: если передан первый кадр, видео получится той же формы, что и картинка. Так вертикальное фото не придётся обрезать под 16:9.

{
    "model": "bytedance/seedance-2.0",
    "prompt": "Кот на фото потягивается и зевает",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "adaptive",
    "frame_images": [
        {"type": "image_url", "image_url": {"url": "https://example.com/cat.jpg"}, "frame_type": "first_frame"}
    ]
}

У Seedance 2.5 с frame_images форма всегда берётся с кадра: явное соотношение сторон (например, "9:16") или size в таком запросе вернут ошибку 400. Передайте "aspect_ratio": "adaptive" или не передавайте эти поля совсем — вертикальная картинка даст вертикальное видео.

"duration": -1 отдаёт выбор длины модели — она подбирает её под сюжет. Так умеют модели Seedance 2.x. При создании задачи стоимость оценивается по максимальной длительности модели, а списывается по фактической длине готового ролика.

"return_last_frame": true просит вернуть последний кадр отдельной картинкой. В готовой задаче в unsigned_urls появится вторая ссылка, а сам кадр в JPEG скачивается по индексу 1:

curl "https://api.proxyapi.ru/v1/videos/job-abc123/content?index=1" \
    -H "Authorization: Bearer <КЛЮЧ>" \
    --output last-frame.jpg

Его удобно передать первым кадром следующего ролика, чтобы склеить длинную сцену из частей.

"watermark": true добавляет на видео водяной знак модели. По умолчанию его нет.

Какие модели доступны для видео, отдаёт отдельный эндпоинт:

curl "https://api.proxyapi.ru/v1/videos/models" \
    -H "Authorization: Bearer <КЛЮЧ>"

Цена зависит от разрешения, длительности, того, генерируется ли звук, и того, что подано на вход: только текст, картинка, референсы или видео. Секунда в 1080p стоит заметно дороже секунды в 720p. Видео на входе добавляет к оплате свои секунды — подробнее в разделе о видео. Списание происходит за готовое видео.

Если для запрошенного сочетания параметров цены нет, запрос отклоняется с ошибкой 400 — раньше, чем начнётся генерация.

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

Почему в ответе нет видео?

Генерация занимает минуты, поэтому запрос лишь создаёт задачу и возвращает её идентификатор. Готовность проверяется отдельным запросом, файл забирается третьим.

Можно ли получить уведомление о готовности?

Нет. Поле callback_url не поддерживается и вернёт ошибку 400 — статус задачи нужно опрашивать самостоятельно.

Почему приходит ошибка на разрешение или длительность?

Значения проверяются по возможностям выбранной модели до начала генерации. Если модель не умеет запрошенное сочетание, запрос отклоняется и деньги не списываются.

От чего зависит стоимость?

От разрешения, длительности, наличия звука и того, что подано на вход: текст, картинки или видео. Видео на входе добавляет к оплате свои секунды. Оплачивается готовое видео, а не сама попытка: если параметры отвергнуты на входе, списания нет.

Как оплачивается видео на входе?

Считаются секунды готового ролика плюс секунды входа. Вход засчитывается по фактической длине, но не меньше ⅔ длины результата. При создании задачи стоимость оценивается по максимальной длине входа (15 секунд у Seedance 2.0, 2.0 fast и 2.0 mini, 30 секунд у Seedance 2.5), а списывается по фактической длине после завершения.

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

Да, во всех моделях Seedance 2.x — 2.0, 2.0 fast, 2.0 mini и 2.5: поле omni_reference_task_type со значением edit или extend и один ролик в input_references. Какие модели что умеют, указано на их страницах.

Последняя редакция: 8 ноября 2026 г.