wan2.7-image-pro API

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

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

Параметры: size=2Kn=1

Промпт: Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.

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

{
  "model": "wan2.7-image-pro",
  "prompt": "Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.",
  "n": 1,
  "size": "2K"
}

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

Используйте ключ 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-pro",
    "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-pro
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-pro",
    "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-pro", "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-pro", "input": {"messages": [{"role": "user", "content": [{"text": "生成四张角色一致的季节分镜"}]}]},
    "parameters": {"size": "2K", "enable_sequential": true, "n": 4, "watermark": false}
  }'

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

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

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

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

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

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

Заметка

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

Варианты

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