Як користуватися Seedance 2.5 | Поля, ліміти, оплата
Як користуватися Seedance 2.5 через API платформи: усі поля запиту та їхні ліміти, правила референсів, цикл опитування, оплачувані секунди й помилка 80006.
Знати, як користуватися Seedance 2.5, — це здебільшого знати форму її запиту. Один виклик несе промпт, чотири налаштування виводу і до трьох видів референсних матеріалів; платформа повертає ID завдання; готове відео забирається опитуванням. Механіка, що відрізняється від старої версії, — це стеля в 30 секунд, розмір бюджету на референси й правило тарифікації, через яке референсне відео коштує більше, ніж підказує таблиця тарифів.
Спершу переконайся, що ти на 2.5
Кілька хостерів лишили Seedance 2.0 за замовчуванням, коли додали 2.5 поруч, тож те, що ти отримаєш, вирішує рядок моделі. Випущена збірка 2.5 віддається під ідентифікатором, що закінчується на -face. Старі приклади коду цитують ідентифікатор без цього суфікса, і він більше не резолвиться.
Друга перевірка не потребує ревʼю коду. Надішли запит на 20-секундну генерацію. На 2.0 його відхилять на полі тривалості, ще до того, як завдання існує, тож нічого не спишеться.
Як користуватися Seedance 2.5 через API платформи
Запит на генерацію приймає такі поля.
| Поле | Діапазон | За замовчуванням |
|---|---|---|
prompt | до 20,000 символів | немає |
duration | від 4 до 30 секунд або -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true або false | true |
content_filter | true або false | true |
Промпт обовʼязковий для генерації відео з тексту і необовʼязковий, щойно присутні референсні матеріали. Репліки в лапках усередині нього генеруються як мовлення, у тому самому проході, що й зображення, у вигляді моно-доріжки, яка покриває діалоги, ефекти й музику.
Виставлення duration у -1 віддає рішення про тривалість моделі. Резерв береться за стелею в 30 секунд, тож закладай бюджет на повнометражний кліп, коли цим користуєшся.
Окрім цього, запит відкриває output_format для mp4 або mov, а також bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type і масив tools. return_last_frame — це поле, що має значення для склеювання ланцюжків, бо останній кадр однієї генерації є тим, що засіює наступну.
Правила щодо референсних матеріалів, які відхиляють запит
Валідація референсних матеріалів сувора і спрацьовує до створення завдання, що робить відхилення безкоштовним, але й дає легко впиратися в нього знову і знову.
- Зображення: до 30 на запит, jpeg, png, webp, bmp, tiff, gif, heic або heif, до 30 MB кожне.
- Відео: до 10 кліпів, mp4 або mov, 200 MB або менше кожен, від 2 до 30 секунд кожен, 30 секунд сумарно.
- Аудіо: до 10 доріжок, wav або mp3, 15 MB або менше кожна, від 2 до 30 секунд кожна, 30 секунд сумарно.
Кожне з цього — публічне HTTP(S)-посилання. Data URI відхиляються на всій платформі, тож спершу розмісти файл.
Референсні зображення й аудіо нічого не додають до рахунку. Референсне відео додає, і двома способами — про це наступний розділ.
Як порахувати рахунок до надсилання
Тарифікація йде за секунду готового відео за тарифом, що залежить від роздільної здатності й від того, чи прикріплено референсне відео.
| Роздільна здатність | Лише генерація | З референсним відео |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Оплачувані секунди — це більше з двох чисел: тривалість референсного відео, округлена вгору, плюс вихідна тривалість, або пʼять третин вихідної тривалості, округлені вгору.
Два пораховані приклади показують, чому це важливо.
Десятисекундна генерація в 1080p без референсного кліпу тарифікується як десять секунд по $0.461856, тобто приблизно $4.62.
Той самий десятисекундний вихід у 1080p із шестисекундним референсним кліпом тарифікується як більше з 16 і 17 секунд, тобто 17 секунд по $0.275904, тобто приблизно $4.69. Нижчий тариф компенсується мінімумом.
Менше завдання показує ефект різкіше. Пʼятисекундний вихід у 720p із трисекундним референсним кліпом тарифікується як девʼять секунд, а не вісім, і виходить приблизно $1.44, тоді як ті самі пʼять секунд, згенеровані з нуля, — трохи більше за $1.33.
Опитування, час і повернення коштів
Завдання асинхронне. Надсилання повертає ID завдання, а відео забирається опитуванням цього завдання, доки воно не повідомить про завершення.
Генерація в середньому займає дві-пʼять хвилин. Опитування безкоштовне, тож фіксований інтервал у пʼятнадцять-двадцять секунд — розумно, і немає сенсу агресивно збільшувати паузи.
За невдалі завдання кошти повертаються повністю. Цифри використання невдалого завдання показують, чи повернулася зарезервована сума, і це варто перевіряти, коли пакет завдань повівся дивно.
Як читати відмову
Відмови з міркувань безпеки повертають помилку 80006. Помилка не називає етап, що спрацював, тож причиною може бути промпт, референсний файл або згенерований результат.
Почни з промпту. Названі реальні знаменитості, чужа інтелектуальна власність і незаконний контент заблоковані всередині моделі, і жодне налаштування хостера їх не прибирає. Далі перевір референсні зображення, бо обличчя чи логотип на наданій фотографії може дати той самий результат, що й називання їх словами.
content_filter за замовчуванням має значення true. Виставлення його в false скеровує запит менш обмежувальним каналом і не вимикає модерацію. Це елемент керування маршрутизацією, а не вимикач, і старий псевдонім nsfw_checker досі проходить валідацію.
Поширені запитання
Який рядок моделі викликати для Seedance 2.5?
Випущена збірка несе ідентифікатор, що закінчується на -face. Ідентифікатори без цього суфікса походять із передрелізних прикладів і більше не резолвляться.
Як згенерувати кліп, довший за 30 секунд?
Склеюванням генерацій у ланцюжок. Тридцять секунд — стеля на один запит, тож довші матеріали є окремими завданнями, склеєними в монтажці, а return_last_frame дає чисту точку передачі.
Чому референсне відео коштувало більше, ніж підказувала таблиця тарифів? Референсний кліп тарифікується за власною тривалістю понад результат, а запит ніколи не тарифікується менше ніж за пʼять третин вихідної тривалості, округлені вгору. Більше з двох чисел і стає оплачуваними секундами.
Чи пропускає все вимкнення контентного фільтра?
Ні. Виставлення content_filter у false обирає менш обмежувальний канал, і модерація все одно діє. Блоки на рівні моделі на реальних знаменитостей, чужу інтелектуальну власність і незаконний контент лишаються на місці в будь-якому разі.
Коротко
Як користуватися Seedance 2.5 по порядку: перевір рядок моделі з -face, виставляй тривалість між 4 і 30 секундами, обери роздільну здатність і співвідношення сторін, лиши аудіо увімкненим, якщо не хочеш тиші, прикріплюй референсні зображення вільно, бо вони безкоштовні, надсилай, а потім опитуй кожні пʼятнадцять секунд протягом двох-пʼяти хвилин. Рахуй завдання за оплачуваними секундами, а не за вихідними, щоразу, коли задіяне референсне відео, і стався до помилки 80006 як до повернення коштів плюс переписування.
