API Seedance для преобразования изображений в видео: текущее руководство OdiRouter

Редакция OdiRouter

Если вы перешли по объявлению ByteDance Seedance V1 Pro I2V 1080p, используйте название этой версии как подсказку для поиска устаревшей версии. Это не доказывает, что старая модель доступна сейчас. В каталоге и документации OdiRouter, зафиксированных для этого руководства, указаны Seedance 1.5 Pro и Seedance 2.0. Они не подтверждают текущую доступность OdiRouter для Seedance V1 Pro.

Для команды, создающей рабочий процесс, полезно выяснить, какой актуальный API Seedance для преобразования изображений в видео принимает имеющиеся у вас входные данные и как устроен его поток обработки задач. Это руководство основано на актуальной документации OdiRouter. Оно не переносит утверждения третьих лиц о бенчмарках, частоте артефактов, ценах или доступности.

Сначала проверьте актуальные страницы моделей

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

В справочных документах Seedance 1.5 Pro указаны входные параметры text, image и video. В списке также указаны варианты разрешения 480p, 720p и 1080p. Это сведения, зависящие от конкретной модели. Перед созданием рабочего процесса или описанием формата выходных данных для клиента, перепроверьте таблицу параметров.

Подберите модель, соответствующую задаче.

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

У Seedance 2.0 есть собственная страница модели и конечная точка очереди. В его справочной документации указаны массив content и входные данные в виде референс-видео. Ознакомьтесь с этой страницей, когда нужно проверить, соответствует ли запрос требованиям к медиафайлам и длительности.

Не считайте название модели, заявление о разрешении или дату старого анонса актуальным подтверждением свойств продукта. Перед принятием операционного решения проверьте активную страницу модели, её справочник API и OdiRouter pricing page.

Отправьте задание в очередь

В OdiRouter мультимодальная генерация описана как асинхронный процесс через очередь. В справочнике Seedance 1.5 Pro сейчас указан следующий эндпоинт:

POST https://api.odirouter.ai/model/v1/queue/seedance-1-5-pro
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

В эталонном теле запроса используется массив content. Точные поля сверяйте с актуальной справочной документацией. Документированная структура запроса с приоритетом текста выглядит так:

{
  "content": [
    {
      "type": "text",
      "text": "Describe the motion and scene you need."
    }
  ],
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 5,
  "generate_audio": true
}

Храните действительный API-ключ в среде выполнения. Не размещайте его в клиентском коде, тикетах, статьях или журналах.

Разделяйте отправку и завершение

В задокументированном ответе указаны номера request_id, status_url, response_url и cancel_url. Сохраните идентификатор запроса в своей записи о задании. Опросите URL-адрес состояния в соответствии с текущими рекомендациями API, а затем получите завершенный результат из URL-адреса ответа.

Отправленное задание было принято. Это ещё не законченное видео. Ваше приложение должно отображать состояние задания, обрабатывать сбои и не представлять незавершённый запрос как готовый ресурс.

Для общей последовательности работы с очередью используйте Submit a multimodal task. Справочники для конкретных моделей остаются источником истины для имён эндпоинтов, полей запросов, ограничений на входные данные и поддерживаемых параметров.

Используйте этот контрольный список для оценки.

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

  1. Модель присутствует в актуальном каталоге OdiRouter.

  2. Тело запроса соответствует актуальной справочной документации API для конкретной модели.

  3. Входные медиафайлы соответствуют документированным ограничениям по типу, размеру, длительности и разрешению.

  4. Обработчик заданий записывает идентификатор запроса и использует документированные URL-адреса статуса и результата.

  5. Коммерческие предположения основаны на актуальной информации о ценах, а не на старой статье или близкой модели.

Этот контрольный список не прогнозирует качество, не ранжирует модели и не гарантирует результат. Он даёт команде способ перейти от устаревшего поискового запроса к актуальной документации.

Источники

#API преобразования изображений в видео#API преобразования изображений в видео Seedance#OdiRouter#Seedance 1.5 Pro#Seedance 2.0