Запрос к API Seedance 2.0 Image-to-Video Turbo обычно связан с практической задачей: преобразовать референсное изображение и промпт в короткое видео, а затем решить, подходят ли результат, процесс выполнения запроса и стоимость для продукта. Используйте опубликованную карточку модели в качестве контрольного списка. Это не доказывает, что её точный идентификатор модели или эндпоинт доступен в OdiRouter. Проверьте актуальный каталог OdiRouter для API-ключа, который вы планируете использовать.
Проверьте доступность, прежде чем выбирать эндпоинт
OdiRouter документирует каталог моделей, доступный для текущего API-ключа. Его можно фильтровать по категории, провайдеру, модальности и ключевому слову. Проверьте этот каталог, прежде чем указывать идентификатор модели в коде приложения. Скопированный с другой платформы идентификатор может не разрешаться в маршрут OdiRouter.
Для видеопроекта найдите нужного провайдера и возможность преобразования изображения в видео. Откройте документацию соответствующей модели OdiRouter и отметьте идентификатор модели, формат запроса, требования к входным данным, ограничения на выходные данные, актуальную информацию о ценах и путь к статусу задачи. OdiRouter публично документирует связанные видеомодели Seedance, включая seedance-1-5-pro и seedance-2-0-fast. Это показывает, что рабочие процессы для конкретных видеомоделей документированы. Это не означает, что каждый вариант Seedance, названный во внешних источниках, доступен каждой учётной записи.
Используйте OdiRouter models page в качестве точки входа в публичный каталог и model-list documentation, когда требуется запрос к каталогу. Выбрав доступную модель, создайте API-ключ и ознакомьтесь со схемой этой модели.
Используйте справочную карточку как контрольный список входных данных
Справочная страница для этого запроса описывает текстовый промпт, начальное изображение, необязательное последнее изображение, длительность, соотношение сторон, разрешение и аудио. Это полезные пункты для сверки с выбранной вами моделью OdiRouter. Это не переносимый контракт запроса.
Перед первым запросом воспользуйтесь документацией к выбранной модели OdiRouter и ответьте на следующие вопросы:
Какое поле содержит первое эталонное изображение и может ли модель принимать второе изображение?
Какое поле подсказки описывает сцену, движение камеры, действия объекта, освещение и звук?
Какие параметры длительности, соотношения сторон, разрешения и качества звука поддерживает эта модель?
Требуется ли загрузка файла, указание ссылки на ресурс или общедоступный URL-адрес изображения?
Какие поля идентификатора запроса, URL статуса, URL ответа или обратного вызова позволяют приложению отслеживать задачу?
Запрос может быть корректным JSON, но всё же не подходить для выбранной модели. Seedance 1.5 Pro documentation приводит один пример специфичных для модели полей запроса, а также URL для асинхронного запроса, статуса, ответа и отмены. Используйте документацию для модели, которую возвращает проверка вашего каталога.
Сначала проведите небольшой тест
Используйте одно чёткое эталонное изображение и короткий промпт, определяющий объект, сцену, движение и замысел для камеры. Сделайте первый запуск достаточно небольшим, чтобы можно было понять, почему изменился результат. Изменяйте по одному параметру за раз, например длительность, соотношение сторон, разрешение, выбор изображения или аудио.
Сохраните ID модели, ссылку на входной ресурс, версию промпта, выбранные параметры, ID запроса, время отправки, итоговый статус и расположение результата. Это обеспечит чистое сравнение при проведении второго теста. Это также даст следующему участнику команды достаточно контекста, чтобы воспроизвести результат.
Не ожидайте, что модель преобразования изображения в видео сохранит каждую деталь эталонного изображения. Протестируйте композицию, идентичность объекта, текст на изображении, движение камеры и поведение аудио, важные для функции. Если выбранная модель поддерживает первый и последний кадры, отдельно протестируйте непрерывность, а не только анимацию на основе одного изображения.
Рассматривайте генерацию видео как асинхронную задачу
В документированном примере видео Seedance от OdiRouter возвращаются ID запроса и URL ответа, статуса и отмены. Интеграция для промышленного использования должна сохранять ID запроса при отправке задачи, а затем следовать документированному для модели процессу получения статуса, пока задача не достигнет конечного состояния. Конкретные поля и порядок повторных попыток зависят от документации модели.
Отделяйте отображаемый пользователю статус от исходного статуса провайдера. Приложение может сообщать, что генерация поставлена в очередь, выполняется, завершена или завершилась ошибкой, тогда как его сервер сохраняет документированную запись запроса для устранения неполадок. В случае сбоя задания сохраните идентификатор модели и метаданные безопасного запроса, изучите документированный ответ об ошибке и повторите попытку только в тех случаях, когда это разрешено документацией.
Проверяйте актуальные цены с учётом вашей конфигурации
В документе OdiRouter отмечается, что стоимость мультимодальных задач может зависеть от выбранной модели и типа запроса. Параметры генерации, продолжительность, разрешение и количество результатов могут иметь значение. Прежде чем увеличивать длительность, разрешение или размер пакета, проверьте актуальные OdiRouter pricing page и сведения о ценах выбранной модели.
Используйте первый небольшой запуск как базовый ориентир. Оценивайте рабочий процесс продукта по настройкам, которые вы планируете выпустить, а не по приведённому примеру на внешней карточке модели. При изменении каталога или цен повторите проверку доступности перед новым выпуском.
Контрольный список перед запуском
Прежде чем считать рабочий процесс преобразования изображения в видео готовым, подтвердите следующее:
Текущий каталог OdiRouter показывает модель, соответствующую требуемым возможностям для используемого API-ключа.
Запрос соответствует схеме OdiRouter этой модели, а не скопированной сторонней конечной точке.
Небольшой тест с эталонным изображением фиксирует входные данные, настройки вывода, ID запроса, статус и результат.
Команда продукта проверила актуальные цены для выбранной модели и конфигурации.
Приложение следует документированному жизненному циклу задачи и поведению при ошибках выбранной модели.
Прочитайте OdiRouter getting-started guide, сравните актуальные варианты в OdiRouter models и используйте документацию выбранной модели как основной источник истины при реализации.