Seedance

Генерация видео

Создаёт задачу генерации видео. Возвращает task_id, по которому затем нужно опросить /v1/videos/fetch.

Необязательное поле type позволяет заранее объявить подтип задачи: edit для правки исходного видео или extend для его продолжения. Если поле передано, ограничения подтипа проверяются до создания задачи. Без type модель определяет подтип по промпту и референсам сама.

Оба подтипа требуют хотя бы одного референс-видео в videos и не поддерживают aspect_ratio: соотношение сторон берётся из исходного видео. Для edit также необходимо передать duration: -1, а исходное видео должно длиться от 4 до 30 секунд.

Промпт должен соответствовать объявленному подтипу. Для edit описывайте требуемую правку, например удаление, замену или изменение объекта. Для extend явно опишите продолжение сцены. Модель повторно проверяет подтип по промпту уже после запуска генерации.

При duration: -1 длина результата совпадает с длиной исходного видео, а стоимость рассчитывается по фактической длительности готового видео.

Для обычной генерации по описанию и генерации с референсами поле type не требуется. Если вы не уверены в подтипе, не передавайте его — модель определит подтип автоматически.

Звук

По умолчанию видео генерируется со звуком. Чтобы получить видео без звука, передайте generate_audio: false. Поле не влияет на стоимость.

Черновик и финал

Только для seedance-2.5. Черновик — недорогая версия видео в 480p, чтобы проверить результат перед генерацией в 1080p.

Создайте черновик: обычный запрос с draft: true. Разрешение черновика — только 480p, оно же используется по умолчанию.
Дождитесь status: completed в /v1/videos/fetch и посмотрите видео.
Запросите финал: передайте model и draft_task_id — task_id черновика. Финал генерируется в 1080p с тем же промптом, референсами, длительностью, соотношением сторон, звуком и подтипом, что и черновик.

В запросе финала нельзя передавать prompt, images, videos, audios, duration, aspect_ratio, generate_audio и type: они берутся из черновика. Запрос с любым из этих полей отклоняется сразу, с HTTP 400.

Финал можно запросить любым API-ключом того же аккаунта.

POST

videos

generations

curl --request POST \
  --url https://api.nixai.ru/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5",
  "prompt": "Красивый закат над морем",
  "duration": 5,
  "size": "720p",
  "generate_audio": false
}
'

{
  "task_id": "b22c9ae2-0b55-4398-88df-0191aae664f0"
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Draft not found.",
    "param": "draft_task_id",
    "code": "invalid_request"
  },
  "request_id": "7f1c2b9e-5d4a-4e3b-9c1a-2b6d8e0f4a11"
}

Authorizations

Authorization

string

header

required

Заголовок авторизации вида Bearer <token>, где <token> — ваш API-ключ.

Body

application/json

Генерация
Финал из черновика

model

enum<string>

required

Идентификатор видео-модели.

Available options:

seedance-2,

seedance-2-fast,

seedance-2-mini,

seedance-2.5

Example:

"seedance-2.5"

prompt

string

required

Текстовое описание желаемого видео.

Example:

"Красивый закат над морем"

duration

required

Длительность итогового видео в секундах. Обязательный параметр. Для type: edit необходимо передать -1: длина результата будет совпадать с длиной исходного видео.

seedance-2.5: целое значение от 4 до 30
остальные модели: целое значение от 4 до 15

Example:

5

type

enum<string>

Необязательный подтип задачи:

edit — правка исходного видео: удалить, заменить или дорисовать объект;
extend — продолжение исходного видео вперёд или назад.

Если поле не передано, модель определяет подтип автоматически по промпту и набору референсов. Обычная генерация по описанию и генерация с референсами не требуют объявления подтипа.

Available options:

edit,

extend

Example:

"edit"

size

enum<string>

default:480p

Разрешение итогового видео.

seedance-2-fast: 480p, 720p
seedance-2-mini: 480p, 720p
seedance-2.5: 480p, 720p, 1080p
seedance-2: 480p, 720p, 1080p, 4k

Для черновика (draft: true) — только 480p.

Available options:

480p,

720p,

1080p,

4k

Example:

"720p"

generate_audio

boolean

default:true

Генерировать ли звук вместе с видео. false — видео без звука. Не влияет на стоимость.

Example:

false

draft

boolean

default:false

Создать черновик — версию в 480p для проверки перед финалом в 1080p. Только для seedance-2.5. Разрешение черновика — только 480p, оно же используется по умолчанию.

Чтобы получить финал, передайте task_id черновика в draft_task_id следующего запроса.

Example:

true

aspect_ratio

enum<string>

Соотношение сторон видео. По умолчанию выбирается автоматически наиболее подходящее. Не передавайте для type: edit и type: extend: соотношение сторон берётся из исходного видео.

Available options:

16:9,

9:16,

4:3,

3:4,

1:1,

21:9

Example:

"16:9"

images

string[]

Список URL изображений для генерации видео на их основе. Для seedance-2.5 можно передать до 30 изображений, для остальных моделей — до 9. Общий лимит для seedance-2.5 — 50 материалов с учётом изображений, видео и аудио.

Maximum array length: 30

Example:

["https://example.com/photo.jpg"]

videos

string[]

Список URL видео для генерации видео на их основе. Для seedance-2.5 можно передать до 10 видео длительностью от 2 до 15 секунд каждое; для остальных моделей — до 3 видео. Общий лимит для seedance-2.5 — 50 материалов с учётом изображений, видео и аудио. Для type: edit и type: extend требуется хотя бы одно видео. При type: edit исходное видео должно длиться от 4 до 30 секунд.

Maximum array length: 10

Example:

["https://example.com/clip.mp4"]

audios

string[]

Список URL аудио для генерации видео на их основе. Для seedance-2.5 можно передать до 10 аудиофайлов, для остальных моделей — до 3. Общий лимит для seedance-2.5 — 50 материалов с учётом изображений, видео и аудио.

Maximum array length: 10

Example:

["https://example.com/sound.mp3"]

Response

Задача создана

task_id

string

Идентификатор задачи для последующего опроса через fetch.

Example:

"b22c9ae2-0b55-4398-88df-0191aae664f0"

curl --request POST \
  --url https://api.nixai.ru/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.5",
  "prompt": "Красивый закат над морем",
  "duration": 5,
  "size": "720p",
  "generate_audio": false
}
'

{
  "task_id": "b22c9ae2-0b55-4398-88df-0191aae664f0"
}

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Draft not found.",
    "param": "draft_task_id",
    "code": "invalid_request"
  },
  "request_id": "7f1c2b9e-5d4a-4e3b-9c1a-2b6d8e0f4a11"
}

Text models

Audio models

Image models

Video models

Генерация видео

Звук

Черновик и финал

Authorizations

Body

Response