С API Seedance 2 лучше всего работать как с асинхронной видеозадачей. OdiRouter документирует как модель Seedance 2.0, так и её жизненный цикл мультимодальной задачи, поэтому интеграция может пройти путь от выбора модели до получения результата, а не рассматривать длительную генерацию как синхронный ответ.
Сначала ознакомьтесь с актуальным справочником модели
Начните с Seedance 2.0 model documentation. OdiRouter описывает Seedance 2.0 как поддерживающую генерацию видео с мультимодальными референсами, редактирование видео и расширение видео. Эта же страница служит источником достоверной информации об актуальных параметрах запросов и ответов, поэтому она надёжнее, чем перенос конфигурации из более старой интеграции.
Используйте страницу модели, чтобы ответить на вопросы, определяющие запрос: какие входные данные принимает выбранная операция, какие поля обязательны и что возвращает ответ. Не изменяйте идентификатор модели и задокументированные технические литералы в коде приложения.
Разместите конфигурацию API в одном месте
multimodal setup guide охватывает базовый URL, конечную точку и границу аутентификации. quick start охватывает доступ к учётной записи, создание API-ключа, настройку баланса и первый вызов API.
Не размещайте учётные данные в промптах, системе контроля версий и клиентском коде. Разместите базовый URL-адрес и обработку аутентификации в небольшом интеграционном слое, а остальная часть приложения пусть обращается к этому слою. Такое разделение упрощает проверку запроса и позволяет вносить изменения в конфигурацию без переписывания бизнес-логики.
Создайте задачу и сохраните её идентификаторы
Используйте поток create a multimodal task для отправки запроса. Документация рекомендует разработчикам сохранить возвращённые идентификатор запроса и URL для последующих операций. Сохраните оба значения вместе с заданием приложения, представляющим собой запрос на генерацию.
Запись о задаче должна быть небольшой, но полезной. Сохраняйте имя модели, ссылку на отправленные входные данные, идентификатор запроса, URL задачи, время создания и последний наблюдавшийся статус. После этого воркер, потребитель очереди или инструмент поддержки сможет возобновить опрос после прерывания, не восстанавливая исходную отправку.
Проверяйте статус перед получением результата
Генерация может занять некоторое время. OdiRouter status documentation различает состояния «в очереди», «в процессе», «завершено» и «ошибка». Выполняйте опрос с интервалом, подходящим для приложения, а не отправляйте запросы настолько часто, насколько возможно.
После завершения задачи используйте result documentation для получения результата. Явно определите путь обработки сбоев. Состояние ошибки требует видимой реакции приложения, тогда как задача в очереди или в процессе должна оставаться восстанавливаемой без автоматической повторной отправки.
Выберите операцию из документированной входной схемы
Seedance 2.0 имеет документированную поддержку мультимодальных ссылок, редактирования видео и расширения видео. Выбирайте операцию, поскольку её входная схема соответствует имеющемуся у вас материалу. Для генерации на основе текста, запроса на основе референса и запроса на редактирование или расширение могут требоваться разные входные данные и проверка.
Перед использованием в продакшене проверьте актуальную страницу модели и поддерживайте небольшой набор тестов для типов входных данных, которые отправляет ваш продукт. Успешный ответ на задачу подтверждает, что этот запрос сработал. Он не гарантирует, что будущая конфигурация модели будет вести себя так же.
Проверяйте изменяющуюся информацию о модели и ценах в первоисточнике
Используйте код модели OdiRouter models page для просмотра доступных вариантов. Используйте pricing page для ознакомления с актуальной коммерческой информацией перед развертыванием рабочего процесса. Эти детали могут меняться, поэтому в данном руководстве цены, количество конечных точек и доступность не указаны жестко.
Контрольный список производства
Ознакомьтесь с текущей справочной информацией по модели Seedance 2.0 и выберите операцию с соответствующей схемой ввода.
Настройте мультимодальный клиент по документированному пути настройки и не храните учётные данные в исходном коде приложения.
Сохраняйте идентификатор запроса и URL задачи сразу после создания задачи.
Явно обрабатывайте состояния «в очереди», «в процессе», «завершено» и «ошибка».
Получайте результат только после завершения, затем фиксируйте итог, необходимый приложению.
Перед запуском в продакшене повторно проверьте текущие страницы модели и цен.
Часто задаваемые вопросы
Возвращает ли API Seedance 2 готовое видео в первоначальном запросе?
Документированный рабочий процесс основан на задачах. Отправьте задачу, сохраните её идентификаторы, проверьте её статус и получите результат после завершения задачи.
Где следует подтверждать поддерживаемые входные данные?
Используйте актуальный Seedance 2.0 model documentation. Это источник параметров запросов и ответов модели.
Следует ли приложению повторять каждую незавершённую задачу?
Нет. Сначала отличите задачу в очереди или в процессе от состояния ошибки с помощью документированного процесса проверки статуса. Повторная отправка незавершённой задачи может привести к дублированию работы, если исходная задача всё ещё активна.