Skip to main content
POST

Авторизация

string
обязательно
Все запросы требуют аутентификации Bearer Token.Перейдите на страницу управления API ключами, чтобы получить свой API Key, затем добавьте его в заголовок запроса:

Доступные модели

Тарификация рассчитывается как успешно сгенерированные изображения × цена за единицу. Входные данные не тарифицируются. Разрешение и соотношение сторон не влияют на стоимость. Неудачные запросы не оплачиваются.

Тело запроса

string
обязательно
Название модели генерации изображений.
  • wan2.7-image-pro — профессиональная редакция, до 4K для text-to-image
  • wan2.7-image — стандартная редакция, более быстрая, до 2K
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
Текстовое описание для генерации изображения, до 5000 символов.
  • Text-to-image (без image_urls): обязательно
  • Редактирование изображенияimage_urls): необязательно, но рекомендуется
Пример: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
array<string>
Массив URL входных изображений для сценариев редактирования и мультиизображенческих референсов.Указание этого поля переключает запрос в режим редактирования изображения.Поддерживаемые форматы: HTTP/HTTPS URL; data:image/...;base64,... Base64Ограничения: до 9 изображений; JPEG / PNG / WEBP / BMP; 240–8000 px, соотношение сторон 1:8 ~ 8:1; ≤ 20MB на изображение
Соотношение сторон вывода автоматически соответствует последнему входному изображению. Режим редактирования поддерживает только до 2K — 4K недоступно.
integer
по умолчанию:"1"
Количество генерируемых изображений.
  • Стандартный режим: 1–4 (по умолчанию 1)
  • Последовательный режим (enable_sequential: true): 1–12 (по умолчанию 1)
Тарификация за каждое успешно сгенерированное изображение. Предоплата на основе n.
string
Выходное разрешение или соотношение сторон. Поддерживает три формата:① Ключевое слово разрешения (рекомендуется): 1K / 2K (по умолчанию) / 4K (только text-to-image для wan2.7-image-pro)② Соотношение сторон: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (по умолчанию уровень 2K)③ Размеры в пикселях: 1024x1024 или 1024*1024
string
Ключевое слово уровня разрешения: 1K / 2K / 4K. Можно сочетать с size (соотношение сторон).
string
Негативный промпт, описывающий элементы, которых следует избегать. Пример: "blurry, distorted, low quality"
boolean
по умолчанию:"false"
Добавлять ли водяной знак “AI Generated” в правый нижний угол.
integer
Случайное зерно, диапазон 0–2147483647. Одно и то же зерно с идентичными параметрами даёт визуально согласованные результаты.
boolean
по умолчанию:"true"
Включить улучшенный режим рассуждения для повышения качества изображения за счёт увеличения времени генерации.
Действует только когда последовательный режим отключён и не передано входное изображение.
boolean
по умолчанию:"false"
Включить режим последовательной генерации изображений — генерирует несколько тематически связных изображений за один запрос. Идеально для раскадровок и серий.
  • Максимум n равен 12 при включении
  • thinking_mode и color_palette игнорируются в последовательном режиме
  • wan2.7-image-pro поддерживает до 2K в последовательном режиме (4K не поддерживается)
array
Ограничивающие рамки для интерактивного редактирования — задаёт точные области для редактирования или вставки контента.Структура: [[[x1, y1, x2, y2], ...], ...]
  • Длина внешнего массива должна совпадать с длиной image_urls
  • Передавайте [] для изображений без ограничивающей рамки
  • Максимум 2 рамки на изображение; координаты — абсолютные значения в пикселях, начало координат (0,0) в левом верхнем углу
Пример: [[], [[989, 515, 1138, 681]]]
array<object>
Пользовательская цветовая тема. Только стандартный режим (не последовательный режим).
  • 3–10 записей (рекомендуется 8); каждая запись требует hex и ratio
  • Сумма всех значений ratio должна быть точно равна 100.00%

Ответ

string
Статус ответа. Возвращает "success" при успехе.
array

Примеры

Text-to-image (минимальный)

Text-to-image (с разрешением)

Text-to-image (пользовательская цветовая палитра)

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

Редактирование одного изображения

Мультиизображенческий референс / объединение элементов

Интерактивное редактирование (ограничивающая рамка)

bbox_list соответствует image_urls один к одному. Передавайте [] для изображений без выделения.
Запрос результатовГенерация изображений выполняется асинхронно. Опрашивайте конечную точку статуса задачи, используя возвращённый task_id, пока status == completed.