Официальная генерация изображений Grok Imagine

Обзор

Grok Imagine Official — это официальный канал для моделей генерации изображений xAI: запросы пересылаются через APIYI в официальный API xAI, цены соответствуют официальному прайс-листу xAI, тарификация зависит от разрешения и уровня качества, а валидация параметров полностью идентична апстриму. Доступны три модели: стандартная grok-imagine-image, высококачественная grok-imagine-image-quality и более новая grok-imagine-image-2.0 (с уровнями качества low / medium).

🔒 Для этого канала требуется группа GrokOfficial, доступная по заявкеGrok Imagine Official не входит в группу Default. Политика безопасности контента этого семейства существенно отличается от других моделей на платформе, поэтому для снижения комплаенс-рисков доступ предоставляется выборочно:

Действующие клиенты с совокупными расходами от $1,000: обратитесь в службу поддержки и опишите ваш сценарий использования — мы включим доступ после проверки
Остальные пользователи: подайте заявку через поддержку WeCom, указав ваш сценарий использования и инструменты модерации контента; доступ будет открыт после одобрения

Token без группы GrokOfficial возвращает ошибку 503 — это проблема с правами доступа, а не сбой в работе сервиса. См. раздел Настройка групп ниже.

Официальный релей или reverse? На этой странице описан официальный канал: цены соответствуют xAI, тарификация по уровням качества, поддержка grok-imagine-image-2.0, и на данный момент поддерживается только text-to-image, по одному изображению за запрос. Если вам требуется редактирование изображений или генерация нескольких изображений за запрос, либо более низкая фиксированная цена ($0.02 / $0.045 за изображение независимо от разрешения), используйте Grok Imagine Reverse. См. Сравнение официального релея и reverse для подробного сопоставления.

Все API генерации изображений являются синхронными: асинхронный ID задачи отсутствует, поэтому при отключении клиента результат будет потерян, но запрос все равно тарифицируется. grok-imagine-image-2.0 с качеством medium и разрешением 2K в наших тестах занимает около 60–80 секунд, поэтому задавайте для этой модели достаточно большой таймаут. См. Примечания и рекомендации по API генерации изображений.

API Text-to-Image

Генерация изображений по текстовому prompt с интерактивной площадкой Playground.

Grok Imagine Video

Та же группа GrokOfficial — text-to-video и image-to-video с посекундной тарификацией.

Доверьте интеграцию ИИ-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

Сначала он загрузит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под ваш стек — таймауты, немедленное сохранение результатов по URL, использование resolution вместо size и генерация одного изображения за вызов уже заложены в требования.

Интегрируйте / устраните неполадки генерации изображений по тексту Grok Imagine Official в этом проекте.

Прочитайте документацию перед написанием кода: загрузите https://docs.apiyi.com/en/api-capabilities/grok-imagine-image-official/overview.md, чтобы получить текстовую версию этой страницы; …

Выберите одну модель: grok-imagine-image, grok-imagine-image-quality или grok-imagine-image-2.0 …

Всего 8 требований — используйте кнопку ниже, чтобы скопировать полную версию

Модели и цены

Цены соответствуют прайс-листу xAI и взимаются за изображение; уровень определяется параметром resolution (а также quality для версии 2.0):

Модель	Уровень качества	`1k`	`1.5k`	`2k`
`grok-imagine-image`	—	$0.02	$0.02	$0.02
`grok-imagine-image-quality`	—	$0.05	$0.06	$0.07
`grok-imagine-image-2.0`	`low` (по умолчанию)	$0.04	$0.05	$0.06
`grok-imagine-image-2.0`	`medium`	$0.06	$0.07	$0.08

Цены на модели синхронизированы с официальными сайтами и могут меняться при их изменении; таблица выше приведена только для справки, а определяющей является вкладка Цены на модели в верхней панели навигации: Цены на модели.

Примечания по тарификации

Значения по умолчанию: для resolution по умолчанию используется 1k; для grok-imagine-image-2.0 — quality: low, то есть $0.04 за изображение.
За изображение, одно за запрос: оставьте n=1 на этом канале и используйте параллельные запросы, если требуется больше изображений.
Неудачные запросы не тарифицируются: ошибки параметров (422 / 400), отсутствие доступа к группе (503) и прочие ответы с ошибками бесплатны.
Не сверяйте с usage: prompt_tokens всегда имеет значение 1000 × image count — это заглушка; определяющими являются записи тарификации в консоли.
Дополнительно действуют многоуровневые бонусы за пополнение; корпоративные клиенты с большими объемами могут обратиться в отдел продаж по вопросу индивидуальных тарифов.

Официальный канал и реверс

APIYI предлагает как официальный, так и реверс-канал для Grok Imagine. Они различаются группой, тарификацией и возможностями:

Параметр	Официальный (эта страница)	Реверс
Группа	`GrokOfficial` (по заявке)	`Grok_imagine_Reverse` (по заявке)
Тарификация	По официальным ценам xAI, рассчитывается как «разрешение × уровень качества»	Фиксированная за изображение, независимо от разрешения
Модели	`grok-imagine-image` / `-quality` / `-2.0`	`grok-imagine-image` / `-quality`
Уровни разрешения	`1k` / `1.5k` / `2k`	`1k` / `2k`
Генерация по тексту	✅	✅
Редактирование изображений / слияние нескольких изображений	Пока не поддерживается	✅ 1–4 референсных изображения
Несколько изображений за один вызов	Пока не поддерживается (`n=1`)	✅ `n` до 10
Валидация параметров	Строгая: значения вне допустимого диапазона возвращают 422	Мягкая: недопустимые значения без ошибок сбрасываются до значений по умолчанию

Как выбрать: если вам требуется grok-imagine-image-2.0, нужна тарификация на условиях самого xAI или важно, чтобы опечатки приводили к явной ошибке → выбирайте официальный канал. Если вам нужны редактирование, несколько изображений за один вызов или минимальная цена за результат в разрешении 2K → выбирайте реверс-канал. Вы можете использовать обе группы и обращаться к каждой со своим Token.

Настройка группы

Grok Imagine Official не входит в группу Default. Он находится в группе GrokOfficial (такая же цена, как у xAI, см. таблицу выше), и для доступа необходимо подать заявку.

Кто может получить доступ

Категория клиентов	Как получить доступ
Действующие клиенты с суммарными расходами от $1,000+	Обратитесь в службу поддержки с описанием сценария использования; подключается после проверки
Остальные пользователи	Подайте заявку с описанием сценария использования и механизмов модерации контента; подключается после одобрения

Как подать заявку

Свяжитесь со службой поддержки в WeCom

Подайте заявку через поддержку в WeCom или напишите на [email protected]. Укажите, что подаете заявку на GrokOfficial (Grok Imagine Official).

Опишите сценарий использования и средства модерации

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

Переключите группу Token после одобрения

После одобрения мы включим GrokOfficial для вашего аккаунта. Перейдите на страницу Token в консоли, переключите используемый для этого канала Token на GrokOfficial и установите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.

Как это выглядит до предоставления доступа: Token без группы GrokOfficial возвращает 503 (в текущей группе нет доступных каналов). Повторные попытки не помогут — сначала необходимо подключить группу.Не используйте режим тарификации Pay-per-request: этот канал тарифицируется по факту использования, поэтому Token с оплатой за запрос невозможно маршрутизировать, и он также вернет 503.

Напоминание о соблюдении правил: после предоставления доступа ответственность за сгенерированный контент лежит на вызывающей стороне. Соблюдайте местное законодательство и нормативные требования; не создавайте незаконный контент, материалы, нарушающие права на изображение граждан или интеллектуальную собственность, а также контент, не предназначенный для несовершеннолетних. Для сценариев с прямым доступом конечных пользователей добавьте собственный уровень модерации. Подробнее: Примечания по соблюдению нормативных требований при вызове зарубежных моделей. В случае выявления злоупотреблений доступ к группе аннулируется.

Технические характеристики

Параметр	Значение
ID моделей	`grok-imagine-image`, `grok-imagine-image-quality`, `grok-imagine-image-2.0`
Эндпоинт	`POST /v1/images/generations` (`application/json`)
Уровни разрешения	`1k` (по умолчанию) / `1.5k` / `2k`
Соотношения сторон	Основные: `1:1` (по умолчанию) / `16:9` / `9:16` / `4:3` / `3:4` / `3:2` / `2:3`
Уровни качества	Только для `grok-imagine-image-2.0`: `low` (по умолчанию) / `medium`
Изображений за вызов	`n=1`
Формат ответа	`url` (по умолчанию) или `b64_json`
Валидация параметров	Строгая — значение `resolution` / `aspect_ratio` вне допустимого диапазона возвращает 422
Задержка	`grok-imagine-image` около 8 с; `-quality` около 7 с при 1k и 12 с при 2k; `-2.0` `low` около 15–17 с, `medium` 2K около 60–80 с
Рекомендуемый таймаут клиента	≥ 360 секунд

Ключевые параметры

`resolution` и `aspect_ratio` (размер вывода)

Вместе они определяют итоговое разрешение в пикселях. Некоторые результаты измерений:

Модель	Запрос	Фактический результат
`grok-imagine-image`	`1k` + `3:2`	1248×832 (JPEG)
`grok-imagine-image-quality`	`2k` + `9:16`	1584×2816 (PNG, около 6,7 МБ)
`grok-imagine-image-2.0`	`1.5k` + `16:9` + `medium`	1792×1008

Используйте resolution, а не sizeЭтот канал не сопоставляет size в стиле OpenAI (например, "2048x2048") с уровнем разрешения: передача size не вызывает ошибки, но изображение генерируется и тарифицируется по умолчанию как 1k. Для 2K явно передавайте resolution: "2k".

Ошибки приводят к явным сбоям: в отличие от обратного канала, валидация параметров здесь соответствует xAI. Значения вне допустимого диапазона, такие как resolution: "4k" или aspect_ratio: "5:7", возвращают ошибку 422 и не тарифицируются. Если вы столкнулись с ошибкой 422, сначала проверьте написание этих двух параметров (все строчными буквами: 1k / 1.5k / 2k).

`quality` (только `grok-imagine-image-2.0`)

Значение	Примечания
`low`	По умолчанию, быстрее
`medium`	Выше детализация, на $0.02 дороже за изображение, около 60–80 с при 2K

Передача high возвращает 400 (This model only supports the following quality value(s): low, medium, auto). Отправляйте только low или medium — не отправляйте auto. grok-imagine-image и grok-imagine-image-quality не принимают quality; модель сама задает детализацию.

`n` (количество изображений)

Всегда передавайте n=1 в этом канале. Чтобы получить сразу несколько изображений, отправляйте несколько запросов одновременно — задержка стабильна, поэтому параллельные запросы масштабируются линейно.

Коды ошибок и повторные попытки

HTTP	Значение	Что делать
`400`	Недопустимое значение `quality` (например, `high`); в сообщении перечислены допустимые значения	Измените на `low` / `medium`; не повторяйте запрос
`422`	`resolution` / `aspect_ratio` вне допустимого набора	Проверьте написание и регистр; не повторяйте запрос
`429`	Превышен лимит запросов или недостаточно средств на балансе	Повторите попытку с экспоненциальной задержкой и проверьте баланс
`503`	У Token отсутствует группа `GrokOfficial` или Token использует тарификацию с оплатой за запрос	Проблема с правами доступа, а не сбой — повторные попытки не помогут; см. Настройка группы

Рекомендация для клиента: 400 / 422 — детерминированные ошибки, повторять запрос бессмысленно, вместо этого настройте оповещения. Повторять попытки имеет смысл только при 429 и таймаутах на уровне сети, с экспоненциальной задержкой и не более 3 попыток. Ответы с ошибками не тарифицируются.

Часто задаваемые вопросы

Каждый вызов возвращает 503 — канал не работает?

Почти наверняка дело в правах доступа. Возможны два варианта:

В группе Token отсутствует GrokOfficial: доступ к этому каналу предоставляется по заявке; см. Настройка групп.
Режим тарификации Token — с оплатой за запрос: этот канал тарифицируется по факту использования и не может маршрутизироваться от Token с оплатой за запрос. Переключите режим тарификации на Pay-as-you-go Priority или Pay-as-you-go.

Я передал size: 2048x2048 — почему на выходе по-прежнему 1K?

Этот канал не сопоставляет size с уровнем разрешения, поэтому изображение генерируется и тарифицируется по умолчанию как 1k. Вместо этого используйте resolution: "2k" и управляйте кадрированием с помощью aspect_ratio.

Можно ли редактировать изображения или передавать референсное изображение?

Этот канал пока не поддерживает редактирование изображений. Отправка референсного изображения в /v1/images/generations не вызывает ошибки, однако референс игнорируется, и генерируется новое изображение только на основе prompt.Для редактирования или объединения нескольких изображений запросите доступ к Grok Imagine Reverse, чей /v1/images/edits принимает от 1 до 4 референсных изображений.

Почему n=1? Как получить несколько изображений за один раз?

В настоящее время этот канал выдает только одно изображение за раз. Чтобы получить больше изображений, отправляйте несколько параллельных запросов с n=1 в каждом. Если ваш рабочий процесс действительно требует нескольких изображений за вызов, используйте Grok Imagine Reverse (n до 10).

Чем grok-imagine-image-2.0 отличается от двух других?

grok-imagine-image-2.0 — это более новая модель изображений от xAI, в которую добавлен уровень quality (low / medium); medium обеспечивает более высокую детализацию, но работает медленнее (около 60–80 секунд при 2K). grok-imagine-image — самый дешевый вариант и стоит одинаково при любом разрешении; grok-imagine-image-quality обеспечивает более высокую точность с дифференцированной тарификацией в зависимости от разрешения.Сначала настройте пайплайн на grok-imagine-image или 2.0 low, а затем переходите на более высокий уровень по мере необходимости в качестве.

Можно ли сверить расходы по счету с количеством token в usage?

Нет. usage.prompt_tokens всегда имеет значение 1000 × image count — это заполнитель, не связанный с реальными списаниями. Этот канал тарифицируется за каждое изображение в зависимости от разрешения и уровня качества; официальными считаются записи о тарификации в консоли.

Можно ли использовать официальный OpenAI SDK?

Да. Эндпоинт совместим с OpenAI Images API; направьте base_url на https://api.apiyi.com/v1 и укажите нестандартные поля в extra_body:

from openai import OpenAI
client = OpenAI(api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1")

resp = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="a red wooden boat on an alpine lake at dawn",
    n=1,
    extra_body={"resolution": "2k", "aspect_ratio": "16:9", "quality": "medium"},
    timeout=360,
)
print(resp.data[0].url)

Связанные документы

Официальный API Grok Imagine Text-to-Image — справочник по API с Playground
Grok Imagine Video — та же группа, генерация text-to-video и image-to-video
Grok Imagine Reverse — фиксированная цена за изображение, поддержка редактирования и нескольких изображений за один вызов
Примечания и рекомендации по работе с Image API — общие советы по тайм-аутам, разрывам соединения и сжатию
Бонусы за пополнение

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

Официальная генерация изображений Grok Imagine

Обзор

API Text-to-Image

Grok Imagine Video

Доверьте интеграцию ИИ-агенту

Модели и цены

Официальный канал и реверс

Настройка группы

Кто может получить доступ

Как подать заявку

Технические характеристики

Ключевые параметры

`resolution` и `aspect_ratio` (размер вывода)

`quality` (только `grok-imagine-image-2.0`)

`n` (количество изображений)

Рекомендации

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанные документы

​Обзор

API Text-to-Image

Grok Imagine Video

​Доверьте интеграцию ИИ-агенту

​Модели и цены

​Официальный канал и реверс

​Настройка группы

​Кто может получить доступ

​Как подать заявку

​Технические характеристики

​Ключевые параметры

​resolution и aspect_ratio (размер вывода)

​quality (только grok-imagine-image-2.0)

​n (количество изображений)

​Рекомендации

​Коды ошибок и повторные попытки

​Часто задаваемые вопросы

​Связанные документы

Обзор

Доверьте интеграцию ИИ-агенту

Модели и цены

Официальный канал и реверс

Настройка группы

Кто может получить доступ

Как подать заявку

Технические характеристики

Ключевые параметры

`resolution` и `aspect_ratio` (размер вывода)

`quality` (только `grok-imagine-image-2.0`)

`n` (количество изображений)

Рекомендации

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанные документы