Seedance 2.5 API: руководство разработчика по эндпоинтам, авторизации и генерации видео

Seedance 2.5 API: руководство разработчика по эндпоинтам, авторизации и генерации видео

Seedance 2.5 представляет собой мультимодальную видеомодель длительной генерации. Это значит, что управляющий ею API работает асинхронно, а не по схеме одиночного запроса-ответа. Вы отправляете задачу на генерацию, опрашиваете статус до её завершения и скачиваете результат. Как только вы усвоите этот паттерн, а также эндпоинт, заголовок авторизации и поля полезной нагрузки для длительности, разрешения и референсов, дальнейшая работа не составит труда.

Это руководство последовательно разбирает весь контракт Seedance 2.5 API: эндпоинт, аутентификацию, тело запроса, асинхронный поллинг и рабочие примеры на curl и Python. Материал ориентирован на маршрут PixMind api-platform, который повторяет контракт ByteDance для этой модели. Также добавлено прямое сравнение с паттернами Seedance 2.0 и Kling, сквозной кейс продакшен-пайплайна, сторонние ресурсы для разработчиков и расширенный FAQ с темами rate-лимитов, конкурентности, вебхуков и проверки кредитов. Все детали эндпоинтов и авторизации сверены с живым бэкендом на 2026-07-31.

Seedance 2.5 model overview

Основные выводы

• Эндпоинт: POST /api-platform/v1/generations для создания задачи; GET /api-platform/v1/task/{task_id} для опроса результата.
• Авторизация: Authorization: Bearer <API_KEY> (или заголовок X-API-Key); создайте ключ со scope video в дашборде PixMind.
• Полезная нагрузка: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• Это асинхронно: вызов create возвращает taskId; вы опрашиваете, пока status не станет ready, затем читаете videoUrl.
• Общая форма у разных провайдеров: Seedance 2.5, Seedance 2.0 и Kling используют один и тот же паттерн submit-then-poll. Они различаются путём эндпоинта, бюджетом референсов и именами полей.
• Продакшен-паттерн: добавляйте Idempotency-Key при create, опрашивайте с ограниченным числом повторов и backoff'ом, проверяйте кредиты перед отправкой и откатывайтесь на более дешёвый маршрут для итераций.
• Доступ к API скоро появится на PixMind; маршрут задокументирован и готов, финализируется подключение бэкенда.

Предварительные требования: получите API-ключ

Вызовы к Seedance 2.5 аутентифицируются API-ключом, привязанным к вашему аккаунту. Создайте его в дашборде PixMind api-platform и храните безопасно, обращаясь с ним как с любой другой секретной строкой. В коде загружайте ключ из переменной окружения, а не коммитьте его в систему контроля версий:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Create an API key

В PixMind разрешения ключей ограничены по типу нагрузки (image или video). Перед вызовом Seedance 2.5 убедитесь, что для вашего ключа включено разрешение video.

Заметка разработчика: Ротируйте ключи под каждое окружение (dev / staging / prod) и ограничивайте каждый ключ минимально необходимым набором нагрузок. Стейджинговый ключ только со scope video не может утечь в image-пайплайн, что уменьшает радиус поражения при компрометации ключа. Перевыпускайте ключи по фиксированному графику и логируйте время последнего использования, чтобы спящие ключи было легко найти и отозвать.

Смотрите: разбор workflow Seedance 2.5

Самый быстрый способ понять апгрейд 2.5 до написания кода — посмотреть официальный демо-материал и анализ сообщества. Эти два разбора охватывают нативную 30-секундную генерацию, вывод в 4K, редактирование на уровне регионов и workflow с 50 референсами, который открывает API:

noscript fallback: Демо Seedance 2.5 на YouTube, охватывает нативные 30-секундные клипы, редактирование на уровне региона и 50 мультимодальных референсов.

Для более глубокого редакторского обсуждения того, что улучшения workflow значат для продакшен-пайплайна, стоит посмотреть анализ «Seedance 2.5 Changes Everything» вместе с официальным роликом:

noscript fallback: Seedance 2.5 Changes Everything на YouTube.

Контракт Seedance 2.5 API

Эндпоинт

Создание задачи генерации:

POST /api-platform/v1/generations

Опрос завершения:

GET /api-platform/v1/task/{task_id}

Эндпоинт create выступает единой точкой входа для генерации: он читает поле model и диспетчеризирует соответственно. Отправьте model: "seedance-2.5", и маршрут обработает видеоконвейер.

Аутентификация

Отправляйте API-ключ как Bearer-токен (совместимо с OpenAI SDK):

Authorization: Bearer $PIXMIND_API_KEY

Auth-посредник также принимает заголовок X-API-Key, если вам удобнее эта форма. Поддерживаются оба варианта; выберите один и используйте его единообразно во всём клиентском коде, чтобы логи и повторы было легче отслеживать.

Тело запроса

О референсах: Seedance 2.5 принимает до 50 мультимодальных входов в одном запросе: изображения, видео, текст и аудио суммарно. Назначьте каждому референсу одну явную роль (идентичность, форма, движение, палитра, ритм) и удаляйте ассеты, которые конкурируют за одно и то же свойство.

Как Seedance 2.5 API соотносится с Seedance 2.0 и Kling

Большинство современных API генерации видео имеют одну и ту же асинхронную форму: один POST для создания задачи, один GET для опроса до завершения. Различаются путь эндпоинта, конвенция авторизации, бюджет референсов и имена полей в полезной нагрузке. Таблица ниже сводит эти различия для трёх API, которые разработчики чаще всего сравнивают при планировании интеграции.

Наблюдение из практики: Общая асинхронная форма означает, что клиентский код переиспользуем у разных провайдеров. Оберните цикл create-and-poll в одну функцию generate_video(model, payload) и подменяйте ID модели, и вы сможете A/B-тестировать Seedance 2.5, Seedance 2.0 Fast и Kling из одного харнесса. Это самый дешёвый способ выбрать правильный маршрут для каждого кадра без переписывания интеграционного кода.

Практический вывод: если ваша команда уже построила клиент для поллинга под Seedance 2.0, переход на 2.5 сводится к замене строки модели и добавлению новых полей референса и длительности. Переделывать интеграцию не нужно.

Seedance 2.5 vs Kling model comparison

Шаг 1: Создание задачи генерации

Вот минимальный запрос create: 5-секундный клип в 720p, 16:9 с текстовым промптом. Заголовок Idempotency-Key опционален, но рекомендуется для любого продакшен-вызова:

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "Курьер в жёлтой куртке едет на велосипеде по освещённой неоном дождливой ночной улице Токио, tracking shot, кинематографично, без текста",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Успешный ответ возвращает ID задачи. Здесь вы ещё не получаете видео, вы получаете дескриптор для опроса:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

Если вы видите code: 400 с сообщением «模型不存在或未配置» (модель не существует или не настроена), значит, бэкенд-маршрут для seedance-2.5 ещё не включён на этом эндпоинте. Это состояние Coming Soon на PixMind, пока подключение финализируется.

Шаг 2: Опрос задачи до готовности

Генерация видео асинхронна. Опрашивайте эндпоинт задачи с taskId из шага 1:

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

Поле status проходит через pending, затем processing, затем ready. Опрашивайте каждые 3–5 секунд. Когда задача готова, ответ содержит финальный URL видео:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

Терминальные состояния ошибки: failed, error, canceled и cancelled. Обрабатывайте их и выводите поле description в свои логи.

Заметка разработчика: Интервалы поллинга 3–5 секунд подходят для одиночной задачи, но при масштабировании они быстро множатся. Для очереди из 20 задач лучше использовать единый цикл-диспетчер, который опрашивает каждую открытую задачу один раз за проход, с экспоненциальным backoff'ом (5 с, 5 с, 10 с, 15 с, с потолком 30 с) по мере старения задач. Это сохраняет вежливый объём запросов, не растягивая p99-латентность для всего батча.

Шаг 3: Скачивание и использование результата

Когда status равно ready, скачивайте videoUrl (и опционально coverUrl для постер-кадра). Файл представляет собой стандартный MP4; транскодируйте, хостите или встраивайте его по мере необходимости вашего приложения.

Для веб-лендинга обычно сжимают видео до 8–10-секундного клипа H.264 с fast-start для автозапуска, извлекают WebP-постер и хостят оба файла на собственном CDN. (PixMind размещает свои кейс-медиа Seedance 2.5 на cdn.pixmind.io.) Не используйте hotlink на размещённый API videoUrl в продакшене, поскольку URL API не гарантированно сохраняется.

Полный пример на Python

Вот полный, исполняемый сниппет на Python, который создаёт задачу, опрашивает до готовности и выводит URL видео. В него добавлены Idempotency-Key, ограниченный цикл повторов и потолок таймаута: это три вещи, которые нужны продакшен-клиенту, но которые обычно опускают в hello-world примерах.

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # права: video

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. Создаём с idempotency-ключом, чтобы повтор не запустил вторую оплачиваемую задачу
payload = {
    "model": "seedance-2.5",
    "prompt": "30-секундный непрерывный hero-кадр: персонаж идёт через неоновый город, который перетекает в презентацию продукта",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. Опрашиваем с ограниченным числом попыток и мягким backoff'ом
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # backoff, потолок 30 с
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

Сквозной кейс: пайплайн для 30-секундного продукт-видео

Это та часть, которую большинство API-руководств пропускает: как реальная команда собирает описанный выше контракт в повторимый продакшен-пайплайн. Сценарий: креативная команда из четырёх человек в D2C-бренде производит 30-секундное hero-видео для запуска продукта с фиксированным бюджетом и жёстким дедлайном. Нижеописанный паттерн представляет собой форму, которая стабильно доставляет в срок.

Обзор пайплайна

Команда делит работу на четыре стадии: итерация (дешёвые A/B-тесты на Seedance 2.0 Fast), финальная генерация (один прогон Seedance 2.5 в 1080p / 30 с), ревью и региональные правки (точечная регенерация регионов в Seedance 2.5) и доставка (транскодирование, постер, загрузка в CDN). Каждая стадия использует один и тот же клиентский код; меняются только ID модели и полезная нагрузка. Именно это разделение делает пайплайн повторимым между кампаниями.

Распределение референсов

Перед любым вызовом API команда назначает каждому референсу одну явную роль, фиксируя это в общей таблице, чтобы промпт и полезная нагрузка оставались синхронизированными. Пять референсов из бюджета в 50 входов, каждый со своей задачей:

Промпт отображает каждый из них явно: «сохранять персонажа из @Image 1 неизменным; соответствовать продукту из @Image 2; использовать @Video 1 только для движения камеры; выровнять нарезку по @Audio 1». Это отображение выступает контрактом между креативным направлением и полезной нагрузкой API. Если референсу не назначена роль, он не попадает в запрос.

Стадия итерации (контроль стоимости)

Перед тратами на 30-секундный прогон 2.5 команда валидирует промпт и референсы на Seedance 2.0 Fast в 5 секунд и 720p. Это тот же вызов POST /api-platform/v1/generations с model: "seedance-2.0-fast". Три итерации стоят долю одного прогона 2.5 и выявляют конфликты референсов до того, как бюджет зафиксирован. Диспетчер логирует taskId, статус и прошедшие секунды каждой итерации, чтобы креативный лидер мог сравнивать варианты бок о бок.

Наблюдение из практики: Команды, пропускающие эту стадию и идущие сразу в 30-секундную генерацию 2.5, обычно сжигают три-четыре полных по цене прогона на исправление конфликтов промпта, которые можно было поймать на Fast. Стадия итерации является самой высоко-ROI частью пайплайна, и команды, которые доставляют надёжно, относятся к ней как к обязательной.

Финальная генерация (Seedance 2.5 в 30 с / 1080p)

Когда итерация на Fast подтверждает, что промпт читается, команда отправляет реальную генерацию: model: "seedance-2.5", duration: 30, resolution: "1080p", со всеми пятью референсами и полным промптом с отображением ролей. Вызов create включает Idempotency-Key, чтобы сетевой повтор из CI-раннера не запустил вторую оплачиваемую задачу. Креативный лидер ревьюит лог отправки финального taskId перед тем, как диспетчеру разрешается закоммитить его; эта минутная проверка предохраняет от дорогих опечаток в промпте.

Поллинг, ошибки и идемпотентность

Единый диспетчер опрашивает задачу каждые 5 секунд с backoff'ом до 30 секунд, с потолком в 100 попыток (около 8 минут). Терминальные ошибки (failed, error) запускают один повтор с новым Idempotency-Key, только если описание ошибки указывает на временную проблему бэкенда. Ошибки референсов или промпта выводятся креативному лидеру и исправляются перед повторной отправкой, а не повторяются вслепую. Диспетчер пишет структурированную строку лога на каждую попытку (ID задачи, статус, прогресс, прошедшие секунды), чтобы стоимость и латентность были аудируемы после запуска.

Региональные правки

При ревью клиент просит заменить продукт на правой полке финального кадра. Команда отправляет задачу редактирования на уровне региона, нацеленную только на эту область и сохраняющую остальное движение и идентичность клипа. Это самая ценная фича 2.5 для клиентской работы: однодневный round-trip превращается в 10-минутную регенерацию. Пайплайн хранит оригинальный taskId и taskId правки связанными в логе проекта, чтобы происхождение каждого опубликованного кадра было отслеживаемо.

Доставка

Готовый videoUrl скачивается, транскодируется в H.264 с fast-start для веб-автозапуска, комплектуется WebP-постером, извлечённым из coverUrl, и загружается в командный CDN. Финальные ассеты пушатся на лендинг и ревьюятся покадрово (идентичность, руки, геометрия продукта, логотипы, синк аудио) перед публикацией.

Дисциплина стоимости

Пайплайн ограничивает траты в трёх местах. Во-первых, итерации идут на Fast вместо 2.5. Во-вторых, пре-чек кредитов перед каждой отправкой 2.5 прерывается, если баланс кошелька ниже порога для выбранных длительности и разрешения. В-третьих, жёсткий бюджет задач на запуск в диспетчере отказывается отправлять новые задачи после достижения потолка. Цена Seedance 2.5 не опубликована, поэтому команда относится к любому значению за секунду как к оценке и читает текущие кредиты в живом генераторе перед каждой кампанией.

Обработка 50 мультимодальных референсов

Заголовочная фича до 50 мультимодальных входов отображается в полезной нагрузке как массивы публичных URL:

{
  "model": "seedance-2.5",
  "prompt": "Сохраняй персонажа на первом изображении неизменным; используй видео для движения тела и аудио для ритма",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

Все URL референсов должны быть публично доступны. Назначьте каждому одну роль и опишите её в промпте («используй @Video 1 только для движения тела»), чтобы модель знала, какой вход какое свойство контролирует.

Заметка разработчика: Пред-валидируйте, что каждый URL референса возвращает HTTP 200 с ожидаемым content-type перед отправкой. Один 403 на CDN-защищённом ассете является самой частой причиной задач в статусе failed в продакшене, и он тратит полный бюджет генерации. Двухстрочная проверка HEAD-запросом в вашем клиенте предотвращает весь этот класс ошибок. Также используйте стабильные URL, адресованные по контенту (например, с хешем или версией в пути), чтобы замена ассета посреди кампании не привела к тихому изменению того, что получает модель.

Обработка ошибок и идемпотентность

• 401 «API Key 无效» (недействительный API Key): неверный ключ или у ключа нет scope video. Проверьте ключ и его разрешения.
• 400 «模型不存在或未配置» (модель не существует или не настроена): маршрут seedance-2.5 ещё не включён на этом бэкенде. В PixMind это состояние Coming Soon.
• 4001 «余额不足» (недостаточно средств): запрос валиден, но на кошельке нет кредитов; задача не создаётся.
• 429 rate limit: делайте экспоненциальный backoff и повторяйте; эндпоинт create применяет per-key ограничения конкурентности и частоты запросов. Если вы упёрлись в это регулярно, свяжитесь с поддержкой для повышения лимитов или распределите отправки по коротким интервалам.
• 502 / 504 gateway: временная ошибка; повторите вызов create с тем же Idempotency-Key, чтобы бэкенд дедуплицировал и вы не запустили вторую оплачиваемую задачу.
• Polling timeout: ограничьте число попыток (например, 100 × 5 с, около 8 минут) и считайте таймаут ошибкой с одним повтором.

В продакшене передавайте заголовок Idempotency-Key на каждый вызов create, чтобы повтор клиента не запускал вторую оплачиваемую задачу. Используйте UUID на логическую задачу (не на HTTP-попытку), сгенерированный один раз и сохранённый на вашей стороне, чтобы одна и та же логическая генерация дедуплицировалась между повторами, перезапусками CI и повторами очереди. Паттерн такой: генерируйте UUID, когда пользователь (или job-раннер) решает создать задачу, персистите его перед первым HTTP-вызовом и переиспользуйте для каждого повтора той же логической задачи.

Сторонние ресурсы для разработчиков

Описанный выше контракт является путём реализации на PixMind. Для более глубокого контекста по базовой модели ByteDance и официальной API-поверхности вот ресурсы, к которым разработчики обращаются чаще всего, проверено 2026-07-31:

• Страница ресурса BytePlus Seedance 2.5, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. Собственное видение 2.5 от ByteDance, ориентированное на генерацию рекламных видео и демо продуктов. Полезно для понимания нарратива о возможностях и сценариев, на которые ориентируется сам ByteDance. Проверенный листинг, 2026-07-31.
• Документация BytePlus ModelArk API, официальная поверхность для разработчиков для вызова Seedance через облако ByteDance. Перекрёстно сверяйте имена полей и режимы, когда нужно подтвердить, что открывает подключённый маршрут, и затем отражайте эти имена в клиенте.
• Документация Volcengine 火山方舟 (Volcano Engine Ark), volcengine.com/docs/82379. Внутренний (Китай) эндпоинт для того же семейства моделей. Асинхронный паттерн submit-and-poll такой же, как на маршруте PixMind; имена полей и флоу авторизации немного различаются. Проверенный листинг, 2026-07-31; перед интеграцией подтвердите живой путь.
• Руководство по воспроизведению демо от MakeFun AI, makefun.ai/seedance-2-5-demo-videos/. Проходит через воссоздание насыщенных референсами демо-workflow BytePlus ModelArk. Полезно, когда нужно воспроизвести официальный вид перед разработкой собственного промпта.
• Анализы сообщества: разбор Topview/Medium 2.5, обзор FORCE от Pixo и полный гид ToSea освещают улучшения workflow с редакторской точки зрения. Полезно для контекста, а не для деталей эндпоинтов; всегда сверяйте технические специфики с живым API.

Заметка разработчика: Сторонние руководства быстро устаревают. Относитесь к любому из них как к отправной точке и сверяйте пути эндпоинтов, имена полей и стоимости кредитов с подключённым маршрутом в день интеграции. Детали эндпоинта и авторизации в этом руководстве проверены на 2026-07-31, но модель всё ещё развёртывается, поэтому перепроверьте перед продакшен-запуском.

Seedance 2.5 API: FAQ

Какой эндпоинт у Seedance 2.5 API?

Создайте задачу через POST /api-platform/v1/generations, затем опрашивайте GET /api-platform/v1/task/{task_id}, пока status не станет ready. Используйте в поле модели значение seedance-2.5.

Как аутентифицироваться в Seedance 2.5 API?

Отправляйте свой API-ключ как Authorization: Bearer <key>. Заголовок X-API-Key также принимается. Создайте ключ с разрешением video в дашборде PixMind и загружайте его из переменной окружения, а не встраивайте в исходный код.

Доступен ли Seedance 2.5 API на PixMind?

Маршрут задокументирован и готов; доступ к бэкенду финализируется, и модель помечена как Coming Soon. На странице /api-platform/models/seedance-2-5 приведены эндпоинт и справочник параметров, а страница /ai-video/seedance-2-5 тем временем хостит веб-генератор.

Сколько референсов можно отправить в одном запросе Seedance 2.5?

До 50 мультимодальных входов: изображения, видео, текст и аудио суммарно в одном запросе. Это увеличено с 9 в Seedance 2.0. Каждый референс должен быть публично доступным URL.

Возвращает ли Seedance 2.5 API видео синхронно?

Нет. Генерация видео асинхронна. Вызов create возвращает taskId; вы опрашиваете эндпоинт задачи, пока status не станет ready, и затем читаете videoUrl. Типичная 30-секундная генерация занимает несколько минут, так что проектируйте клиент под поллинг, а не под блокирующее ожидание.

Какие rate-лимиты и ограничения конкурентности?

Эндпоинт create применяет per-key ограничения частоты запросов и конкурентности. При превышении ответ возвращает 429, и вам следует делать экспоненциальный backoff. Для батчевых нагрузок (больше нескольких параллельных задач) распределяйте отправки по коротким интервалам и свяжитесь с поддержкой, чтобы повысить лимиты, если вы регулярно упираетесь в 429. Точные числовые лимиты настраиваются per-аккаунт, поэтому проверяйте их на собственном ключе перед проектированием крупной батчевой задачи.

Поддерживает ли Seedance 2.5 API вебхуки или колбэки?

Проверенный маршрут PixMind использует только опрос на основе поллинга, а не push-колбэки. Если вашей архитектуре нужны push-уведомления, запустите единый диспетчер, который опрашивает эндпоинт задачи и эмитит вебхук в ваши нижестоящие сервисы, когда status достигает терминального состояния. Это сохраняет интеграцию простой и избегает жёсткой привязки пайплайна к URL колбэка, который может меняться между окружениями.

Сколько параллельных задач можно запускать?

Конкурентность ограничена per-key потолками вашего ключа и балансом кредитов. Для 30-секундных 1080p работ ожидайте несколько параллельных задач, а не десятки. Считайте живой потолок verified-on-your-account: отправьте небольшой калибровочный батч, замерьте, сколько задач одновременно переходят из pending в processing, и подгоняйте размер очереди под это число.

В каком формате API возвращает видео?

Готовая задача возвращает videoUrl, указывающий на стандартный MP4-файл, плюс coverUrl для постер-кадра. Скачайте и транскодируйте в формат, нужный вашей цели доставки (H.264 с fast-start для веба, вертикальные кодировки для соцсетей, ProRes для мастеринга монтажа). Не используйте hotlink на размещённый API videoUrl в продакшене, поскольку он не гарантированно сохраняется; копируйте файл на собственный CDN при ready.

Как проверить кредиты перед отправкой?

Читайте текущую стоимость в кредитах в живом генераторе для выбранных длительности и разрешения, затем проверяйте баланс кошелька. API возвращает 4001 «余额不足» (недостаточно средств), если баланс слишком низок, и задача не создаётся. Для продакшен-пайплайнов добавьте пре-чек баланса перед отправкой, который прерывается рано, если баланс ниже порога на задачу, чтобы не ставить в очередь работу, которую кошелёк не покроет.

Как исправить ошибку «模型不存在或未配置»?

Этот ответ 400 означает, что маршрут seedance-2.5 не включён на бэкенд-эндпоинте, который вы вызываете. В PixMind это состояние Coming Soon, пока подключение бэкенда финализируется. Подтвердите, что вы вызываете задокументированный путь /api-platform/v1/generations с model: "seedance-2.5" (в нижнем регистре, точно). Если оба условия соблюдены и ошибка сохраняется, маршрут ещё не открыт на вашем аккаунте; следите за доступностью на странице /api-platform/models/seedance-2-5.

Какие разрешения и длительности можно запрашивать?

Длительность до 30 секунд за один прогон; разрешения 480p, 720p, 1080p и нативное 4K. Подтвердите точные опции в живом генераторе перед отправкой, поскольку подключённый маршрут может открывать подмножество.

Опубликована ли цена Seedance 2.5 API?

Пока нет. Считайте любое значение за секунду, встреченное в других местах, оценочным. Перед отправкой читайте текущие кредиты в живом генераторе для выбранных длительности и разрешения и стройте пайплайн так, чтобы он мог поглотить обновление цены без переписывания интеграции.

Начните строить с Seedance 2.5 API

Seedance 2.5 API представляет собой стандартный асинхронный контракт генерации видео: один вызов create, один цикл поллинга, одно скачивание. Как только у вас есть ключ со scope video, примеров curl и Python выше достаточно, чтобы доставить первую интеграцию. Таблица сравнения и кейс пайплайна показывают, как масштабировать этот контракт от одиночного клипа до повторимого продакшен-workflow, который выдерживает клиентские правки, давление бюджета и дедлайны.

→ Прочитайте полный справочник маршрута Seedance 2.5 API или опробуйте модель в веб-генераторе, пока доступ к API финализируется.

Compare every Seedance route

Детали эндпоинта и авторизации сверены с бэкендом PixMind api-platform на 2026-07-31. Ссылки на сторонние ресурсы проверены 2026-07-31. Поля сравнения Kling API помечены как оценочные и должны быть сверены с живой документацией Kling. Цена Seedance 2.5 не опубликована и помечена как оценочная.