Модели изображений Grok Imagine

Grok Imagine — это семейство моделей генеративных медиа от xAI. Три из них создают изображения, и все три работают через API асинхронных задач с тем же форматом оболочки, что и все остальные модели на платформе. Идентификаторы моделей в точности соответствуют официальным названиям xAI. WideRouter не публикует псевдонимы.

Краткий обзор серии

	Grok Imagine 2.0	Grok Imagine Quality	Grok Imagine
Идентификатор модели	`grok-imagine-image-2.0`	`grok-imagine-image-quality`	`grok-imagine-image`
Асинхронный API задач	да	да	да
Синхронные API изображений	да	да	да
Параметр `quality`	да, `low` / `medium`	нет	нет
Уровни разрешения	`1k` / `2k`	`1k` / `2k`	`1k` / `2k`
Ориентация по умолчанию	альбомная, 1248 × 832	книжная, 864 × 1152	альбомная, 1248 × 832
Изображений за вызов	до 4	до 4	до 4
Референсные изображения	до 3	до 3	до 3

Все три принимают одни и те же параметры, за одним исключением: только grok-imagine-image-2.0 принимает quality. В двух других моделях он отклоняется как unknown field, поскольку их качество фиксировано, а не выбирается. Именно на этом основан выбор между ними:

grok-imagine-image-2.0 — настраиваемая модель. Используйте её, когда нужно найти компромисс между стоимостью и точностью или требуется определённое соотношение сторон и разрешение.
grok-imagine-image-quality имеет фиксированное высокое качество и по умолчанию использует книжную ориентацию. Используйте её, когда качество важнее контроля.
grok-imagine-image значительно дешевле двух других моделей. Используйте её для черновиков, миниатюр и любых материалов, которые нужно генерировать массово.

Параметры

Оболочка содержит те же три ключа, описанные в API асинхронных задач, — model, input и необязательный callback_url. Всё ниже указывается внутри input.

Поле	Тип	По умолчанию	Примечания
`prompt`	string	—	Обязательное. Не должно быть пустым; не более 32000 байт.
`resolution`	string	`1k`	`1k` или `2k`. В нижнем регистре.
`quality`	string	`low`	`low` или `medium`. Только для `grok-imagine-image-2.0`.
`aspect_ratio`	string	значение модели по умолчанию	Одно из 16 приведённых ниже значений или `auto`.
`n`	integer	1	От 1 до 4. Каждое изображение является отдельной записью в `outputs`.
`images`	string[]	—	До 3 референсных изображений в виде URL `https` или URI данных в формате base64.

Проверка внутри input выполняется строго: нераспознанный ключ немедленно отклоняется с invalid_params и param, в котором он указывается точно. Опечатка приводит к явной ошибке, а не незаметно игнорируется.

Значения resolution указаны в нижнем регистре (1k, 2k). Это противоположно серии Nano Banana, в которой в image_size используются 1K / 2K / 4K в верхнем регистре. У этих двух семейств здесь разные имена параметров, поэтому переносить нечего — используйте эту таблицу, а не ту.

Разрешение и качество

В grok-imagine-image-2.0 эти два измерения независимы, и оба влияют на результат. Измеренные размеры в пикселях, по одному примеру каждого:

`resolution`	`quality`	Результат
`1k` (по умолчанию)	`low` (по умолчанию)	832 × 1248
`1k`	`medium`	1280 × 720 при `16:9`
`2k`	`low`	1664 × 2496
`2k`	`medium`	2816 × 1584

Для двух других моделей применяется только resolution. Измеренный результат: grok-imagine-image при 2k возвращает 2816 × 1584; grok-imagine-image-quality при 2k возвращает 1776 × 2368. Точные размеры в пикселях определяет модель, это не фиксированная сетка — один и тот же уровень даёт разные значения в зависимости от запрошенного соотношения сторон. Рассматривайте таблицу как порядок величины, а фактический размер смотрите в файле.

Соотношения сторон

Все три модели поддерживают одинаковые 16 значений:


`auto`	`1:1`	`16:9`	`9:16`
`4:3`	`3:4`	`3:2`	`2:3`
`2:1`	`1:2`	`19.5:9`	`9:19.5`
`20:9`	`9:20`	`21:9`	`5:2`

Если не указывать это значение, каждая модель использует собственное соотношение сторон по умолчанию — альбомную ориентацию для grok-imagine-image и grok-imagine-image-2.0, книжную ориентацию для grok-imagine-image-quality. auto позволяет модели выбрать соотношение сторон на основе промпта.

Эталонные изображения

Передайте до трёх изображений в input.images, чтобы отредактировать их или создать композицию на их основе. Каждая запись представляет собой URL https или URI данных в формате base64:

{
  "model": "grok-imagine-image-2.0",
  "input": {
    "prompt": "put the teapot on a marble counter, warm morning light",
    "images": ["https://example.com/teapot.jpg"],
    "resolution": "2k"
  }
}

Четвёртое изображение отклоняется во время отправки: input.images — must contain at most 3 items. Некорректная запись содержит свой индекс: input.images[0] — must be an https URL or a base64 image data URI. WideRouter получает URL на стороне сервера, поэтому они должны быть доступны из общедоступного интернета. Если имя хоста не разрешается или хост возвращает данные, которые не являются изображением, задача завершается с ошибкой после постановки в очередь, а не во время отправки.

Цены

Эти модели предоставляются через группу Grok-Official. Прейскурантная цена WideRouter в точности совпадает с официальной ценой xAI — скидка отражается в коэффициенте тарифа группы, который для Grok-Official составляет 0.8. Поэтому вы платите:

list price × group multiplier = charge

Прейскурантные цены за одно изображение, подтверждённые по значениям тарификации, которые возвращает API:

Модель	`resolution`	`quality`	Прейскурантная цена
`grok-imagine-image`	`1k` или `2k`	—	$0.02 — оба уровня стоят одинаково
`grok-imagine-image-2.0`	`1k`	`low`	$0.04
`grok-imagine-image-2.0`	`1k`	`medium`	$0.06
`grok-imagine-image-2.0`	`2k`	`low`	$0.06
`grok-imagine-image-2.0`	`2k`	`medium`	$0.08
`grok-imagine-image-quality`	`1k`	—	$0.05
`grok-imagine-image-quality`	`2k`	—	$0.07

Два правила, которые легко упустить:

Эталонные изображения оплачиваются дополнительно — около $0.01 за каждое входное изображение сверх цены вывода. Композиция из трёх изображений тарифицируется как один вывод плюс три входных изображения.
n умножается. Четыре изображения с параметрами 2k / medium стоят в четыре раза дороже одного изображения, а не тарифицируются по оптовой ставке.

За выполненную задачу начисляется usage.cost_in_usd_ticks, где 10000000000 тиков равны $1. Это прейскурантная цена — до применения коэффициента тарифа вашей группы. Умножьте её на тариф вашей группы, чтобы получить фактическую сумму, списываемую с вашего баланса.

Задержка

Измерено от начала до конца в асинхронном API: от отправки до completed, по одному образцу для настроек по умолчанию:

Модель	От начала до конца
`grok-imagine-image`	6.6 с
`grok-imagine-image-quality`	6.6 с
`grok-imagine-image-2.0`	10 с

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

Синхронный интерфейс

Все три модели также отвечают через POST /v1/images/generations, который удерживает соединение открытым и возвращает изображение напрямую.

curl https://api.widerouter.com/v1/images/generations \
  -H "Authorization: Bearer $WIDEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "a small ceramic teapot on a light-grey studio backdrop",
    "resolution": "2k",
    "response_format": "b64_json"
  }'

Ответ содержит data и usage. Содержимое data[0] зависит от response_format: b64_json — байты inline, url — ссылку.

При использовании response_format: "url" ссылка указывает на собственный хост xAI, а не на CDN WideRouter, и мы не можем гарантировать срок её действия. При измерении: генерация 2k вернула файл PNG размером 5,2 МБ через imgen.x.ai, тогда как та же модель в асинхронном API возвращает JPEG через CDN WideRouter с документированным сроком действия 24 часа. В этом случае предпочтительно использовать b64_json или асинхронный API.

Синхронный путь проще для скрипта, которому нужно немедленно получить байты, но он удерживает соединение на протяжении всей генерации — при измерении это заняло 19,4 секунды через 2k. Для всего, что работает за бессерверной функцией, обратным прокси или в мобильном клиенте, следует использовать асинхронный API.

Следующие шаги

Песочница

Отправьте реальный запрос из браузера и дождитесь завершения задачи.

Видео Grok Imagine

Видео-часть семейства — создавайте, редактируйте и расширяйте клипы.

Серия Nano Banana

Grok Imagine изображения

Grok Imagine видео

Модели изображений Grok Imagine

Краткий обзор серии

Параметры

Разрешение и качество

Соотношения сторон

Эталонные изображения

Цены

Задержка

Синхронный интерфейс

Следующие шаги

Песочница

Видео Grok Imagine

​Краткий обзор серии

​Параметры

​Разрешение и качество

​Соотношения сторон

​Эталонные изображения

​Цены

​Задержка

​Синхронный интерфейс

​Следующие шаги

Песочница

Видео Grok Imagine

Краткий обзор серии

Параметры

Разрешение и качество

Соотношения сторон

Эталонные изображения

Цены

Задержка

Синхронный интерфейс

Следующие шаги