API Grok Imagine: руководство по Python и 3 модели в сравнении

API Grok Imagine — это интерфейс xAI для картинок и видео, и в нём три модели изображений, которые можно вызывать уже сегодня: grok-imagine-image, grok-imagine-image-quality и grok-imagine-image-2.0. 18 октября 2026 года мы прогнали через все три одни и те же четыре запроса, и Grok Imagine 2.0 выиграл в трёх из четырёх.

Дальше: какую модель выбрать, скрипт на Python, который работает как есть, сколько xAI берёт за картинку и на что смотреть.

Коротко

• Берите Grok Imagine 2.0 (grok-imagine-image-2.0) по умолчанию. В наших тестах у него лучшая типографика на постере, лучший продуктовый кадр и лучшая фотография, а xAI указывает цену от $0,04 за картинку.
• Оставьте исходную grok-imagine-image для дешёвых черновиков: $0,02 за картинку у xAI, и текст на постере она тоже написала правильно.
• grok-imagine-image-quality пропустите: xAI отключает её 2 ноября 2026 года, а нам она добавила на постер выдуманный адрес.
• Каждая картинка вернулась за 7–18 секунд.

Что такое API Grok Imagine?

Это API xAI для картинок и видео, открытый 28 января 2026 года (xAI). Модель Image 2.0 вышла 7 августа 2026 года, и xAI говорит, что она вторая в мире и по генерации, и по редактированию изображений (xAI).

Все три есть в OmniaKey: Grok Imagine, Grok Imagine Quality и Grok Imagine 2.0. OmniaKey продаёт к ним доступ по API, поэтому тесты мы гоняли через него; все цены здесь — цены самой xAI.

Какую модель Grok Imagine выбрать?

Grok Imagine 2.0 — если вам не нужны только дешёвые черновики. Мы дали каждой модели одни и те же четыре запроса по одному разу, без настроек размера и пропорций, и смотрели картинки в полном размере.

Тест 1: текст на постере

Запрос:

A minimalist poster for a neighborhood coffee shop opening. Large bold headline text "GRAND OPENING", smaller text below "Saturday 9 AM", a simple line drawing of a coffee cup, cream background, dark brown ink.

Все три правильно написали обе строки (постер выше). У Grok Imagine 2.0 самая продуманная вёрстка, с тонкими линиями вокруг даты. Quality добавила строку, которую никто не просил:

Вердикт: 2.0 — за вид, исходная — если нужен только правильный текст. Для печати Quality не берите: выдуманный текст — последнее, что нужно на флаере.

Тест 2: реалистичное фото

Запрос:

A realistic photo of an elderly fisherman mending a blue net on a wooden dock at sunrise, soft golden light, gulls in the background, shallow depth of field.

• Grok Imagine: красивый золотой свет и правдоподобная сцена, но весь причал в фокусе.
• Quality: сюжет и место верные, но рыбак мелкий в кадре, а детали мягче.
• Grok Imagine 2.0: крупный план с размытым фоном — единственный, кто явно сделал «малую глубину резкости».

Вердикт: 2.0.

Тест 3: продуктовый кадр

Запрос:

Studio product photo of a matte black wireless earbud case, lid open, both earbuds inside, on a pure white background, soft shadow, sharp focus, no text, no logo.

Все три сделали каждую деталь правильно: открытая крышка, оба наушника, белый фон, без логотипа. У исходной кейс мелкий в кадре, Quality сняла его под углом. Grok Imagine 2.0 заполнил кадр чёткой детализацией — хоть в карточку товара.

Вердикт: 2.0.

Тест 4: счёт предметов

Запрос:

Top-down photo of a wooden table with exactly three red apples on the left and exactly two green pears on the right, nothing else on the table.

Все три положили ровно три яблока слева и две груши справа, и ничего больше на столе. У исходной груши стоят, а не лежат, если смотреть сверху, а груши у 2.0 вышли скорее жёлтыми, чем зелёными.

Вердикт: по счёту ничья; у Quality самый чистый кадр сверху.

Как вызвать API из Python?

Три шага: создать задачу, проверять её до готовности, скачать картинку. Положите ключ в переменную окружения и запускайте:

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Создаём задачу. Тот же Idempotency-Key берите только при повторе этого же запроса.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "grok-imagine-image-2.0",
        "type": "image",
        "operation": "generate",
        "input": {"prompt": "A flat illustration of a red bicycle leaning on a yellow wall, morning light"},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Опрашиваем статус, пока задача не закончится.
while task["status"] in ("queued", "processing"):
    time.sleep(2)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Скачиваем сразу: подписанная ссылка живёт недолго.
asset = task["assets"][0]
with open("bicycle.jpg", "wb") as f:
    f.write(requests.get(asset["url"], timeout=60).content)
print("saved bicycle.jpg", asset["mime_type"], asset["byte_size"], "bytes")

Когда мы запускали это 18 октября 2026 года, скрипт вывел вот это и сохранил JPEG 1248 × 832 через 16 секунд после старта:

task: task_LBCu6Lr8hyD4RH25JfiOixJHPHi3Cd0o queued
saved bicycle.jpg image/jpeg 267732 bytes

Чтобы попробовать другую модель, поменяйте только значение model.

Сколько стоит API Grok Imagine?

xAI берёт деньги за картинку, и цена зависит от модели, разрешения и, у 2.0, от уровня качества. Это тарифы самой xAI со страницы цен, проверенные 18 октября 2026 года:

2.0 по умолчанию делает новые картинки в низком качестве, если не попросить иначе, так что картинка 1K стоит $0,04 у xAI. В API самой xAI запрос, нарушающий правила использования, всё равно оплачивается. В OmniaKey вы платите фиксированную цену за картинку (актуальные тарифы — на страницах моделей), а неудачная задача возвращает деньги.

На что смотреть?

• Через OmniaKey нельзя редактировать. В API самой xAI модель 2.0 умеет менять картинки по пяти референсам, но через OmniaKey Grok только создаёт новые. Для правок берите модель, которая это умеет, например Nano Banana 2.1.
• Пропорции выбирает модель. Без настройки пропорций Grok сделал постер вертикальным, а сцены горизонтальными, всё около одного мегапикселя (832 × 1248 — 1280 × 720).
• Quality уходит 2 ноября. После этого xAI отвечает на запросы к grok-imagine-image-quality моделью 2.0 в низком качестве, так что переходите сейчас.
• На 400 повторите один раз. Одна из наших 14 задач упала с 400 и была возвращена; точный повтор прошёл.

Итог

В большинстве случаев вызывайте grok-imagine-image-2.0: он выиграл три наших теста из четырёх и стоит $0,04 за картинку 1K у xAI. Исходную модель берите, когда нужно много дешёвых черновиков, а с Quality уходите до 2 ноября.

Частые вопросы

API Grok Imagine бесплатный?

Нет. xAI указывает цену за картинку для каждой модели изображений Grok, начиная с $0,02 у исходной.

Можно делать видео через API Grok Imagine?

Да. Видеомодели xAI считают по секундам, например $0,08 за секунду в 480p у Grok Imagine Video 1.5. В OmniaKey смотрите Grok Imagine Video 1.5.

Какого размера будет картинка?

Около одного мегапикселя по умолчанию. В руководстве xAI по умолчанию 1K, 2K — опция, а пропорции выбирает модель, если вы их не задали.

Что будет с grok-imagine-image-quality после 2 ноября?

xAI продолжит отвечать, но моделью Grok Imagine 2.0 в низком качестве и по цене 2.0. Исходной grok-imagine-image это не касается.