Используйте 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, при котором длительность выбирает модель. Чтобы предсказуемо оценить расходы, указывайте длительность явно.
Создание задачи, проверка статуса и скачивание
В Video Generation API AIHubMix создание задачи, запросы статуса и скачивание разделены. Успешный HTTP-ответ при создании означает, что задача принята; только status: "completed" подтверждает её завершение. Запрос статуса может вернуть HTTP 200, даже если у самой задачи статус status: "failed".
Отправка задачи преобразования текста в видео
В этом примере запрашивается 10-секундный рекламный ролик продукта в формате 16:9 с разрешением 720p и звуком. Используется только текст, поэтому ссылки на референсные изображения не нужны.
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 задачи. Каждые 15 секунд отправляйте запрос GET /ai/v1/videos/{id}, пока статус не станет 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"
}
}
В ответе также содержался ID трассировки запроса, который здесь не приводится. Это зафиксированный отказ со стороны шлюза, а не предположение об ошибке вышестоящего сервиса. Он не подтверждает ни успешную генерацию, ни скорость работы.
Приведённые ниже ограничения указаны в текущей схеме 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, однако размер и формат медиафайлов по-прежнему должны соответствовать ограничениям самой модели.
Сразу сохраняйте готовое видео. В существующем руководстве AIHubMix по интеграции Seedance 2.5 указано, что URL результата действуют недолго — примерно 30 минут; фиксированный срок хранения Flash здесь проверить не удалось. Video API может вернуть expires_at: null, но это не гарантирует бессрочное хранение. Среди описанных ошибок скачивания — 410 artifact_expired и 429 too_many_downloads. Если при скачивании возникает временная ошибка сервиса, повторите скачивание для уже созданной задачи, а не запускайте генерацию видео заново.
Подводные камни миграции, с которыми можно столкнуться даже при корректном запросе
В официальном руководстве Volcengine по Seedance 2.5 Flash явно включена в линейку; там также подтверждаются вывод в MOV, редактирование и продление видео. Однако возможности поставщика следует отличать от того, что удалось проверить через шлюз.
- Поля для формата MOV и редактирования доступны в схеме, но сквозного тестирования здесь не проводилось. Схема Flash принимает значения
extra.output_format: "mp4"или"mov", а полеextra.omni_reference_task_type— значенияauto,reference,editиextend. Если явно передать тип задачи, схема потребует непустой параметрinput_references. Дляeditтакже нужны видеореференс, адаптивное соотношение сторон иduration: -1; дляextendнужны видеореференс и адаптивное соотношение сторон. - Явно указанный тип задачи не гарантирует, что модель с ним согласится. В документации Ark описаны асинхронные ошибки
InvalidParameter.TaskTypeConstraint, возникающие при конфликте между определённым типом задачи и параметрами, иInvalidParameter.TaskTypeMismatch, возникающие, когда определённый тип отличается от явно запрошенного. Точное соответствие ошибок в AIHubMix не проверялось; изучите полеerrorв ответе по задаче, а не рассчитывайте на определённый код шлюза. - Для Flash нет перехода от Draft к финальной версии. Поставщик ограничивает двухэтапный процесс 480p Draft → финальная версия флагманской моделью 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; прежде чем полагаться на конкретную функцию в production, проверьте её.
Контрольный список перед запуском
- Включите асинхронные задачи и проверьте баланс аккаунта.
- Используйте короткий ID Flash с
/ai/v1/videosи получите актуальную схему. - Выберите 480p или 720p и явно укажите длительность от 4 до 30 секунд.
- Не превышайте лимиты для референсов: 10 изображений, 5 видео и 5 аудиоклипов.
- Передавайте референсы кадров отдельно и задавайте для них адаптивное соотношение сторон.
- Для референсов с изображением реального человека используйте только проверенные активные ресурсы.
- Сохраните ID задачи, проверьте её конечный статус и сразу скачайте результат.
- Если состояние генерации неясно, повторно запросите статус или скачайте результат уже существующей задачи.
Часто задаваемые вопросы
Можно ли использовать путь, совместимый с OpenAI, /v1/videos для Flash?
В актуальной схеме Flash указан только путь /ai/v1/videos. В примерах этого руководства используйте именно этот нативный асинхронный путь.
Почему запрос с изображениями кадров завершается ошибкой при aspect_ratio: "16:9"?
Согласно схеме Flash, если переданы непустые frame_images, параметр должен иметь значение aspect_ratio: "adaptive". Для последнего кадра также требуется первый, а референсы кадров нельзя сочетать с непустым 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)



