wan3.0-video API

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

Пример выводаwan3.0-videoPOST /v1/videos5.0s

Параметры: duration=5resolution=1080Pratio=16:9

Промпт: Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.

Запрос, по которому был создан этот образец

{
  "model": "wan3.0-video",
  "prompt": "Macro slow-motion shot of steamed milk poured into a ceramic cup of espresso, forming a rosetta latte art pattern. Warm morning light from a window, wooden counter, soft steam rising, shallow depth of field, commercial food photography, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080P",
  "ratio": "16:9",
  "aspect_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": "wan3.0-video",
    "input": {"prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"},
    "parameters": {"resolution": "1080P", "duration": 5, "audio": true}
  }'

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

Сохраните идентификатор задачи. Опросите 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; Режимы с кадровым управлением и эталонным носителем нельзя смешивать.

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

Wan3.0 использует input.prompt или input.media с элементами управления выходом в parameters. Медиафайлы могут представлять собой кадры, ссылки, аудио, файлы или веб-страницы.

Поле	Обязательно	Примечания
model	Да	wan3.0-video
input.prompt	Условно	Предоставьте это или input.media
input.media[]	Условно	first_frame, last_frame, reference_*, file или link
parameters.resolution	Нет	480P / 720P / 1080P (по умолчанию 1080P)
parameters.ratio	Нет	16:9 / 9:16 / 1:1 / 4:3 / 3:4 / adaptive
parameters.duration	Нет	2–30 секунд или -1 для автоматической продолжительности.
parameters.audio	Нет	Генерировать ли синхронизированный звук
parameters.prompt_extend	Нет	Установите значение false, если этого требует специальный типовой контракт.
parameters.seed	Нет	Необязательное случайное начальное число
parameters.watermark	Нет	Добавлять ли водяной знак

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

Wan3.0 поддерживает текст, первый/последний кадры, до 10 эталонных изображений, 5 эталонных видео, 5 эталонных аудиоклипов и один входной файл или веб-страницу. Выходное разрешение — 480P, 720P или 1080P в течение 2–30 секунд или автоматическая синхронизация -1. Первый/последний кадры, эталонные носители, файлы и веб-страницы — это взаимоисключающие рабочие процессы, выбранные input.media[].type.

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

Wan3.0 использует один конверт input/parameters для текста, указаний по кадрам, справочных материалов, файлов и веб-страниц; эти рабочие процессы являются взаимоисключающими.

Первый и последний кадры

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "镜头从第一帧平滑推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "ratio": "adaptive", "audio": true}
  }'

Справочные СМИ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": {"prompt": "保持角色、动作和音色一致", "media": [
      {"type": "reference_image", "url": "https://example.com/character.png"},
      {"type": "reference_video", "url": "https://example.com/motion.mp4"},
      {"type": "reference_audio", "url": "https://example.com/voice.mp3"}
    ]},
    "parameters": {"resolution": "720P", "duration": -1, "ratio": "adaptive"}
  }'

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

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

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

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

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

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

Заметка

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

Варианты

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