Перейти до документації
На цій сторінці

Seedance 2.5 Flash

Генеруйте відео за допомогою Seedance 2.5 Flash, використовуючи текст, перший та останній кадри або мультимодальні референси. На цій сторінці описано повний робочий процес від запиту до результату для цієї моделі.

ID моделі в API: seedance-2-5-flash

Генерація виконується асинхронно. Збережіть taskId, отриманий під час створення завдання, а потім перевіряйте його статус або налаштуйте отримання вебхуку.

Можливості

Seedance 2.5 Flash підтримує роздільну здатність 480p та 720p (720p за замовчуванням). Модель не підтримує 1080p, 4k, прев’ю-чернетки та фіналізацію чернеток.
ФункціяДопустимі значення
Роздільна здатність відео480p · 720p
Тривалість відео4–30 секунд
Співвідношення сторін16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Референсні зображенняДо 30 зображень
Референсні відеоДо 10 відео
Референсні аудіофайлиДо 10 аудіофайлів
Усі референси разомЗагалом до 50 допоміжних файлів
Загальна тривалість на групу відео/аудіо30 секунд
seed-1 до 2147483647
Також підтримується значення duration=-1 у режимі генерації за референсом; див. деталі щодо редагування відео та тарифікації нижче. Режим image-to-video приймає лише значення adaptive; опустіть це поле або встановіть для нього adaptive.

Тарифи та кредити

Оплата за генерацію відео здійснюється в кредитах відповідно до тарифікованої тривалості в секундах. Якщо вихідне відео не завантажувалося, тарифікується лише тривалість створеного відео. Якщо вихідне відео використовувалося, до тарифікованого часу також додається тривалість референсного відео.

У таблиці нижче наведено тарифи в кредитах за секунду, а не повну вартість завдання. Тариф залежить від моделі, роздільної здатності створеного відео, а також використання референсних відео в режимі «відео за референсом». Формули та приклади розрахунку повної вартості наведено під таблицею.

Роздільна здатність відеоБез референсного відеоЗ референсним відео
480p7 кред./с5 кред./с
720p10 кред./с7 кред./с
  • Без референсного відео: тривалість готового відео в секундах × тариф без відео.
  • З референсним відео: (тривалість готового відео + фактична тривалість референсного відео в секундах) × тариф із відео. Сервер вимірює загальну тривалість референсного відео та округлює її в більшу сторону до цілих секунд перед списанням.
  • Використання лише зображень або аудіо як референсів тарифікується за тарифом без відео. Тариф із відео застосовується лише в режимі генерації за референсом, якщо вхідні дані містять референсні відео.

Приклади розрахунку вартості

Текст у відео (5 секунд, 720p): 5 × 10 = 50 кредитів.

Готове відео 5 секунд (720p) із референсним відео тривалістю 5 секунд: (5 + 5) × 7 = 70 кредитів.

Ці кредити списуються авансом під час створення завдання. Якщо завдання виконано успішно, ця сума є остаточною; вона не збільшується і не повертається частково залежно від фактичної тривалості готового відео. У разі збою або перевищення ліміту часу очікування запускається процес повернення коштів.

Кредити резервуються під час надсилання запиту і списуються у разі успіху. Завдання, що завершилися помилкою або скасовані через таймаут, повертають кредити на баланс. Статус billing_status зі значенням refund_failed означає, що повернення не завершилося; перевірте логи API або зверніться до підтримки.

Як списуються кредити, якщо duration=-1

Якщо тривалість установлена на -1, фінальний хронометраж відео не буде фіксованим — його визначить модель.

У більшості випадків краще вказати конкретну потрібну тривалість відео замість значення -1. Рекомендуємо використовувати -1 лише для монтажу відео й уникати цього в інших сценаріях генерації.

Вхідні файли для порівнянняЯк розраховується вартістьПриклад
З референсними відеоТривалість усіх референсних відео додається й округляється в більшу сторону до найближчої цілої секунди (позначимо як T). Вартість становить (T + T) × тариф для відео: одна T — це очікувана тривалість готового відео, а інша — тривалість вхідного відео.720p із референсним відео тривалістю 5 секунд: (5 + 5) × 7 = 70 кр.
Без референсних відео (лише зображення або аудіо)Очікувана тривалість готового відео приймається за 30 секунд. Вартість становить 30 × тариф без відео.720p без референсних відео: 30 × 10 = 300 кр.

Автентифікація

Створіть ключ API у панелі керування. Повний ключ відображається лише один раз. Зберігайте його на своєму сервері та надсилайте як Bearer-токен у кожному запиті.

Базовий URL

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Задайте змінну середовища SEEVIO_API_KEY перед запуском цих прикладів. Приклади на JavaScript виконуються на вашому сервері за допомогою Node.js; приклади на Python використовують бібліотеку requests.

Швидкий старт

Надішліть цей мінімальний запит, збережіть отриманий taskId, а потім використайте приклад запиту статусу, наведений нижче. Значення credits у відповіді на створення — це зарезервована сума кредитів.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Приклад відповіді на запит створення завдання

Після успішного прийняття запиту API повертає таку відповідь у форматі JSON. Параметр taskId — це унікальний ідентифікатор завдання, який використовується для подальшої перевірки статусу; credits — це кількість кредитів, зарезервованих для виконання цього завдання. Ця відповідь лише підтверджує створення завдання, але не означає, що відео вже готове. Щоб отримати готовий відеоролик, потрібно періодично опитувати статус завдання або налаштувати Webhook.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Створення завдання

POST https://api.seevio.ai/v1/videos/generations

Надішліть об'єкт JSON, що містить model та input, а також необов'язкове поле callback_url. Завжди вказуйте ID моделі, зазначений на цій сторінці; якщо модель не вказано, автоматично вибирається seedance-2-0.

Тіло запиту

ПолеТипОбов’язковоОпис та обмеження
model
stringТак

Ідентифікатор моделі. Щоб використовувати Seedance 2.5 Flash, установіть для цього поля значення seedance-2-5-flash.

callback_url
stringНі

Публічна адреса HTTPS для отримання POST-запитів про завершення роботи або помилку. Приватні мережі та localhost не підтримуються.

Приклад: https://example.com/webhooks/seevio
input
objectТак

Налаштування генерації. Має містити непусті вказівки (prompt).

Вхідні параметри

Поле image_urls є обов’язковим для image-to-video. Для reference-to-video потрібен принаймні один референс серед image_urls, video_urls або audio_urls.

Укажіть image_urls, video_urls та audio_urls у вигляді масивів рядків URL (string[]). Кожна надана URL-адреса має бути загальнодоступною через протокол HTTPS, включно з медіафайлами, які ігноруються у вибраному режимі.

ПолеТипОбов’язковоЗа замовчуваннямОпис та обмеження
input.prompt
stringТак—

Для кожного режиму обов’язково потрібно вказати промпт. Він має містити щонайбільше 10000 символів (без урахування пробілів на початку й у кінці) і не може складатися лише з пробілів.

Приклад: A cat surfing at sunset
input.generation_type
stringНіtext-to-video
Допустимі значення
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video або reference-to-video. Якщо параметр опущено, за замовчуванням використовується text-to-video і застосовується лише текстовий опис. Режим image-to-video використовує 1–2 впорядковані кадри-зображення. Режим reference-to-video використовує зображення, відео та/або аудіо; референси, які складаються лише з аудіо, підтримуються з обов’язковим текстовим описом.

input.image_urls
string[]Залежно від умов[]

Надайте URL зображень для визначення візуального стилю. У режимі image-to-video надайте 1 зображення для першого кадру або 2 зображення у порядку «перший кадр, останній кадр». У режимі reference-to-video надайте не більше ніж 30 зображень. Кожне зображення має бути меншим за 30 МБ; вимоги до форматів та розмірів дивіться нижче у медіавимогах. Для всіх типів референсів сумарно допускається не більше 50 файлів. Якщо параметр опущено, використовується []; ігнорується у режимі text-to-video.

Приклад: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]Залежно від умов[]

Надайте URL референсних відео для визначення руху, редагування або продовження відео (лише в режимі reference-to-video). Допускається не більше 10 файлів розміром до 100 МБ і тривалістю 2–30 секунд кожен; їхня загальна тривалість не повинна перевищувати 30 секунд. Для всіх типів референсів сумарно допускається не більше 50 файлів. Сервер вимірює тривалість відео для тарифікації. Якщо параметр опущено, використовується []; ігнорується в інших режимах.

Приклад: ["https://example.com/source.mp4"]
input.audio_urls
string[]Залежно від умов[]

Надайте URL референсних аудіофайлів для визначення звуку (лише в режимі reference-to-video). Допускається не більше 10 файлів MP3/WAV розміром до 15 МБ і тривалістю 2–30 секунд кожен; їхня загальна тривалість не повинна перевищувати 30 секунд. Для всіх типів референсів сумарно допускається не більше 50 файлів. Аудіо може бути єдиним типом референсу; текстовий опис залишається обов’язковим. Якщо параметр опущено, використовується []; ігнорується в інших режимах.

Приклад: ["https://example.com/music.mp3"]
input.duration
integerНі5
Допустимі значення
-1 | 4–30

Ціле число тривалості готового відео від 4 до 30 секунд. Також приймає значення -1 тільки в режимі reference-to-video. Використовуйте його з вихідним відео для редагування; тарифікація здійснюється за особливим правилом, описаним вище.

Приклад: 5
input.aspect_ratio
stringНіadaptive
Допустимі значення
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 або adaptive. Якщо параметр опущено, за замовчуванням використовується adaptive — у цьому разі модель сама визначає пропорції на виході. Для редагування або продовження відео використовуйте adaptive. Режим image-to-video приймає лише значення adaptive; опустіть це поле або встановіть для нього adaptive.

Приклад: adaptive
input.resolution
stringНі720p
Допустимі значення
480p | 720p

480p або 720p. Якщо параметр опущено, за замовчуванням використовується 720p для всіх підтримуваних режимів генерації. Вища роздільна здатність відхиляється.

Приклад: 720p
input.generate_audio
booleanНіtrue
Допустимі значення
true | false

Значення true запитує генерацію синхронізованого звуку; false вимикає генерацію звуку. Якщо параметр опущено, за замовчуванням використовується true. Застосовується до всіх підтримуваних режимів генерації.

Приклад: true
input.watermark
booleanНіfalse
Допустимі значення
true | false

Значення true запитує додавання водяного знака ШІ на вихідне відео; false запитує відео без водяного знака. Якщо параметр опущено, за замовчуванням використовується false. Застосовується до всіх підтримуваних режимів генерації.

Приклад: false
input.web_search
booleanНіfalse
Допустимі значення
true | false

Значення true дозволяє пошук в інтернеті, якщо це підтримується моделлю; false вимикає пошук. Якщо параметр опущено, за замовчуванням використовується false. Увімкнення цього параметра не гарантує, що пошук буде виконано обов’язково.

Приклад: false
input.return_last_frame
booleanНіfalse
Допустимі значення
true | false

Значення true запитує фінальний кадр згенерованого відео; false скасовує цей запит. Якщо параметр опущено, за замовчуванням використовується false. Застосовується до всіх підтримуваних режимів генерації. Якщо кадр запрошено і він доступний, посилання повертається у data.last_frame_url, інакше повертається null.

Приклад: true
input.seed
integerНі—
Допустимі значення
-1 до 2147483647

Ціле число від -1 до 2147483647. Значення -1 вибирає випадковий seed.

Приклад: 42
input.output_format
stringНіmp4
Допустимі значення
mp4 | mov

mp4 або mov. Якщо параметр опущено, за замовчуванням використовується mp4. Визначає формат вихідного контейнера в усіх підтримуваних режимах генерації.

Логічні поля мають містити JSON-значення true або false, а не рядки чи числа.

Відповідь на створення

HTTP 200 повертає taskId (рядок) та credits (число). Це підтверджує створення завдання, але не його завершення. Значення нижче відповідає 5-секундному відео 720p зі швидкого старту.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Режими генерації та приклади

Замініть адреси медіафайлів example.com на власні загальнодоступні HTTPS-файли. Приклади URL-адрес наведено лише для ілюстрації структури запиту, вони не є тестовими файлами для завантаження.

Текст у відео

Генерація з текстової підказки. Посилання на медіафайли в цьому режимі не обробляються.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Перший кадр

Передайте одне зображення як перший кадр, а потім опишіть рух у текстовому prompt.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Перший та останній кадри

Передайте два URL-посилання на зображення по порядку: спочатку перший кадр, потім останній. Цей приклад також запитує останній кадр готового відео.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Мультимодальні референси

Комбінуйте зображення, відео та аудіореференси. Текстовий prompt залишається обов’язковим. Вхідне референсне відео змінює формулу розрахунку вартості.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Аудіореференс

Використовуйте аудіо як єдиний тип референсу разом із обов’язковим текстовим описом бажаного відео.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Редагування відео

Для редагування відео в Seedance 2.5 Flash параметр duration має бути встановлений на -1, а aspect_ratio — на adaptive. Обидва налаштування є обов'язковими, інакше створити відео не вдасться.

Опишіть зміни та надайте вихідне відео. Встановіть duration=-1 і виберіть adaptive для співвідношення сторін. Для цього процесу використовуйте вихідний кліп тривалістю не менше 4 секунд. Правило тарифікації для duration=-1 наведено вище.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Продовження відео

Для розширення відео Seedance 2.5 Flash параметр aspect_ratio має бути встановлений як adaptive, інакше генерація може завершитися помилкою. Задайте тривалість (duration) як зазвичай відповідно до бажаної довжини вихідного відео в межах підтримуваного діапазону; значення -1 використовувати не потрібно.

Опишіть, як має продовжуватися вихідне відео. Використовуйте адаптивне співвідношення сторін (adaptive) і встановіть звичайну тривалість у межах лімітів моделі.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Запит статусу завдання

GET https://api.seevio.ai/v1/tasks/{taskId}

Замініть ID з прикладу на taskId, отриманий під час створення. Запити повертають лише ті завдання, які належать користувачеві ключа API; до невідомих або недоступних ID повертається помилка HTTP 404.

Для початку опитуйте статус кожні 10–20 секунд, за умов помилки HTTP 429 збільшуйте інтервал і зупиняйтеся, коли статус зміниться на completed або failed. Для продакшену краще використовувати вебхуки. Кожен приклад коду нижче виконує один запит.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
СтатусОпис та обмеження
queuedПрийнято й очікує на запуск.
generatingГенерація триває.
completedУспішно завершено. Завантажте файли з data.results до закінчення терміну дії.
failedПомилка виконання. Перевірте failed_reason та billing_status.
ПолеТипОпис та обмеження
idstring
Ідентифікатор завдання. Це taskId з відповіді на створення.
created_atnumber
Час створення завдання в секундах Unix.
modelstring
Публічний ID моделі, використаний для цього завдання.
billing_statusstring
Статус оплати: reserved, charged, refunded або refund_failed.
creditsnumber
Кредити, зарезервовані для цього завдання. Це значення зберігається після повернення коштів; перевіряйте billing_status для визначення остаточного статусу розрахунку.
failed_reasonstring | null
Причина помилки для неуспішних завдань; в інших випадках — null. Відповіді на запити для неуспішних завдань не містять об’єкта data.
dataobject
Міститься у запитах успішних завдань. Передає результат та деталі обробки.
data.resultsstring[]
Масив URL-адрес готових відео. Порожній до завершення або після закінчення терміну зберігання відео.
data.video_expires_atstring | null
Термін дії посилання на відео у форматі ISO 8601 або null, якщо воно ще не готове. Збережіть результат до настання цього часу.
data.last_frame_urlstring | null
URL-адреса останнього кадру, якщо він був запрошений і готовий; в іншому випадку — null.
data.processing_timenumber | null
Тривалість обробки завдання в секундах, якщо доступно; в іншому випадку — null.

Завершене завдання: відповідь на запит із результатами відео

Коли запит повертає статус status=completed, це означає, що генерацію відео завершено. Отримайте URL-адреси відео з масиву data.results і завантажте їх до настання часу, вказаного у data.video_expires_at. Значення billing_status=charged вказує на те, що зарезервовані кредити було списано.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Помилка виконання завдання: відповідь на запит із деталями збою та оплати

Коли запит повертає статус status=failed, це означає, що генерація завершилася помилкою. Причину збою вказано в полі failed_reason, а результат повернення коштів — у billing_status. У цьому прикладі статус refunded означає, що кредити було повернено. У полі credits залишається початкова зарезервована сума, а об'єкт data у відповіді відсутній.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

Вебхуки

Вкажіть callback_url у запиті на створення, щоб отримувати POST-запит JSON після успішного виконання або помилки завдання. Поверніть відповідь 2xx протягом 15 секунд. У разі невдалої доставки запити повторюються; налаштуйте ідемпотентну обробку повторних запитів за ID завдання.

Ваша кінцева точка зворотного виклику (callback endpoint) має приймати запити POST із тілом запиту у форматі JSON (Content-Type: application/json).

Створення завдання з вебхуком

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Завдання виконано: дані успішного зворотного виклику

У разі успішної генерації зворотний виклик містить status=completed. Використовуйте id для ідентифікації завдання, а дані з data.results — для отримання посилань на відео. Завантажте та збережіть результати до настання часу, вказаного в data.video_expires_at.

created_at — час створення події, task_created_at — час створення завдання, у секундах Unix. Приклади показують рекомендовані поля; відповідь може містити додаткові поля.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Помилка завдання: дані зворотного виклику про збій

Якщо генерація завершилася збоєм, зворотний виклик містить status=failed. Використовуйте id для ідентифікації завдання, failed_reason для отримання причини збою та credits_refunded для перевірки кількості повернених кредитів.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

Приклад обробника

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Цей приклад для Next.js зчитує тіло зворотного виклику в JSON та безпосередньо обробляє успішно виконані й невдалі завдання. Додайте у свій додаток збереження даних та дедуплікацію за ID завдань; додавайте тривалі процеси в чергу, перш ніж підтверджувати отримання зворотного виклику.

Вимоги до медіафайлів та обмеження

  • Усі URL-адреси медіа та вебхуків мають бути публічними HTTPS-посиланнями. Уникайте localhost, приватних IP-адрес та файлів, що потребують файлів cookie чи авторизації. Посилання на референсні відео/аудіо мають вести безпосередньо на файли.
  • У режимі reference-to-video надайте хоча б один референс. Разом допускається не більше 30 зображень, 10 відео, 10 аудіофайлів та 50 матеріалів загалом. Загальна тривалість відео та аудіо не повинна перевищувати 30 секунд для кожної групи.
  • Режим text-to-video ігнорує всі медіареференси. Режим image-to-video обробляє лише зображення першого/останнього кадру та ігнорує відео та аудіо. Використовуйте reference-to-video для поєднання різних типів медіа.
  • Кожне референсне відео та аудіо має тривати від 2 до 30 секунд. Для прикладів редагування відео використовуйте вихідні кліпи тривалістю не менше 4 секунд.

Вимоги до зображень

  • Розмір кожного зображення не повинен перевищувати 30 МБ.
  • Підтримувані формати: jpeg, png, webp, bmp, tiff, gif.
  • Співвідношення сторін (ширина ÷ висота): від 0,4 до 2,5 включно.
  • Ширина й висота мають бути в межах від 300 до 6 000 пікселів включно.

Вимоги до відео

  • Підтримувані формати: mp4, mov.
  • Розмір кожного відео не повинен перевищувати 100 МБ.
  • Частота кадрів: від 24 до 60 кадрів/с включно.
  • Співвідношення сторін (ширина ÷ висота): від 0,4 до 2,5 включно.
  • Загальна кількість пікселів (ширина × висота): від 407 696 до 8 295 044 включно. Наприклад, 614 × 664 = 407 696 та 3 326 × 2 494 = 8 295 044. Це лише приклади кількості пікселів, а не жорсткі вимоги до ширини й висоти.

Вимоги до аудіо

  • Підтримувані формати: wav, mp3.
  • Розмір кожного аудіофайлу не повинен перевищувати 15 МБ.