Skip to main content
POST
Этот эндпоинт также принимает алиас grok-imagine-1.5-ext, эквивалентный grok-imagine-1.5-apimart и взаимозаменяемый.

Authorizations

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

Body

string
по умолчанию:"grok-imagine-1.5-apimart"
обязательно
Имя модели генерации изображенийПоддерживаемые модели:
  • grok-imagine-1.5-apimart - генерация и редактирование изображений Grok (алиас grok-imagine-1.5-ext)
Пример:"grok-imagine-1.5-ext"
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации или редактирования
string[]
Список URL референсов. Не передавайте для text-to-image; передавайте для редактирования.
  • Эта модель поддерживает от 1 до 5 референсных изображений
  • Принимаются только общедоступные абсолютные URL http:// или https://
  • Локальное изображение сначала загрузите через POST /v1/uploads/images, затем используйте возвращённый url
string
по умолчанию:"1:1"
Размер выходного изображенияПоддерживаемые форматы:
  • 1:1 - Квадрат (по умолчанию)
  • 16:9 - Широкий ландшафт
  • 9:16 - Портрет
  • 3:2 - Ландшафт
  • 2:3 - Портрет
integer
по умолчанию:1
Количество изображенийДиапазон: 1-10 (минимум 1, максимум 10)⚠️ Примечание: передавайте число без кавычек (например 1), иначе будет ошибка

Response

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

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

Сценарий 1: Text-to-Image

Сценарий 2: Text-to-Image (размер и количество)

Сценарий 3: Редактирование (фон)

Сценарий 4: Редактирование (стиль)

Официальные модели

grok-imagine-image и grok-imagine-image-quality используют тот же асинхронный процесс, что и другие модели изображений. После отправки используйте полученный ID задачи и опрашивайте статус задачи до завершения или ошибки.
Не передавайте quality. Без image_urls выполняется text-to-image; одно изображение включает редактирование, несколько — режим нескольких референсов.

Параметры запроса

Допустимые значения aspect_ratio: 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto.

Ответ при создании задачи

202
Используйте data.id или data.poll_url, пока статус не станет completed или failed.