xAI

Grok Imagine

grok-imagine/text-to-image

Творческая модель генерации от xAI с поддержкой редактирования изображений по изображению и стилевого управления, до 9 референсных изображений для контроля композиции и персонажей; вызывается через единый интерфейс HiAPI.ai

grok-imagine/image-to-image grok-imagine/image-to-video grok-imagine/text-to-image grok-imagine/text-to-video

Попробовать grok-imagine/text-to-image

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Спектр стилей: шесть иллюстраций от реализма до флэт-графики

Стиль style-spectrum · Иллюстрация · Арт-дирекшн

Промпт

Схема стилевого спектра из шести панелей, где все панели изображают один и тот же объект: одинокий человеческий силуэт на завывающем от ветра поле в сумерках. Панели расположены сеткой 3x2 и слева направо образуют стилевой спектр от фотореализма до плоской графики. Панель 1: фотореализм, объёмное сумеречное освещение, тонкая текстура ткани и травы, малая глубина резкости. Панель 2: живописный реализм, заметный мазок, тёплый контурный свет. Панель 3: полуреалистичная иллюстрация, упрощённая анатомия фигуры, мягкие градиенты. Панель 4: стилизованная иллюстрация с уклоном в вектор, двухтональная светотень, чистые края. Панель 5: плоская иллюстрация, выразительный силуэт, палитра из трёх тонов. Панель 6: минималистичная плоская графика, геометрические формы, единственный акцентный цвет. Общая композиция выдержана в 16:9, единая сумеречная палитра из янтарного, сланцево-синего и мягкого зелёного, между панелями — узкие нейтральные поля, без какого-либо текста или подписей, изображение предельно чёткое, с эстетикой референс-листа для арт-дирекшена.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Концепт-арт сцены мира: Часовая башня Туманной гавани

Стиль Концепт-арт · Построение мира · Кинематографичный

Промпт

Кинематографичный концепт-арт вымышленного мира, изображающий вымышленный порт в тумане: высокая, покрытая пятнами каменная часовая башня поднимается прямо из узкого причала, деревянные дома и подвесные фонари плотно теснятся вдоль берега, влажная брусчатка отражает тёплый свет фонарей, густой низкий туман клубится над поверхностью моря, а вдали в дымке едва проступают силуэты судов и маяка. От швартовых канатов и деревянных ящиков на переднем плане к силуэту башни — постепенное углубление планов; крошечные фигурки на лестнице подчёркивают масштаб. Фотореалистичное освещение, мягкие объёмные лучи, холодный сине-бирюзовый атмосферный туман контрастирует с тёплыми янтарными практическими источниками света, тщательно проработаны текстуры влажного камня, ржавого железа и выветренной древесины. Широкоформатная композиция 16:9, низкая точка съёмки, башня размещена по правилу третей, сдержанная цветовая палитра, тихое и атмосферное настроение, высокая детализация.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

grok-imagine/text-to-image per image

Цена за единицу	$0.030

Краткое описание

grok-imagine/text-to-image — это линия генерации изображений по тексту из семейства xAI grok-imagine, предназначенная для разработчиков, которым нужен массовый выпуск качественных реалистичных или стилизованных изображений. Она принимает текстовые подсказки длиной до 8000 символов, позволяет выбирать выходное разрешение из двух вариантов (1k и 2k) и 13 соотношений сторон, а также поддерживает три формата вывода: jpeg, png и webp. Подходит командам, которые хотят встроить генерацию изображений в производство контента, концепт-дизайн и процессы массовой подготовки материалов — вызов доступен через единый интерфейс HiAPI.ai.

Ключевые особенности

Два разрешения и 13 соотношений сторон — вывод переключается между 1k и 2k, соотношения охватывают горизонтальные, вертикальные и квадратные форматы от 2:1 до 1:2, что подходит для разных рекламных площадок.
Подсказки до 8000 символов — длинные подсказки вмещают полное описание сцены, освещения и стиля, что удобно для структурно сложных задач генерации.
Три формата вывода на выбор — jpeg, png и webp задаются напрямую под требования нижестоящего пайплайна, избавляя от перекодирования после генерации.

Описание возможностей

Генерация по длинным подсказкам: принимает текстовое описание длиной от 1 до 8000 символов и создаёт изображение; сложные сцены и детальные ограничения можно описать в одной подсказке.

Управление разрешением и соотношением сторон: по необходимости выбираются разрешения 1k или 2k и одно из 13 соотношений сторон — за один вызов получается изображение под размер площадки, что сокращает последующую обрезку.

Прямое указание формата вывода: поддерживаются форматы jpeg, png и webp, что позволяет согласовать результат с требованиями нижестоящих этапов — распространения материалов, веб-отображения и т. п.

Сценарии применения

Массовая генерация иллюстраций контент-командой — по текстовому сценарию или заголовку массово создаются горизонтальные и вертикальные иллюстрации; полученные ассеты можно сразу загружать в CMS или дизайн-макеты.
Предварительная визуализация концептов для продукта и маркетинга — длинные подсказки описывают сцену, освещение и фактуру, позволяя быстро получить концепт в 2k для сравнения вариантов и утверждения визуального направления.
Встроенная в приложение генерация по тексту — разработчик передаёт подсказку вместе с параметрами разрешения, соотношения сторон и формата, а пользователь получает изображение нужной спецификации, которое сразу подставляется на страницу.

Ограничения и рекомендации по выбору

Эта линия выполняет только преобразование текста в изображение и не поддерживает управление по референсному изображению или редактирование изображений; для переноса стиля и тонкой настройки композиции следует использовать линии редактирования изображений, а для динамических материалов — линии генерации видео. Подсказка должна быть полностью задана текстом, визуальный ввод для опоры отсутствует. Максимальное разрешение — 2k, соотношения сторон ограничены 13 вариантами из схемы; размеры вне этого диапазона требуют обрезки или дополнительной обработки на нижестоящем этапе.

Новости

Смотреть changelog →

Новая модель Новые модели: grok-imagine-image-2.0/text-to-image и grok-imagine-ima… Aug 14, 2026

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

Все частые вопросы →

Для чего подходит стандартный уровень Grok Imagine?

Подходит для массового исследования идей, материалов для социальных сетей, пейзажных и кинематографичных сцен. 1k и 2k сейчас стоят одинаково, поэтому лучше сразу выбирать более высокий уровень вывода.
В чём разница между стандартным тарифом и тарифом Quality?

Стандартный тариф делает акцент на скорости и фиксированной низкой цене; Quality — это отдельная линейка моделей, которая уделяет больше внимания материалам, деталям и освещению, а оплата тарифицируется по уровням 1k/2k.
Какие форматы изображения поддерживаются?

Поддерживается 13 форматов: горизонтальные, квадратные и вертикальные — от 2:1 и 20:9 до 1:2.
Поддерживает ли эта страница референсное изображение?

Нет. Для редактирования по референсному изображению используйте grok-imagine/image-to-image.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: grok-imagine/text-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для grok-imagine/text-to-image и маршрута default — см. таблицу параметров ниже.

promptstringОбязательноminLength 1maxLength 8000

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

resolutionstringНеобязательноПо умолчанию: "1k"

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

Варианты:1k2k

aspect_ratiostringНеобязательноПо умолчанию: "1:1"

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

Варианты:2:120:919.5:916:94:33:21:12:3

Показать все (5)

3:49:169:19.59:201:2

output_formatstringНеобязательноПо умолчанию: "jpeg"

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

Варианты:jpegpngwebp

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

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

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1k",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1k",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}