Перейти к основному содержанию
POST

Авторизация

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

Body

string
по умолчанию:"mai-image-2.7"
обязательно
Название модели генерации изображенийВозможности и параметры обеих моделей полностью совпадают.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание изображения или инструкция по редактированию
  • Поддерживаются китайский и английский, рекомендуются подробные описания
  • Не более 20 000 символов; при превышении возвращается 400
  • Не может быть пустым или состоять только из пробелов
integer
по умолчанию:"1"
Количество генерируемых изображенийЗначение: 1
За один запрос создаётся только 1 изображение — для нескольких изображений отправляйте отдельные задачи; значения 0, отрицательные или больше 1 возвращают 400
string
по умолчанию:"1:1"
Соотношение сторон или размер в пикселях; действует только при генерации по текстуПоддерживаются два формата:
  • Соотношение сторон: любое отношение целых чисел от 1:4 до 4:1, например 1:1, 16:9, 9:16, 21:9; вместе с resolution определяет фактические пиксели
  • Размер в пикселях: ширинаxвысота (также ширина*высота, ширина×высота), например 2048x1152; в этом случае resolution игнорируется
Ограничения размера в пикселях:
  • Ширина и высота — не менее 768
  • Ширина × высота — не более 4 194 304 (2048×2048)
  • Ширина и высота по отдельности округляются вниз до кратного 32, например 1000x1000 даёт на выходе 992x992
Примеры: ✅ 2048x2048, 2048x1152, 2560x1536; ❌ 512x512 (сторона меньше 768), 2080x2048 (превышено общее число пикселей)
auto не поддерживается и возвращает 400
string
по умолчанию:"1K"
Уровень разрешения вывода; действует только когда size задан как соотношение сторонВарианты: 1K / 2K (допускается нижний регистр)Сопоставление size × resolution → фактические пиксели:
4K не поддерживается, другие уровни возвращают 400. Поскольку короткая сторона — минимум 768, при соотношениях вытянутее 2:1 фактическое число пикселей на уровне 1K превышает примерно 1 миллион.
integer
Точная ширина в пикселях, передаётся только вместе с height
  • Наивысший приоритет: при одновременной передаче переопределяет size и resolution
  • Ограничения те же, что и для размера в пикселях в size: ширина и высота ≥ 768, общее число пикселей ≤ 4 194 304
  • Действует только при генерации по тексту
integer
Точная высота в пикселях, передаётся только вместе с width, ограничения как у width
array
Массив референсов; при наличии включается режим генерации по изображению
  • 1 изображение — редактирование одного изображения, несколько — композиция из нескольких изображений
string
Тип фонаВарианты: auto / opaque — результат такой же, как без параметра
Прозрачный фон transparent пока недоступен; передача transparent или других значений возвращает 400
auto_aspect_ratio: true и web_grounding: true не поддерживаются и возвращают 400. quality, style, output_format, response_format, mask_url не поддерживаются и игнорируются. Вывод всегда в формате PNG.

Примеры использования

Генерация по тексту (минимальный запрос) По умолчанию 1:1 + 1K, на выходе 1024×1024.
Генерация по тексту (соотношение сторон + 2K)
Генерация по тексту (точные пиксели)
Редактирование одного изображения
Композиция из нескольких изображений (URL + base64 в смешанном виде)

Response

integer
Код состояния ответа
array
Массив данных ответа

Запрос результатов задачи

После успешной отправки возвращается task_id. Опрашивайте статус задачи через GET /v1/tasks/{task_id}, подробнее см. в API запроса задач. Рекомендуется опрашивать каждые 3–5 секунд с общим тайм-аутом 3 минуты.

Пример успешного ответа

Доступ к изображению: data.result.images[0].url[0]. Ссылка на изображение перестаёт действовать после expires_at, поэтому скачайте и сохраните его как можно скорее.

Статусы задачи