wan2.7-r2v API

Используйте точный идентификатор модели wan2.7-r2v. Поле модели должно точно соответствовать этой странице.

Пример выводаwan2.7-r2vPOST /v1/videos5.0s

Параметры: duration=5resolution=1080Pratio=16:9Эталонное изображение

Промпт: One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.

Запрос, в результате которого был создан этот образец, с заменой входного URL-адреса мультимедиа.

{
  "model": "wan2.7-r2v",
  "input": {
    "prompt": "One continuous take, no cuts. Keep the glass flowers from the reference exactly as they are and carry them into a new place: a wide city crossing at night in the rain. The whole bed of glass blooms now grows straight out of the wet asphalt across the junction, ringing as the rain strikes them, headlights firing caustics along the road. The camera starts at kerb height among the stems, moves forward through them and rises to look down the length of the crossing. One hard pink key from a shopfront on the left, cold blue signals behind. Real weight and inertia, glass and water, no text.",
    "media": [
      {
        "type": "reference_image",
        "url": "https://example.com/input-image.png"
      }
    ]
  },
  "parameters": {
    "duration": 5,
    "resolution": "1080P",
    "ratio": "16:9"
  }
}

Аутентификация и конечная точка

Используйте ключ API Modelflare с https://modelflare.dev/v1. Точка входа шлюза — POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать задачу

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "input": {"prompt": "The subject in Image 1 walks through the street from Video 1.", "media": [{"type": "reference_image", "url": "https://example.com/reference.png"}, {"type": "reference_video", "url": "https://example.com/reference.mp4"}]},
    "parameters": {"resolution": "1080P", "ratio": "16:9", "duration": 5, "prompt_extend": false, "watermark": false}
  }'

Опрос и загрузка

Сохраните идентификатор задачи. Опросите GET /v1/videos/{task_id} и загрузите с помощью GET /v1/videos/{task_id}/content. Срок действия URL-адресов результатов может истечь, поэтому передайте файл как можно скорее.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Запросить примечания

Wan обычно использует input и parameters; Режимы с кадровым управлением и эталонным носителем нельзя смешивать.

Запрос параметров

Wan2.7 R2V использует носитель reference_image/reference_video и может подключать reference_voice. Не смешивайте этот рабочий процесс с ролями first_frame/last_frame.

Поле	Обязательно	Примечания
model	Да	wan2.7-r2v
input.prompt	Да	Опишите сцену и справочные материалы, используя документированный синтаксис.
input.media[]	Да	Хотя бы один reference_image или reference_video
input.media[].reference_voice	Нет	Публичный URL-адрес WAV/MP3 для характеристик голоса
parameters.resolution	Нет	720P / 1080P (по умолчанию 1080P)
parameters.ratio	Нет	16:9 / 9:16 / 1:1 / 4:3 / 3:4 (игнорируется, если присутствует first_frame)
parameters.duration	Нет	Используйте более короткий предел продолжительности при наличии эталонного видео.
parameters.prompt_extend	Нет	Установите значение false, если этого требует специальный типовой контракт.
parameters.watermark	Нет	Добавлять ли водяной знак
parameters.seed	Нет	Необязательное случайное начальное число

Пределы ввода и вывода

R2V требует как минимум одного reference_image или reference_video с не более чем пятью эталонными изображениями/видео вместе взятыми. Можно прикрепить один first_frame и reference_voice; предел продолжительности короче, если присутствует эталонное видео.

Документированные примеры рабочих процессов

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "input": {"prompt": "让图像主体沿视频动作自然移动", "media": [
      {"type": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "prompt_extend": false}
  }'

Ошибки и невыполненные задачи

Неверные параметры модели возвращают 4xx с идентификатором запроса. Асинхронная задача также может оказаться неудачной после успешного создания; используйте error_code и error_message из ответа на опрос в качестве окончательной причины задачи. Не повторяйте тот же запрос с другой формой JSON.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

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

Заметка

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

Варианты

Идентификатор модели	Разница
wan2.7-r2v	Модель, описанная на этой странице.