Seedance 2.5 API: ендпоінт, параметри й реальна тарифікація
Seedance 2.5 API асинхронний, тарифікується за секунду і має три правила оплати, на яких люди спотикаються. Усе, що потрібно знати до першого виклику.
Від $0.07 за секунду, 480p з референсним кліпом
Що дає Seedance 2.5 API
Один POST створює завдання, один GET його опитує, і опитування безкоштовне. Seedance 2.5 API визначає режим за тим, які медіаполя ти заповнив, а не за окремим параметром.
Сам лише prompt — це text-to-video. Додай зображення — і Seedance 2.5 API виконає image-to-video. Додай перший і останній кадр — і він анімує перехід. Додай вихідний кліп — і він відредагує або продовжить його.
POST одразу повертає id завдання, а генерація триває дві-пʼять хвилин. Інтеграція Seedance 2.5 API потребує циклу опитування або черги, а не синхронного запиту.
Платформа віддає її як doubao-seedance-2.5-face. Помилка в рядку моделі Seedance 2.5 API — найчастіша причина збою першого виклику, і вона повертає синхронну помилку, а не списання.
Один заголовок, область — робочий простір, без id проєкту. Ключ Seedance 2.5 API несе платіжну область того робочого простору, який його видав.
Кожне невдале завдання повертає кредити повністю, зокрема й відмови модерації. Seedance 2.5 API ніколи не бере грошей за рендер, якого ти не отримав.
Генератора на цій сторінці немає. Виклики Seedance 2.5 API виконуються на хостованому API, а кожен параметр і тариф нижче взято з його опублікованої документації.
Найважливіші параметри Seedance 2.5 API
Чотири поля, що визначають вартість і результат.
duration
Від чотирьох до тридцяти секунд, за замовчуванням пʼять. Значення -1 дозволяє моделі обрати самій, але Seedance 2.5 API резервує кредити за стелею у 30 секунд і повертає різницю, що на тонкому балансі може викликати 402.
resolution
480p, 720p або 1080p, за замовчуванням 720p. У Seedance 2.5 API немає 4K, і запит на нього повертає помилку, а не знижений за якістю кліп.
content_filter
Логічне значення, за замовчуванням true. False спрямовує запит Seedance 2.5 API у менш суворий канал і робить prompt обовʼязковим. Платформа документує це як маршрутизацію, а не як вимикач.
omni_reference_task_type
Оголоси edit або extend — і Seedance 2.5 API перевірить правила під час відправлення, а не завалить завдання за кілька хвилин. Варто вказувати в будь-якому завданні з референсами.
Чотири кроки до робочого виклику Seedance 2.5 API
- 1
Створи ключ
Згенеруй його в панелі платформи і надсилай як bearer-токен. Seedance 2.5 API відхиляє будь-що інше в заголовку авторизації.
- 2
Відправ завдання через POST
Надішли модель, prompt і будь-які URL медіа на ендпоінт генерації відео. Кожне медіаполе Seedance 2.5 API приймає публічні HTTP або HTTPS URL, base64 відхиляється по всій платформі.
- 3
Опитуй завдання
Роби GET за id завдання, доки статус не стане completed або failed. Опитування Seedance 2.5 API не коштує нічого, тож інтервал у дві секунди цілком нормальний.
- 4
Прочитай результат
Завершене завдання Seedance 2.5 API несе URL відео, а також URL останнього кадру, якщо ти його замовляв. Перезалий усе, що потрібно зберегти, бо видані URL не вічні.
Seedance 2.5 API: відповіді
За секунду оплачуваного відео — від $0.071153 до $0.461856 залежно від роздільності та від того, чи ніс запит референсний кліп. Десятисекундний рендер у 1080p — приблизно $4.62. Референсні зображення та референсне аудіо не додають до рахунку нічого.
Тривалість результату плюс повна тривалість будь-якого референсного відео, причому будь-який запит із відео оплачується щонайменше за пʼять третин тривалості результату. Двосекундне джерело з пʼятисекундним результатом дасть рахунок на девʼять секунд, а не на сім, і це дивує більшість перших інтеграцій.
doubao-seedance-2.5-face на хостованому API. Старіші гайди наводять doubao-seedance-2.5 без суфікса — це версія до запуску, і вона не резолвиться. Звіряйся зі сторінкою моделі, а не з прикладом коду.
Опитування статусу — задокументований шлях, і воно безкоштовне, тож цикл із коротким інтервалом — найпростіша інтеграція Seedance 2.5 API. Оскільки генерація триває дві-пʼять хвилин, опитування раз на дві-пʼять секунд не створює помітного навантаження і не потребує інфраструктури зворотних викликів.
Це валідація схеми, і нічого не тарифікувалося. Типові причини — недопустима роздільність, значення розміру в поєднанні з першим або останнім кадром чи відсутній prompt у запиті text-to-video. Помилка називає поле, яке спричинило збій.
Або правило типу завдання, або модерація. Помилка 80006 — це відмова з міркувань безпеки, і вона не називає етап. Невідповідність параметрів у завданні редагування дає інший збій, а оголошення omni_reference_task_type наступного разу перетворює його на негайну 400.
До 30 зображень, 10 відеокліпів сумарно на 30 секунд і 10 аудіодоріжок. Масив зображень і масив зображень із ролями взаємно виключні, тож обирай щось одне на кожен запит Seedance 2.5 API.
Так, на тому самому ендпоінті з іншим ідентифікатором моделі. Seedance 2.0 обмежений 15 секундами, тоді як 2.5 сягає 30, а форма запиту достатньо близька, щоб зміна версії зводилася переважно до заміни рядка.
Ключ несе платіжну область того робочого простору, який його видав, окремого заголовка проєкту немає. Команди, яким потрібен роздільний облік, створюють окремі робочі простори, а не окремі ключі всередині одного, бо споживання агрегується на рівні робочого простору.
Почни з документації Seedance 2.5 API
Опубліковані параметри, актуальні тарифи за секунду, безкоштовне опитування статусу й автоматичне повернення коштів за невдалу генерацію.
Повʼязане: Seedance 2.5 API