Seedance 2.5

Seedance 2.5 поддерживает текст, первый и последний кадры, референсы изображений, видео и аудио; разрешения: 480p, 720p, 1080p. Генерируйте до 30 секунд на запрос. Описание модели и Playground.

Подключение к Wan APIКопировать ссылку на заголовок

Используйте https://api.wanapi.app как базовый URL API. Создайте ключ в настройках API: один ключ подходит для всех моделей. Передавайте его как Authorization: Bearer YOUR_API_KEY. Храните ключи на сервере. Playground использует вашу сессию сайта и тот же баланс аккаунта; вставлять ключ в браузер не требуется.

Для доступа нужен активный аккаунт с достаточным балансом. GET /v1/models возвращает модели, доступные вашему ключу. Модели Seedance используют POST /v1/videos; выберите модель в теле JSON.

Раздел поля запроса описывает все 14 полей верхнего уровня. Используйте приведённые имена полей, включая aspectRatio и generateAudio.

Отправка задачи Seedance 2.5Копировать ссылку на заголовок

Это запрос генерации четырёхсекундного видео из текста в 720p. Задайте ваш ключ в WAN_API_KEY на сервере. Отправьте запрос один раз и сохраните полученный id.

curl https://api.wanapi.app/v1/videos \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.5",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "720p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true
}'

Проверка задачи Seedance 2.5Копировать ссылку на заголовок

Сохраните полученный id как TASK_ID, затем проверяйте статус с тем же ключом. Отправка возвращает подтверждение задачи; видео доступно после завершения. Начните с опроса каждые пять секунд; см. статусы задач и скачивание.

curl "https://api.wanapi.app/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $WAN_API_KEY"

Цены Seedance 2.5Копировать ссылку на заголовок

Тарифы указаны в USD за один миллион видеотокенов. Итоговая стоимость зависит от входных и выходных видеотокенов. На расход влияют разрешение, длительность и референсные видео; используйте тариф для запросов с референсным видео или без него. Отдельного тарифа для аудио нет.

Цены и оценки Seedance 2.5. Проверьте оценку в Playground перед отправкой.

Поля запросаКопировать ссылку на заголовок

Передайте объект JSON. Для новой сцены обязательны model и непустой промпт либо хотя бы один медиафайл; остальные поля необязательны. Для финального рендера передайте только model, draftTaskId и resolution: "1080p" (необязательно n: 1 и параметры финального рендера в providerOptions.bytedance). Неизвестные поля отклоняются.

Параметры провайдераКопировать ссылку на заголовок

Поместите эти нативные параметры в providerOptions.bytedance. Для пропущенных параметров используются указанные значения по умолчанию. Финальный рендер из draftTaskId принимает только output_format, watermark, return_last_frame, execution_expires_after, priority, safety_identifier, service_tier и совпадающий content_filter.

Сочетания входных данных и ограничения медиаКопировать ссылку на заголовок

• Используйте image для первого кадра или frameImages для первого и необязательного последнего кадра. Последний кадр без первого и повторяющиеся типы кадров отклоняются.

• Кадры нельзя сочетать с inputReferences или providerOptions.bytedance.referenceAudio.

• Режим референсов принимает до 30 изображений, 10 видео и 10 аудиоклипов, всего не более 50 референсов.

• Для кадров требуется aspectRatio: "adaptive". Референсное аудио можно использовать без изображения или видео.

• Медиаданные должны быть общедоступными URL HTTP(S). Загрузка байтов и URL с учётными данными не принимаются.

• Изображения: JPEG, PNG, WebP, BMP, TIFF или GIF, HEIC или HEIF; менее 30 MB; каждая сторона 300–6000 пикселей; соотношение сторон 0.4–2.5.

• Видео: MP4 или MOV; не более 200 MB на файл; каждый клип 2–30 секунд, суммарно не более 30 секунд; 300–6000 пикселей на сторону, соотношение сторон 0.4–2.5, 24–60 fps.

• Аудио: MP3 или WAV; не более 15 MB на файл; каждый клип 2–30 секунд, суммарно не более 30 секунд.

• Размер, кодировка и длительность удалённых медиа проверяются при обработке; проверка URL сама по себе не гарантирует пригодность файла.

• Используйте draftTaskId для рендера завершённого черновика в 1080p. Нативные параметры задачи указываются в providerOptions.bytedance; другие нативные поля не принимаются.

Примеры кадров и референсовКопировать ссылку на заголовок

Отправьте эти тела запроса в тот же эндпоинт POST /v1/videos. Перед отправкой замените каждый URL example.com своим URL с прямым доступом к медиа. Сохраняйте доступность входных URL до завершения задачи.

Первый и последний кадрыКопировать ссылку на заголовок

Для одного первого кадра используйте image: "https://example.com/first-frame.jpg" и не указывайте frameImages. Чтобы задать оба крайних кадра клипа, используйте:

{
  "model": "bytedance/seedance-2.5",
  "prompt": "The camera slowly moves from the opening scene to the closing scene.",
  "frameImages": [
    {
      "frameType": "first_frame",
      "image": "https://example.com/first-frame.jpg"
    },
    {
      "frameType": "last_frame",
      "image": "https://example.com/last-frame.jpg"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": 4
}

Референсы изображений, видео и аудиоКопировать ссылку на заголовок

Поместите изображения и видео в inputReferences, явно указав MIME-тип. URL аудио поместите в providerOptions.bytedance.referenceAudio. Не добавляйте кадры в этот запрос.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "Use the character from the image and the camera movement from the video.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/character.jpg",
      "mediaType": "image/jpeg"
    },
    {
      "type": "url",
      "url": "https://example.com/motion.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "providerOptions": {
    "bytedance": {
      "referenceAudio": [
        "https://example.com/sound.wav"
      ]
    }
  },
  "resolution": "720p",
  "duration": 4
}

Редактирование или продление референсного видеоКопировать ссылку на заголовок

Задайте providerOptions.bytedance.omni_reference_task_type как edit или extend и укажите хотя бы одно референсное видео. Для обоих режимов требуется aspectRatio: "adaptive"; для edit также требуется duration: -1.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "Replace the sky with a sunset. Keep the camera movement.",
  "inputReferences": [
    {
      "type": "url",
      "url": "https://example.com/source.mp4",
      "mediaType": "video/mp4"
    }
  ],
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "duration": -1,
  "providerOptions": {
    "bytedance": {
      "omni_reference_task_type": "edit"
    }
  }
}

Предпросмотр черновикаКопировать ссылку на заголовок

Используйте providerOptions.bytedance.draft: true с resolution: "480p" для создания черновика. Для черновика действует обычный тариф 480p за токены. После завершения используйте его публичный идентификатор задачи для отдельного финального рендера в 1080p.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "A paper boat floats through a sunlit stream. Slow tracking shot.",
  "resolution": "480p",
  "aspectRatio": "16:9",
  "duration": 4,
  "generateAudio": true,
  "providerOptions": {
    "bytedance": {
      "draft": true
    }
  }
}

Рендер черновика в 1080pКопировать ссылку на заголовок

Отправьте это тело в POST /v1/videos, указав публичный идентификатор task_… завершённого черновика. Черновик должен принадлежать вашему аккаунту, использовать те же модель и канал и быть создан менее 7 дней назад. Этот нативный срок жизни черновика не связан со сроком хранения видео.

{
  "model": "bytedance/seedance-2.5",
  "draftTaskId": "task_YOUR_COMPLETED_DRAFT",
  "resolution": "1080p"
}

Не передавайте повторно prompt, медиа, duration, aspectRatio, generateAudio, fps, draft, referenceAudio или omni_reference_task_type. Эти настройки берутся из черновика. В providerOptions.bytedance можно задать output_format, watermark, return_last_frame, execution_expires_after, priority, safety_identifier и service_tier. Значение content_filter наследуется из черновика; если вы передаёте его, оно должно совпадать. API возвращает новый идентификатор задачи; опрашивайте GET /v1/videos/{new_task_id} для получения финального видео и его URL Bunny.

Финальный рендер оплачивается отдельно по текущему тарифу 1080p и категории референсного видео исходного черновика, с учётом фактических токенов результата. Опрос не повторяет генерацию и не вызывает повторное списание. Если результат отправки неизвестен, не отправляйте запрос повторно автоматически.

Вывод MOVКопировать ссылку на заголовок

Задайте providerOptions.bytedance.output_format как mov для MOV или mp4 для MP4 (по умолчанию). Этот параметр работает для новой сцены и финального рендера из черновика.

{
  "model": "bytedance/seedance-2.5",
  "prompt": "A red ball on a plain table. Static camera.",
  "resolution": "480p",
  "duration": 4,
  "providerOptions": {
    "bytedance": {
      "output_format": "mov"
    }
  }
}

После завершения videos[0].url содержит подписанный URL Bunny исходного файла .mov, а videos[0].mediaType — video/quicktime. MOV не преобразуется в MP4. Воспроизведение в браузере зависит от поддержки кодека; скачайте файл, если браузер не может его воспроизвести. Файлы загружаются в Bunny; в базе данных хранятся только ссылки на файлы и метаданные задач. Медиа в Base64 не принимаются.

Проверка статуса и скачивание видеоКопировать ссылку на заголовок

Принятая задача возвращает подобный объект. Идентификаторы и временные метки приведены для примера:

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1792022400
}

Опрашивайте GET /v1/videos/{task_id} с вашим ключом API. Ответ содержит тот же публичный идентификатор задачи и модель. Определяйте момент окончания опроса по status; progress не является оценкой оставшегося времени.

Ответ завершённой задачи содержит videos — массив объектов с url и mediaType. Временные метки указаны в секундах Unix; completed_at появляется при регистрации завершения.

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "completed",
  "progress": 100,
  "created_at": 1792022400,
  "completed_at": 1792022460,
  "videos": [
    {
      "url": "/v1/tasks/task_EXAMPLE/artifacts/video/content",
      "mediaType": "video/mp4"
    }
  ]
}

При providerOptions.bytedance.return_last_frame: true завершённая задача также содержит lastFrame — объект с url и mediaType (image/jpeg).

Если полученный URL является относительным путём, дополните его относительно https://api.wanapi.app и авторизуйтесь вашим ключом API. Для примера выше:

curl "https://api.wanapi.app/v1/tasks/$TASK_ID/artifacts/video/content" \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -o video.mp4

Если возвращён подписанный HTTPS URL медиа, используйте его напрямую, не передавая ключ API этому хосту. Срок действия URL может истечь. Сохраняйте нужные видео в собственном хранилище. Опрос и скачивание готового результата не создают новую генерацию.

Неудачная задача содержит объект error с code и message, например:

{
  "id": "task_EXAMPLE",
  "object": "video",
  "model": "bytedance/seedance-2.5",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "Video generation failed"
  }
}

Оплата и обработка ошибокКопировать ссылку на заголовок

Итоговое списание определяется фактическим расходом видеотокенов и текущим тарифом модели. Оценка Playground — максимальная оценка, а не фиксированная цена. Более длинные клипы и высокое разрешение могут увеличить расход токенов. Неудачные запросы не оплачиваются.

• Неверные параметры: исправьте поля или сочетание входных данных перед повторной отправкой. Проверьте форматы и ограничения медиа, а также синтаксис URL.
• Авторизация или доступ к модели: используйте действительный ключ API.
• Недостаточный баланс: пополните счёт перед новым платным запросом. Лимит ключа не пополняет баланс аккаунта.
• Временная ошибка опроса: повторите GET с увеличивающимися интервалами и предельным временем ожидания. Ошибка запроса статуса не означает ошибку генерации.
• Тайм-аут отправки или отсутствие идентификатора задачи: результат может быть неизвестен. Не повторяйте POST автоматически: это может создать вторую платную задачу.
• Ошибка скачивания: повторите скачивание существующего результата перед новой генерацией.

Сохраните идентификатор задачи и обратитесь в поддержку, если нужно выяснить результат отправки.

Скачать схему OpenAPI для Seedance 2.5.