xAI

Grok Imagine

grok-imagine/image-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/image-to-image

Ввод

Работы

Все работы

Вывод

image

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

电商级产品图：质感重塑 на основе одного референсного изображения

Стиль Изображение продукта · Студийный свет · электронная коммерция

Референсные входы

image_urls

Промпт

Стилизованная переработка коммерческой продуктовой фотографии на основе референсного изображения. Полностью сохранить контур продукта, пропорции, стыки и расположение этикеток в соответствии с референсом; не изменять и не выдумывать никакие брендовые обозначения. Перестроить сцену: бесшовный тёпло-серый студийный фон с мягким градиентным затуханием, матовая серая поверхность, под продуктом — тонкая естественная контактная тень. Свет: крупный софтбокс как основной источник под углом 45 градусов сверху слева, контровой свет сзади справа очерчивает металлические кромки, белый отражатель подсвечивает теневую сторону. Сохранить и усилить передачу материалов: шлифованный металл с тонкими анизотропными бликами, матовое покрытие с мягкими переходами бликов, отражения чёткие, без пересвеченных пятен. Камера на уровне продукта, угол обзора эквивалентен 85 мм, средняя глубина резкости сохраняет весь продукт чётким, лёгкий наклон сверху создаёт композицию главного визуала, справа оставлено достаточно свободного пространства для текста. Чистая цветокоррекция, нейтральный баланс белого, высокий микроконтраст, эстетика коммерческого каталога, широкоформатная композиция 2:1.

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

Теги

От реализма к плоской графике: четыре уровня иллюстрации одной сцены

Стиль перенос стиля · Плоская иллюстрация · Редактирование изображений

Референсные входы

image_urls

Промпт

Преобразуйте референсную фотографию в плоскую векторную иллюстрацию: сохраните исходный объект, композицию и ракурс камеры, но упростите все формы до геометрических фигур с чёткими, аккуратными краями. Замените фотографические градиенты небольшой палитрой из 5–7 плоских цветовых пятен, добавляя едва заметные тональные тени без зерна только там, где нужно передать объём; уберите мелкую текстуру и тонкие детали, а растительность, ткани и поверхности зданий сведите к наслоенным силуэтам. Сохраните исходное направление освещения сцены, передавая его на каждой форме одной более светлой плоскостью. Центрированная композиция с обильным негативным пространством, плакатное равновесие, стиль современной редакционной иллюстрации, формат 16:9.

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

Теги

Цены

grok-imagine/image-to-image per image

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

Введение в модель

grok-imagine/image-to-image — это модель редактирования изображений, представленная xAI и вызываемая через единый интерфейс HiAPI.ai. Она использует prompt как инструкцию к редактированию и генерирует новое изображение на основе 1–3 референсных изображений, поддерживая задание разрешения 1k/2k, 14 соотношений сторон и выходных форматов jpeg/png/webp. Модель подходит разработчикам, которым нужно переписывать, переносить стиль или корректировать композицию существующих изображений и встраивать управляемое редактирование изображений в собственные продуктовые процессы.

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

Управляемое редактирование на основе референсных изображений — на вход подаются 1–3 изображения по публичным URL, а prompt описывает цель редактирования: сюжет и композиция опираются на исходные материалы, а не создаются с нуля.
Широкий набор соотношений сторон — поддерживается 14 соотношений от 2:1 до 1:2; режим auto наследует пропорции первого входного изображения, что удобно для размещения в горизонтальных и вертикальных слотах.
Выбор разрешения и формата — выходное разрешение 1k или 2k, форматы jpeg, png и webp; файлы сразу готовы к дальнейшему использованию.

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

Условное редактирование по референсным изображениям: передайте 1–3 публичных изображения в формате jpeg/png/webp и инструкцию к редактированию — модель сгенерирует переработанное изображение, что подходит для точечных изменений существующих материалов.

Управление соотношением сторон: доступен режим auto или 14 фиксированных пропорций; auto следует первому входному изображению, что удобно для пакетной генерации изображений, выровненных по размеру рекламных мест.

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

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

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

Дизайн-команды: точечная переработка существующих материалов — загрузите текущее изображение товара или сцены и опишите, что изменить, чтобы получить новое изображение с сохранённой композицией для замены материала или создания вариантов.
Контент-команды: пакетная генерация под рекламные места — по референсному изображению и параметрам пропорций создавайте горизонтальные или вертикальные изображения для публикации в разных размерах в соцсетях и рекламных слотах.
Разработчики приложений: встраивание функции редактирования изображений — оберните редактирование по референсным изображениям и параметры формата/разрешения в точку редактирования внутри продукта: пользователь загружает изображение и сразу получает результат обработки.

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

На вход принимаются только 1–3 изображения в формате jpeg/png/webp по публичным URL; SVG не поддерживается, за один запрос создаётся одно изображение. Возможности ограничены редактированием на основе референсных изображений: нет генерации видео, аудио или изображений только по тексту — для таких задач следует выбирать text-to-image или видео-модели того же семейства. Для пакетного вывода нескольких изображений или собственного разрешения выше 2k также потребуется другая модель.

Новости

Смотреть 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/image-to-image

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

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

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

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

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

Текст инструкции для редактирования: опишите на естественном языке желаемый результат генерации.

image_urlsarrayОбязательноminItems 1maxItems 3

Массив входных референсных изображений: необходимо предоставить от 1 до 3 URL-адресов изображений в формате jpeg, png или webp, доступных из интернета; формат SVG не поддерживается.

Array [ string ]

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

Разрешение выходного изображения, по умолчанию 1k.

Варианты:1k2k

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

Соотношение сторон генерируемого изображения, по умолчанию auto, то есть соответствует соотношению сторон первого входного изображения.

Варианты:auto2:120:919.5:916:94:33:21:1

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

2:33: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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1k",
    "aspect_ratio": "auto",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1k",
      "aspect_ratio": "auto",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1k",
          "aspect_ratio": "auto",
          "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"
    }
  }
}