Wan 2.5 Preview Image to Video

wan2.5-i2v-preview Wan 2.5 Image to Video Preview превращает референсные изображения в визуально связное движение; полезна для быстрых превью движения, кадров для продуктов, кадров с персонажами и черновых роликов для разных рынков.

Эндпоинты

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

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

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

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

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

curl --location "https://api.odirouter.ai/model/v1/queue/wan2.5-i2v-preview" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "input": {
      "prompt": "A kitten runs across a grassy field.",
      "img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"
    },
    "parameters": {
      "resolution": "1080P",
      "duration": 5,
      "prompt_extend": true,
      "watermark": false,
      "seed": 12345
    }
  }'

input object required

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

prompt string

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

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

Ограничение длины: до 1500 символов.

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

negative_prompt string

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

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

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

img_url string required

URL изображения первого кадра или данные Base64.

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

Поддерживаются публичные URL по HTTP или HTTPS. Пример: https://cdn.translate.alibaba.com/r/wanx-demo-1.png.

Поддерживаются строки Base64 в формате data:{MIME_type};base64,{base64_data}.

audio_url string

URL аудиофайла. Модель использует это аудио для генерации видео.

Поддерживаются публичные URL по HTTP или HTTPS. Пример: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/xxx.mp3.

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

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

parameters object

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

resolution string

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

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

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

Пример: 1080P.

duration integer

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

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

Возможные значения: 5, 10. По умолчанию: 5.

Пример: 5.

prompt_extend boolean

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

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

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

Пример: true.

watermark boolean

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

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

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

Пример: false.

seed integer

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

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

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

Пример: 12345.

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

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/wan2.5-i2v-preview/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/wan2.5-i2v-preview/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/wan2.5-i2v-preview/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	Текущая позиция в очереди

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