MAI Image 2.6 API: генерация, редактирование и задачи

Первое решение при интеграции MAI Image 2.6 — выбрать контракт сервиса, который будет использовать приложение. Microsoft документирует генерацию и редактирование через Foundry. На reAPI обе операции используют эндпоинт генерации изображений: для редактирования добавьте URL референсов, затем опрашивайте возвращенный идентификатор задачи. Названия моделей у сервисов похожи, но аутентификация, тела запросов и ответы не взаимозаменяемы.^[1]

Это руководство следует контракту reAPI для mai-image-2.6. Начните с одного текстового запроса, прежде чем добавлять обработку референсов или автоматическое кадрирование. Так при ошибке будет проще проверить небольшую интеграцию. Держите рядом с реализацией полный справочник параметров; песочница MAI Image 2.6 предоставляет те же настройки и текущие оценки стоимости.^[2]

Основные положения

• Отправьте mai-image-2.6 с непустым промптом в эндпоинт images. Один запрос создает одно изображение.^[2]
• Используйте соотношение сторон с 1K или 2K либо допустимые парные размеры в пикселях. Эндпоинт не принимает 4K.^[2]
• Для редактирования передайте до пяти общедоступных URL изображений в заданном порядке. При наличии референсов размер результата выбирает модель.^[2]
• Сохраните идентификатор задачи и опрашивайте ее до completed или failed. Сам ответ на отправку не содержит готового изображения.^[2]
• Считайте показанную стоимость оценкой. При завершении резерв уточняется; точные данные доступны через ?include=billing.^[2]

Отправьте первый запрос MAI Image 2.6

Создайте ключ reAPI и сохраните его в серверном окружении как REAPI_API_KEY. Запросу нужны модель и непустой промпт. Пример запрашивает квадратное изображение с явными размерами, чтобы нужный холст было легко проверить. Это пример запроса, а не обещание, что каждый сгенерированный объект идеально совпадет с описанием.

curl https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.6",
    "prompt": "A matte ivory ceramic teapot on a pale blue table, soft daylight, product photography.",
    "width": 1024,
    "height": 1024,
    "n": 1
  }'

В идентификаторе API перед 6 стоит точка. URL страницы модели использует /models/mai-image-2-6; если скопировать этот slug с дефисами в запрос, получится другая строка. Сразу после успешной отправки сохраните возвращенный id задачи. Он нужен для получения результата, определения ошибки или восстановления после разрыва соединения клиента. Один запрос создает одно изображение; увеличение n не превращает его в поддерживаемую пакетную генерацию.^[2]

Не помещайте ключ в код браузера. Фронтенд может передать описание пользователя на бэкенд, который добавит Bearer-токен и отправит запрос. В зависимости от схемы доступа верните фронтенду идентификатор задания приложения или задачи. Не включайте ключ в строку запроса, скриншот или скопированный отчет об ошибке.

Опрашивайте уже отправленную задачу

Успешная отправка подтверждает прием запроса, но не возвращает готовое изображение. Опрашивайте GET /api/v1/tasks/:id до состояния completed или failed. Завершенная задача предоставляет изображение в output.image_urls, неудачная — поле error. Старое значение usage.credits округляется до целых кредитов. Для точного учета используйте ?include=billing и проверяйте billing.credits_exact, billing.cost_usd, а также сведения о списании и недостающей сумме, когда они присутствуют. Опрос исходной задачи не отправляет новую генерацию.^[2]

const taskId = submittedTask.id;
const headers = { Authorization: `Bearer ${process.env.REAPI_API_KEY}` };
const deadline = Date.now() + 5 * 60 * 1000;

while (Date.now() < deadline) {
  const response = await fetch(
    `https://reapi.ai/api/v1/tasks/${encodeURIComponent(taskId)}`,
    { headers },
  );
  if (!response.ok) {
    throw new Error(`Task lookup failed: HTTP ${response.status}; task ${taskId}`);
  }
  const task = await response.json();
  if (task.status === 'completed') {
    console.log(task.output.image_urls, task.usage);
    break;
  }
  if (task.status === 'failed') {
    throw new Error(JSON.stringify({ taskId, error: task.error }));
  }
  await new Promise((resolve) => setTimeout(resolve, 3000));
}

Здесь submittedTask — разобранный ответ на успешную отправку. Пятиминутный срок — пример логики приложения, а не гарантия задержки. Если он истек, сохраните taskId и покажите, что приложение перестало ждать. Не помечайте саму генерацию как неудачную, пока задача не сообщит об ошибке. В рабочем клиенте после цикла возвращайте отдельное состояние тайм-аута и предлагайте обновить статус существующей задачи.

Сетевая ошибка после отправки создает еще одну неопределенность: сервер мог принять запрос до разрыва соединения. Автоматическое повторение каждого POST может создать дополнительные оплачиваемые задачи. Разделяйте отправку и опрос, сохраняйте любой возвращенный ID до необязательных действий интерфейса.

Выберите допустимый размер

Для текстового запроса MAI Image 2.6 используйте соотношение сторон с уровнем разрешения или явные размеры. Эндпоинт принимает 1K и 2K, но не 4K. Каждая явно заданная сторона должна быть не меньше 768 пикселей, а общая площадь — не больше 2,359,296 пикселей. Соотношения задаются положительными целыми числами в диапазоне от 1:4 до 4:1.^[2]

Парные ширина и высота имеют приоритет над пиксельными размерами в size, а те — над соотношением сторон с разрешением. По возможности используйте один ясный способ задания размера. Например, width: 1024, height: 1024 вместе с size: "16:9" передает противоречивые намерения, хотя документированный приоритет разрешает такой запрос. Форма приложения может предотвращать эту путаницу.

Размеры округляются вниз до кратных 32. Поэтому запрос 1000 × 1000 по этому правилу соответствует 992 × 992. Если макету нужен точный размер, выберите допустимые кратные значения и проверьте размеры скачанного файла. Последующее кадрирование или изменение размера считайте отдельным этапом приложения.^[2]

Перейдите от генерации к редактированию по референсам

Добавьте image_urls в запрос MAI Image 2.6, чтобы передать визуальные референсы. Эндпоинт reAPI принимает до пяти общедоступных HTTP(S) URL изображений. Промпт остается обязательным. Сохраняйте порядок референсов и объясните, какой задает сцену, объект или стиль.^[2]

{
  "model": "mai-image-2.6",
  "prompt": "Use the first image as the room and the second as the chair. Replace the chair beside the window. Preserve the floor, window, and camera view.",
  "image_urls": [
    "https://example.com/room.jpg",
    "https://example.com/chair.jpg"
  ],
  "web_grounding": false
}

Примерные URL нужно заменить доступными файлами изображений. Предпочтительны JPEG или PNG. URL, который открывается только после входа, не подходит для такого запроса. Проверьте, что он возвращает байты нужного изображения, а не HTML-просмотрщик или страницу с истекшим доступом.

При редактировании по референсам действует другое правило размеров: их выбирает модель, а size, resolution, width и height не управляют результатом. Добавление референсов к прежнему текстовому запросу меняет не только визуальный контекст, но и то, что приложение может обещать о возвращенном холсте.^[2]

Не превращайте просьбу «оставить комнату без изменений» в гарантию попиксельной идентичности. Проверьте измененный объект, соседние края, отражения и элементы, которые должны были сохраниться. Для продуктового процесса отдельно проверяйте логотипы, надписи и физические пропорции. Это рекомендуемые критерии приемки, а не утверждение, что руководство измерило точность модели на этих задачах.

Осознанно используйте автоматическое кадрирование и веб-контекст

auto_aspect_ratio: true просит MAI Image 2.6 подобрать кадр по промпту, как и size: "auto". Это полезно при поиске композиции, но менее подходит, если следующий этап требует фиксированного холста. Автоматический выбор также делает число выходных пикселей неизвестным до завершения.

web_grounding — отдельный булев параметр, по умолчанию false. Microsoft описывает веб-контекст как один из творческих входных источников модели, но включение параметра не делает каждую изображенную надпись или факт достоверными. Проверяйте информацию, важную для готового материала.^[3]

Ни один параметр не заменяет ясный промпт. Сначала задайте объект, композицию, материалы и нужное изменение. Затем включите настройки, которые помогают выполнить это описание. Сохранение отправленных значений позволяет отличать правку промпта от изменения настроек.

Разберитесь с оценкой до автоматизации повторов

Стоимость MAI Image 2.6 зависит от ввода и созданных пикселей. При отправке reAPI резервирует оценочную сумму, после завершения уточняет списание. Итог может быть ниже или выше. Референсы и выбранные моделью размеры объясняют, почему оценку нельзя считать фиксированной ценой изображения.^[2]

Для планируемого запроса используйте текущую оценку на странице модели. Отдельное руководство по стоимости и Flash объясняет, почему квадратное изображение, редактирование по референсам и широкий кадр требуют разных бюджетных сценариев. В этой статье ставка не закрепляется в примерах кода.

За неудачные генерации средства возвращаются согласно контракту задач. Готовое изображение, которое вам не нравится, все равно является завершенной генерацией. Поэтому повторные творческие попытки учитывайте как отдельные задачи. Записывайте принятые результаты и нужное число попыток, чтобы сравнивать стоимость пригодного материала, а не только одного запроса.

Вопросы по интеграции MAI Image 2.6

Какой идентификатор модели отправлять?

Отправляйте mai-image-2.6 с точкой перед 6. Slug страницы mai-image-2-6 предназначен для URL сайта и не является идентификатором модели в запросе.^[2]

Можно ли создать несколько изображений одним запросом?

Нет. Эндпоинт поддерживает n: 1. Для дополнительных попыток отправляйте отдельные запросы и учитывайте каждую задачу отдельно.^[2]

Можно ли получить изображение 4K через этот эндпоинт MAI Image 2.6?

Нет. Документированные уровни — 1K и 2K. При явных размерах каждая сторона должна быть не меньше 768 пикселей, а площадь — в пределах 2,359,296 пикселей.^[2]

Почему редактирование игнорирует ширину и высоту?

Передача референсов меняет правила размера. Размеры редактирования выбирает модель; size, resolution, width и height больше не управляют результатом. Проверьте возвращенный файл, прежде чем обещать размер готового материала.^[2]

Обязателен ли веб-контекст?

Нет. По умолчанию web_grounding равен false. Включайте его, когда веб-контекст помогает выполнить замысел, и все равно проверяйте факты и надписи в готовом изображении.^[2][3]

Означает ли тайм-аут опроса неудачную генерацию?

Нет. Срок клиента означает только, что клиент перестал ждать. Сохраните идентификатор задачи и снова получите статус. Генерация неудачна только тогда, когда задача сообщает failed.^[2]

Поиск загрузки и выбор модели

Клиент API не является скачиваемым чекпойнтом модели. Эта интеграция вызывает размещенный сервис и не устанавливает веса. Microsoft документирует развертывание в Foundry и стандартной модели, и Flash; эти инструкции отличаются от эндпоинта reAPI в статье.^[1]

Идентификатор запроса mai-image-2.6 выбирает стандартную MAI Image 2.6. Не добавляйте flash и не подставляйте имя развертывания, если вызываемый сервис явно не документирует такую модель. Для первой интеграции держите идентификатор модели, эндпоинт, тело запроса и разбор ответа в одном проверенном примере. Добавляйте альтернативные модели только после независимой проверки их контрактов.

Источники

1. Microsoft Learn. Развертывание и использование моделей изображений MAI в Microsoft Foundry. Просмотрено 9 октября 2026 года: learn.microsoft.com/azure/foundry/foundry-models/how-to/use-foundry-models-mai-image.
2. reAPI. Контракт запросов, размеров, опроса и оплаты MAI Image 2.6. Проверено 9 октября 2026 года: reapi.ai/docs/mai-image-2-6.
3. Microsoft AI. MAI-Image-2.6. Просмотрено 9 октября 2026 года: microsoft.ai/models/mai-image-2-6.