Seedance 2.0 API Image to Video Turbo | OdiRouter

Редакция OdiRouter

Поиск API Seedance 2.0 Image to Video Turbo следует начинать с идентификатора модели, который в настоящее время указан как OdiRouter. Поисковая фраза — не конфигурация для промышленного использования. OdiRouter документирует Seedance 2.0 и Seedance 2.0 Fast. Проверьте models list перед отправкой производственного трафика.

В этой статье seedance-2-0-fast используется как документированный пример. Если каталог указывает на другой проверенный идентификатор модели OdiRouter, схема работы остаётся привычной: подготовьте content, создайте задачу, проверьте её статус и получите результат.

Подтвердите модель и выберите роль входных данных

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

  • Используйте одно изображение в качестве начального кадра с first_frame или применяйте документированное поведение по умолчанию, если оно применимо.

  • Используйте first_frame и last_frame, когда нужно контролировать оба конца кадра.

  • Используйте один или несколько входов reference_image, когда визуальный ориентир важнее точного начального или конечного кадра.

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

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

Напишите промпт, который работает с изображением

Опишите нужный результат, затем добавьте указания по движению и работе камеры. Укажите объект, действие, окружение, освещение, поведение камеры и любые ограничения, важные для кадра. Промпт должен работать с изображением. Если изображение задаёт продукт, человека или композицию, опишите движение вокруг этого визуального якоря, а не запрашивайте другую сцену.

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

Отправьте задачу в очередь через OdiRouter

Документированный маршрут seedance-2-0-fast создаёт задачу по адресу POST /v1/queue/seedance-2-0-fast в рамках базового URL API модели OdiRouter. Замените шаблонный API-ключ и пример URL изображения на значения, которыми вы управляете. Не храните настоящий ключ в клиентском коде, публичных репозиториях и запросах в службу поддержки.

curl --request POST \
  'https://api.odirouter.ai/model/v1/queue/seedance-2-0-fast' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "content": [
      {
        "type": "text",
        "text": "A product bottle turns slowly on a studio table, soft side light, clean background, controlled camera move"
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/reference-image.png"
        },
        "role": "first_frame"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'

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

Проверьте статус, прежде чем получать результат

Генерация видео из изображения выполняется асинхронно. После создания задачи вызовите документированный эндпоинт статуса, указав ID запроса. После завершения задачи вызовите эндпоинт результата. Справочник seedance-2-0-fast документирует эти маршруты:

GET /v1/queue/seedance-2-0-fast/requests/{request_id}/status
GET /v1/queue/seedance-2-0-fast/requests/{request_id}/response
PUT /v1/queue/seedance-2-0-fast/requests/{request_id}/cancel

Используйте ограниченный опрос в своём сервисе. Сохраните идентификатор запроса и состояние терминала, остановитесь после зафиксированного сбоя или отмены и покажите оператору ответ поставщика без регистрации заголовков авторизации. Для устранения неполадок сохраните идентификатор модели, идентификатор запроса, HTTP-статус, время и отредактированное сообщение об ошибке.

Выберите маршрут OdiRouter из актуальной документации

Используйте Seedance 2.0 model reference, если это проверенный маршрут для данной задачи. Используйте Seedance 2.0 Fast model reference, если именно этот маршрут вы намерены протестировать. OdiRouter документирует отдельные пути очереди, поэтому выбирайте маршрут в конфигурации, а не копируйте эндпоинт у несвязанного поставщика API.

Перед развёртыванием в production подтвердите следующее в актуальной документации OdiRouter:

  1. Текущий каталог содержит точный ID модели.

  2. Модель поддерживает нужную вам комбинацию входных данных и роль изображения.

  3. Маршрут документирует нужные вам соотношение сторон, разрешение и длительность.

  4. Сервис сохраняет ID задачи и обрабатывает состояния статуса, результата, отмены и ошибки.

  5. API-ключи остаются на стороне сервера и маскируются в журналах и заявках в службу поддержки.

Источники

#API Seedance 2.0 Image to Video Turbo#API преобразования изображения в видео#OdiRouter#Seedance 2.0