Використовуйте doubao-seedance-2-5-flash із POST /ai/v1/videos, перевіряйте стан завдання, а потім завантажте результат. Поточна схема AIHubMix передбачає вивід у 480p/720p, кліпи тривалістю 4–30 секунд і до 10 зображень, 5 відео та 5 аудіофайлів для довідки. Клієнтам зі старою версією, які використовують /v1/videos, потрібно змінити і ендпоінт, і ID моделі.
Цей посібник перевірено 16 листопада 2026 року. І короткий ID вище, і doubao-seedance-2-5-flash-261115 повернули схему моделі та відхилили запит на 1080p із помилкою 400 schema_violation. Окрема спроба створити 4-секундне відео у 480p завершилася помилкою 402 insufficient_quota; відео не було згенеровано. Наведений нижче процес відповідає поточній схемі й документації, але під час цієї перевірки не вдалося наскрізно підтвердити успішну генерацію, затримку, вивід у MOV і редагування.
Передумови та ознайомлення зі схемою
На сторінці моделі Seedance 2.5 Flash модель наведено під коротким ID, який використовується в цьому посібнику. Перш ніж надсилати завдання:
- Увімкніть асинхронні медіазавдання в консолі AIHubMix. Для облікового запису, у якому цю функцію не ввімкнено, в документації вказано помилку
403 async_not_enabled. - Переконайтеся, що API-ключ має доступ, а на рахунку достатньо коштів. Під час перевірки API повернув
402 insufficient_quotaіз повідомленнямYour account has insufficient quota. Add credits and try again. - Експортуйте
AIHUBMIX_API_KEYу своїй оболонці. Не зберігайте ключ у файлах із вихідним кодом і коді браузера. - Отримайте поточну схему; для запиту на її отримання автентифікація не потрібна.
curl --fail-with-body -sS \
'https://aihubmix.com/call/schema/models/doubao-seedance-2-5-flash/endpoints' \
| jq '.endpoints[] | select(.path == "/ai/v1/videos") | .request.schema'
У схемі від 16 листопада для Flash зазначено лише /ai/v1/videos. Допустимі значення resolution — 480p і 720p (за замовчуванням — 720p), а duration має бути цілим числом від 4 до 30 або дорівнювати -1, щоб тривалість вибрала модель. Якщо потрібен передбачуваний бюджет, задайте тривалість явно.
Створення, перевірка стану та завантаження
API генерації відео AIHubMix розділяє створення завдань, запити щодо їхнього стану та завантаження. Успішна відповідь HTTP під час створення означає, що завдання прийнято; про його завершення свідчить лише status: "completed". Запит може повернути HTTP 200, хоча саме завдання матиме стан status: "failed".
Надішліть завдання на перетворення тексту на відео
У цьому прикладі запитується 10-секундний продуктний кліп у 720p зі співвідношенням сторін 16:9 і звуком. Використовується лише текст, тож не потрібно покладатися на зображення для довідки, розміщені деінде.
curl --fail-with-body -sS -X POST https://aihubmix.com/ai/v1/videos \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": true
}'
Одразу збережіть id повернутого завдання. Надсилайте запит GET /ai/v1/videos/{id} кожні 15 секунд, доки стан не стане completed, failed або cancelled. Для регулярної перевірки стану використовуйте маршрут отримання відомостей про відео: він оновлює стан у провайдера, а загальний список завдань не замінює таку перевірку. Після завершення завантажте відео через GET /ai/v1/videos/{id}/content, використовуючи той самий заголовок Bearer.
Повноцінний клієнт Python
Установіть залежність командою python3 -m pip install requests, збережіть наведений нижче код у файлі seedance_flash.py, а потім виконайте в оболонці, де задано API-ключ, команду python3 seedance_flash.py. У прикладі реалізовано процес, описаний у документації; помилка квоти не дала повністю перевірити генерацію.
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://aihubmix.com"
HEADERS = {
"Authorization": f"Bearer {os.environ['AIHUBMIX_API_KEY']}",
"Content-Type": "application/json",
}
PAYLOAD = {
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": True,
}
# Submit once. A network timeout does not prove that creation failed.
response = requests.post(
f"{BASE_URL}/ai/v1/videos", headers=HEADERS, json=PAYLOAD, timeout=60
)
response.raise_for_status()
task = response.json()
task_id = task["id"]
print(f"Task ID: {task_id}", flush=True)
deadline = time.monotonic() + 20 * 60
while task["status"] not in {"completed", "failed", "cancelled"}:
if time.monotonic() >= deadline:
raise TimeoutError(f"Still waiting for {task_id}; query it again, do not recreate it.")
time.sleep(15)
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}", headers=HEADERS, timeout=30
)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(f"Task {task_id}: {task.get('error') or task['status']}")
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}/content", headers=HEADERS, timeout=120
)
response.raise_for_status()
Path("seedance_flash_10s.mp4").write_bytes(response.content)
print("Saved seedance_flash_10s.mp4")
Обмеження у 20 хвилин — це ліміт очікування на боці клієнта, а не скасування завдання на сервері й не гарантія часу генерації. Якщо під час перевірки стану або завантаження виникла помилка, збережіть ID завдання та повторіть відповідну операцію. Не надсилайте автоматично повторний запит на генерацію після тайм-ауту чи за невизначеного стану у провайдера.
За офіційними тарифами BytePlus на онлайн-інференс, Flash коштує $7.00 за мільйон токенів без відеовводу або $4.30 — із відеовводом у 480p/720p. Для текстового прикладу розрахунок такий: 10 × 1280 × 720 × 24 / 1024 = 216,000 токенів: $1.51 для Flash проти $2.31 для флагманської моделі 2.5 у 720p. Це розрахункові оцінки для BytePlus, а не фактичний рахунок AIHubMix.
Довідкові матеріали та вебхуки
Щоб керувати створенням кліпу за допомогою медіаматеріалів, додайте елементи input_references із полями type (image_url, video_url або audio_url) і url, що вказує на доступний медіафайл. Схема обмежує кількість цих типів значеннями 10 / 5 / 5. Для керування першим і останнім кадрами використовуйте натомість frame_images; кожен елемент має поле frame_type і вкладене image_url.url. Не заповнюйте одночасно масиви frame_images і input_references. Для процесів із кадрами потрібне значення aspect_ratio: "adaptive", а для останнього кадру обов’язково треба вказати й перший.
Документація з асинхронних завдань описує HTTPS-сповіщення через webhook_url. Поточна схема Flash містить це поле, але не містить webhook_events_filter і задає additionalProperties: false, тож під час роботи з цією схемою моделі не вказуйте фільтр. За замовчуванням, згідно з документацією, надсилаються події completed, failed і cancelled. Доставка відбувається щонайменше один раз, передбачено до шести спроб із проміжками 1, 4, 16, 64 і 256 секунд; усувайте дублікати за event_id. Для зворотних викликів на рівні завдання окремого секрету підпису немає, тому перевіряйте остаточний стан запитом до завдання. У документації описано підписки на рівні облікового запису для застосунків, яким потрібна перевірка підпису.
Помилки: що було виміряно, а що описано в документації
1080p: зафіксована відмова за схемою
Обидва ID моделей AIHubMix повернули HTTP 400 на запит тривалістю 4 секунди з параметром resolution: "1080p". У повернутих полях помилки було зазначено:
{
"error": {
"code": "schema_violation",
"message": "`resolution` must be one of: 480p, 720p, null.",
"type": "invalid_request_error"
}
}
У відповіді також був ідентифікатор трасування запиту, який тут не наведено. Це зафіксована відмова шлюзу, а не припущення про помилку на боці вищого рівня. Вона не підтверджує ані успішну генерацію, ані швидкість роботи.
Наведені нижче обмеження випливають із поточної схеми Flash; ці некоректні комбінації окремо не надсилалися під час перевірки в реальному середовищі.
| Проблема вводу | Вимога схеми | Рішення |
|---|---|---|
| Вивід у 4K | 480p або 720p | Зменште роздільну здатність |
| Забагато матеріалів для довідки | 10 зображень / 5 відео / 5 аудіофайлів | Зменште кількість |
| Два масиви для довідкових матеріалів | Лише один непорожній масив | Виберіть процес |
| Задано лише останній кадр | Потрібен також перший кадр | Задайте обидва кадри |
| Фіксоване співвідношення сторін із кадрами | Адаптивне співвідношення сторін | Використовуйте адаптивне |
Довідкові зображення реальних людей: використовуйте перевірені ресурси
В AIHubMix описано doubao_real_person_required — помилку, яка виникає, коли Doubao повертає певну відмову з міркувань конфіденційності для зображення реальної людини. Під час цієї перевірки помилка не виникла. У документації наведено таке повідомлення:
У цьому запиті використано зображення реальної людини. Пройдіть перевірку для роботи з реальними людьми та використовуйте активний ресурс. Див. https://docs.aihubmix.com/cn/api/doubao-real-person-assets.
Дотримуйтеся посібника з ресурсів Doubao із зображеннями реальних людей: створіть групу через /ai/v1/asset-groups, створіть сеанс перевірки через /ai/v1/asset-groups/{id}/verification-sessions, попросіть зображену людину пройти вебперевірку, зареєструйте ресурс через /ai/v1/asset-groups/{id}/assets і дочекайтеся, доки він стане активним. У посиланні для генерації використовуйте asset://<ASSET_ID>. Звичайне посилання на фотографію не замінює процес отримання згоди й реєстрації ресурсу.
Квота, розмір запиту та завантаження
Зафіксована помилка 402 insufficient_quota не дала коректному запиту з допустимою роздільною здатністю перейти до генерації. Поповніть баланс, перш ніж повторити спробу; зміна коректного промпту чи ID моделі не усуне цю помилку. 403 async_not_enabled — це інша помилка, пов’язана з вимогою, описаною в документації: функцію потрібно активувати в консолі.
В AIHubMix задокументовано обмеження розміру тіла запиту — 32 MiB та помилку 413 request_too_large. Публічні URL дають змогу уникнути збільшення тіла запиту через Base64, однак зазначені медіафайли все одно мають відповідати власним обмеженням моделі щодо розміру та формату.
Зберігайте готове відео одразу. У чинному посібнику з інтеграції Seedance 2.5 від AIHubMix попереджають, що URL результатів мають короткий строк дії — приблизно 30 хвилин; фіксований строк зберігання для Flash тут не перевірявся. API відео може повертати expires_at: null, але це не є обіцянкою безстрокового зберігання. Серед задокументованих помилок завантаження — 410 artifact_expired і 429 too_many_downloads. Якщо під час завантаження виникла тимчасова помилка сервісу, повторіть завантаження для наявного завдання, а не генеруйте кліп ще раз.
Підводні камені міграції, з якими можна зіткнутися навіть за коректного запиту
В офіційному посібнику Volcengine для Seedance 2.5 Flash прямо зазначено як модель цієї лінійки, а також підтверджено вивід у MOV, редагування та розширення відео. Однак ці можливості провайдера слід відрізняти від того, що вдалося перевірити через шлюз.
- Поля для MOV і редагування доступні в схемі, але наскрізно тут не перевірялися. Схема Flash приймає
extra.output_format: "mp4"або"mov", а також значенняauto,reference,editіextendдляextra.omni_reference_task_type. Якщо вказати тип завдання явно, схема вимагає непорожнє полеinput_references. Дляeditтакож потрібні відео для довідки, адаптивне співвідношення сторін іduration: -1; дляextendпотрібні відео для довідки й адаптивне співвідношення сторін. - Явно заданий тип завдання не гарантує, що модель його прийме. В Ark описано асинхронну помилку
InvalidParameter.TaskTypeConstraint, яка виникає, коли визначений тип завдання конфліктує з параметрами, і помилкуInvalidParameter.TaskTypeMismatch, коли визначений тип відрізняється від запитаного явно. Точну відповідність кодів в AIHubMix не вимірювали; перевіряйте полеerrorу повернутому завданні, а не припускайте, що шлюз повертатиме певний код. - У Flash немає підвищення якості з Draft. Провайдер обмежує двоетапний процес Draft-to-final у 480p лише флагманською моделлю 2.5. Flash його не підтримує, а в поточних схемах AIHubMix для обох моделей немає полів
draftіdraft_task. - Відеоввід змінює вартість. За офіційною схемою тарифікації враховуються тривалість вхідного й вихідного відео, а також може застосовуватися мінімальний поріг кількості токенів. Тариф $4.30/M не гарантує, що завдання з відео для довідки коштуватиме менше, ніж ідентичне завдання лише з текстом. Перевіряйте фактичне використання й рахунок, а не покладайтеся лише на формулу.
- Деякі описи залишаються неоднозначними. Схема шлюзу Flash відкриває
extra.priority,extra.safety_identifierіextra.tools, але в їхніх описах досі зазначено «лише для серії 2.0». У довідці Ark щодо створення завдань параметриpriorityіtoolsтакож перелічені для сімейства 2.5. Сам факт наявності параметра у схемі не підтверджує його дію в AIHubMix — перш ніж покладатися на нього у виробничому середовищі, перевірте відповідну функцію.
Контрольний список перед запуском
- Увімкніть асинхронні завдання та перевірте кредитний баланс облікового запису.
- Використовуйте короткий ідентифікатор Flash разом із
/ai/v1/videosі отримайте актуальну схему. - Виберіть роздільну здатність 480p або 720p і вкажіть тривалість від 4 до 30 секунд.
- Обмежте кількість референсів: до 10 зображень, 5 відео й 5 аудіокліпів.
- Розміщуйте референси кадрів окремо та використовуйте для них адаптивне співвідношення сторін.
- Для референсів із зображенням реальних людей використовуйте перевірені активні ресурси.
- Збережіть ідентифікатор завдання, перевірте його кінцевий статус і якнайшвидше завантажте результат.
- Якщо стан генерації невідомий, повторно перевірте статус завдання або завантажте результат того самого завдання.
Поширені запитання
Чи можна використовувати сумісний з OpenAI шлях /v1/videos для Flash?
У поточній схемі Flash указано лише /ai/v1/videos. Для прикладів у цьому посібнику використовуйте цей нативний асинхронний шлях.
Чому запит із зображеннями кадрів завершується помилкою за значення aspect_ratio: "16:9"?
Схема Flash вимагає aspect_ratio: "adaptive", якщо передано непорожнє поле frame_images. Також для останнього кадру потрібен перший, а референси кадрів не можна поєднувати з непорожнім полем input_references.
Як виправити помилку doubao_real_person_required?
Пройдіть перевірку особи та процедуру реєстрації ресурсів, дочекайтеся активації ресурсу й укажіть його URI як референс. Цей код позначає конкретну відмову Doubao з міркувань конфіденційності; під час цієї перевірки її не вдалося відтворити.
Чому коротке референсне відео може коштувати дорожче, ніж передбачає формула?
Правила виставлення рахунків постачальника можуть передбачати мінімальну кількість токенів, якщо вхідні дані містять відео. Формула дає лише приблизну оцінку; перевірте фактичне споживання та записи про оплату в обліковому записі, щоб дізнатися суму списання.
Чи стягується плата за невдалі генерації або відхилення модерації?
За офіційними правилами білінгу BytePlus і Volcengine, плата стягується за успішні генерації, а за невдалі генерації та відхилення модерацією вмісту — ні. У документації AIHubMix щодо помилок радять перевіряти записи про оплату, щоб дізнатися про минулі списання; у цій перевірці не вимірювалися рахунки ні за успішну, ні за невдалу генерацію.
Скільки часу є, щоб завантажити результат Flash?
Завантажте його відразу після завершення. У наявному посібнику з Seedance 2.5 попереджають, що URL-адреси діють приблизно 30 хвилин, але точний строк зберігання результатів Flash не перевіряли, а порожнє поле строку дії не означає, що результат зберігатиметься постійно.
Чи підтримуються в AIHubMix формат виводу MOV і функції редагування/продовження?
У поточній схемі Flash відповідні поля доступні в розділі extra, а постачальник документує ці можливості. Наскрізну роботу цих функцій через AIHubMix не перевіряли, оскільки тест створення зупинився через недостатній баланс.
Читайте далі: серія Seedance 2.5 Flash
- Потрібно порівняти ціни й компроміси щодо роздільної здатності, перш ніж обрати модель? Seedance 2.5 Flash проти 2.5 і 2.0: чи варто оновлюватися?
Джерела
Документацію та схему перевірено 16 листопада 2026 року; відповіді під час перевірки зафіксовано о 08:26 UTC. Ціни — це офіційні оцінки BytePlus, а не фактичні тарифи шлюзу.
- API генерації відео (документація AIHubMix)
- API асинхронних завдань (документація AIHubMix)
- Посібник із ресурсів Doubao із зображенням реальних людей (документація AIHubMix)
- Тарифи ModelArk (BytePlus)
- Посібник із Seedance 2.5 (Volcengine Ark)



