wan2.7-image API

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

Пример выводаwan2.7-imagePOST /v1/images/generations

Параметры: size=1536x1024n=1

Промпт: A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.

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

{
  "model": "wan2.7-image",
  "prompt": "A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

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

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

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать изображение

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

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

Модели изображений, совместимые с OpenAI, используют prompt, n, size и quality; используйте редактирование только тогда, когда это документировано на официальной странице.

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

Wan2.7 Image/Pro использует API синхронных изображений. Используйте плоскую форму, совместимую с OpenAI, для простых вызовов; используйте input.messages плюс parameters для редактирования нескольких изображений, редактирования регионов и последовательной генерации. Преобразование текста в изображение Pro поддерживает разрешение до 4K вне последовательного режима; стандартная модель поддерживает до 2K.

Поле	Обязательно	Примечания
model	Да	wan2.7-image
prompt	Да	Инструкция по созданию или редактированию
image	Нет	URL-адрес одного изображения/Base64; используйте input.messages для максимум 9 изображений
input.messages	Нет	Вложенные сообщения для нескольких изображений, редактирования регионов и последовательной генерации.
size	Нет	1K/2K; Непоследовательное преобразование текста в изображение Pro также поддерживает 4K
n	Нет	1–4 для обычной генерации; 1–12 для последовательной генерации; оплата за успешное изображение
thinking_mode	Нет	Режим мышления, когда изображение не предоставлено
watermark	Нет	Добавлять ли водяной знак
parameters.prompt_extend	Нет	Расширение подсказки, по умолчанию true;
parameters.bbox_list	Нет	Интерактивное редактирование полей регионов
parameters.enable_sequential	Нет	Включить последовательную генерацию
parameters.color_palette	Нет	3–10 HEX-цветов с общим процентным содержанием 100 %.

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

Используйте плоскую форму для простых звонков; используйте input.messages и parameters для редактирования нескольких изображений, редактирования регионов и последовательной генерации. Поддерживается до 9 входных изображений, каждое размером менее 20 МБ, размером 240–8 000 пикселей по краю, с соотношением сторон от 1:8 до 8:1. Обычный счетчик вывода — 1–4, а счетчик последовательного вывода — 1–12; Преобразование текста в изображение Pro поддерживает разрешение 4K вне последовательного режима, тогда как другие комбинации достигают максимального разрешения 2K.

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

Wan2.7 Изображение поддерживает как плоскую форму, так и вложенную форму input.messages/parameters; используйте вложенную форму для редактирования нескольких изображений, редактирования областей и последовательной генерации.

Редактирование нескольких изображений

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/person.png"},
      {"image": "https://example.com/background.png"},
      {"text": "将图 1 中的人物放入图 2 的场景中"}
    ]}], "parameters": {"size": "2K", "n": 1, "prompt_extend": true}}
  }'

Интерактивное редактирование региона

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image", "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/room.png"},
      {"text": "将选中区域的花瓶替换成红玫瑰"}
    ]}], "parameters": {"size": "2K", "n": 1, "bbox_list": [[[420, 280, 760, 720]]]}}
  }'

Последовательная группа изображений

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image", "input": {"messages": [{"role": "user", "content": [{"text": "生成四张角色一致的季节分镜"}]}]},
    "parameters": {"size": "2K", "enable_sequential": true, "n": 4, "watermark": false}
  }'

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

Неверные параметры модели возвращают 4xx с идентификатором запроса; используйте поля ответа и сообщение об ошибке, определенные выбранным типовым контрактом.

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

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

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

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

Заметка

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

Варианты

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