Wan 2.7 Image to Video

wan2.7-i2v Wan 2.7 Image to Video адаптирует процесс анимации изображений Wan для международного использования. Она полезна для видеочерновиков на основе референсов и кросс-рыночного творческого тестирования.

Эндпоинты

POST /v1/queue/wan2.7-i2v # Создать задачу

GET /v1/queue/wan2.7-i2v/requests/{request_id}/status # Проверить статус

GET /v1/queue/wan2.7-i2v/requests/{request_id}/response # Получить результат

PUT /v1/queue/wan2.7-i2v/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://api.odirouter.ai/model/v1/queue/wan2.7-i2v" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "input": {
      "prompt": "A kitten runs across a grassy field.",
      "media": [
        {
          "type": "first_frame",
          "url": "https://xxx/xxx.png"
        }
      ]
    },
    "parameters": {
      "resolution": "1080P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": false,
      "seed": 12345
    }
  }'

input object required

Основная входная информация, например промпты.

prompt string

Текстовый промпт, описывающий ожидаемые элементы и визуальные особенности в генерируемом видео.

Поддерживаются китайский и английский языки. Максимальная длина — 5000 символов; каждый китайский иероглиф или буква считается одним символом. Содержимое сверх лимита автоматически обрезается.

Пример: Котенок бежит по травяному полю.

negative_prompt string

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

Поддерживаются китайский и английский языки. Максимальная длина — 500 символов. Содержимое сверх лимита автоматически обрезается.

Пример: низкое разрешение, ошибки, худшее качество, низкое качество, неполные детали, лишние пальцы, плохие пропорции и т. д.

media array required

Список медиа-материалов для задания референсов, необходимых для генерации видео: изображения, аудио и видео.

Каждый элемент массива — объект медиа с полями type и url.

Комбинации материалов: поддерживаются только следующие комбинации. Недопустимые комбинации вернут ошибку.

Генерация видео по первому кадру: first_frame или first_frame + driving_audio.

Генерация видео по первому и последнему кадру: first_frame + last_frame или first_frame + last_frame + driving_audio.

Продолжение видео: first_clip или first_clip + last_frame.

type string required

Тип медиа-материала.

Возможные значения: first_frame — первый кадр, last_frame — последний кадр, driving_audio — управляющее аудио, first_clip — начальный видеофрагмент.

Ограничение: каждый type может встречаться в массиве media не более одного раза. Например, нельзя передать два материала first_frame.

url string required

URL медиа-материала. Материалом может быть изображение, аудио или видео.

Передача изображения (type=first_frame или type=last_frame): URL первого или последнего кадра либо данные Base64. Сейчас поддерживается генерация по первому кадру и по первому с последним кадрам.

Ограничения изображений: форматы JPEG, JPG, PNG без прозрачного канала, BMP, WEBP; ширина и высота в диапазоне [240, 8000] пикселей; соотношение сторон 1:8 - 8:1; размер файла не более 20MB.

Форматы ввода изображения: публичный URL по HTTP или HTTPS, например https://xxx/xxx.png; или строка Base64 в формате data:{MIME_type};base64,{base64_data}, например data:image/png;base64,GDU7MtCZzEbTbmRZ.......

Передача аудио (type=driving_audio): URL аудиофайла. При наличии аудио модель использует его как управляющий источник для генерации. Если аудио не передано, модель автоматически создает подходящую фоновую музыку или звуковые эффекты по содержанию видео.

Ограничения аудио: форматы wav и mp3; длительность 2 - 30s; размер файла не более 15MB.

Обрезка аудио: если длина аудио превышает значение duration, например 5 секунд, сохраняются только первые 5 секунд. Если аудио короче длительности видео, часть после конца аудио будет без звука.

Формат ввода аудио: публичный URL по HTTP или HTTPS, например https://xxx/xxx.mp3.

Передача видео (type=first_clip): URL видеофайла. Модель продолжает генерацию на основе содержимого этого видео, а верхняя граница длительности продолжения управляется параметром duration.

Например, если duration=15, а входное видео длится 3 секунды, модель продолжит его на 12 секунд. Итоговое видео будет длиться 15 секунд и тарифицируется как 15 секунд.

Ограничения видео: форматы mp4 и mov; длительность 2 - 10s; ширина и высота в диапазоне [240, 4096] пикселей; соотношение сторон 1:8 - 8:1; размер файла не более 100MB.

Формат ввода видео: публичный URL по HTTP или HTTPS, например https://xxx/xxx.mp4.

parameters object

Параметры обработки видео: разрешение, длительность, интеллектуальное расширение prompt, водяной знак и другие настройки.

resolution string

Важно: resolution напрямую влияет на стоимость. Перед вызовом API проверьте цену модели.

Задает уровень разрешения генерируемого видео и управляет четкостью через общее число пикселей.

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

Возможные значения: 720P, 1080P (по умолчанию).

duration integer

Важно: duration напрямую влияет на стоимость и тарифицируется посекундно. Перед вызовом API проверьте цену модели.

Длительность генерируемого видео в секундах.

Целое число в диапазоне [2, 15]. По умолчанию: 5.

prompt_extend boolean

Включать ли интеллектуальное расширение prompt. При включении большая модель переписывает входной prompt. Для коротких prompt это заметно улучшает результат, но увеличивает задержку.

true: значение по умолчанию, включить расширение prompt.

false: выключить расширение prompt.

watermark boolean

Добавлять ли водяной знак. Водяной знак расположен в правом нижнем углу видео, фиксированный текст — «AI生成».

false: значение по умолчанию, не добавлять водяной знак.

true: добавить водяной знак.

seed integer

Случайное зерно. Диапазон: [0, 2147483647].

Если параметр не указан, система автоматически генерирует случайное зерно. Чтобы повысить воспроизводимость результата, рекомендуется фиксировать значение seed.

Примечание: генерация имеет вероятностный характер. Даже при одинаковом seed полное совпадение результата не гарантируется.

Параметры ответа

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-i2v/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-i2v/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/wan2.7-i2v/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи для последующей проверки статуса, получения результата и отмены
`response_url`	string	URL для получения итогового результата
`status_url`	string	URL для проверки статуса задачи
`cancel_url`	string	URL для отмены задачи
`queue_position`	int	Текущая позиция в очереди

Следующие операции