xAI
Grok Imagine Quality
grok-imagine-quality/image-to-image
Высокоточная модель генерации и редактирования изображений от xAI: более стабильный рендеринг текста и композиция, поддержка вывода в 1K/2K и редактирования с сохранением согласованности по референсному изображению
Попробовать grok-imagine-quality/image-to-image
Ввод
Работы
Все работыВывод
imageЦены
grok-imagine-quality/image-to-image per image
| Характеристики | Цена за единицу |
|---|---|
| 1K | $0.080 |
| 2K | $0.100 |
Краткое описание позиционирования
grok-imagine-quality/image-to-image — это высокоточная версия xAI для редактирования изображений, которая принимает от 1 до 3 референсных изображений и текстовую инструкцию по редактированию, а на выходе выдаёт готовое изображение в разрешении 1K или 2K. По сравнению со стандартной версией она обеспечивает более высокую детализацию, лучше передаёт текстуры и освещение, точнее рендерит текст внутри изображения и стабильнее сохраняет композицию — ценой несколько более медленной генерации. Подходит разработчикам, которым нужно готовое качество и точечная правка на основе референсных изображений, для коммерческой визуализации, изображений для соцсетей и макетирования.
Ключевые преимущества
- Высокоточное редактирование, более стабильные детали и композиция — по сравнению со стандартной версией текстуры, освещение и физическая реалистичность выглядят естественнее, а композиция стабильнее; результат можно использовать сразу для сдачи, а не только как черновик.
- Два варианта вывода: 1K и 2K — через один и тот же интерфейс можно выбрать 1K для быстрых итераций или 2K для тонкой доработки, совмещая пробные творческие эксперименты и финальный результат.
- Несколько референсных изображений и управление соотношением сторон — можно передать до 3 референсных изображений, доступны auto или 13 фиксированных соотношений сторон; режим auto наследует пропорции первого референсного изображения.
- Более точный рендеринг текста внутри изображения — точность воспроизведения текста в макетах повышена, что подходит для постеров и графики для соцсетей с текстовыми элементами.
Возможности
Точечное редактирование по референсным изображениям: передайте от 1 до 3 референсных изображений и инструкцию на естественном языке — и изображение будет точечно изменено с сохранением целостности основного объекта и стиля.
Управление разрешением и соотношением сторон: поддерживаются разрешения 1K и 2K, соотношение сторон можно выбрать auto или из стандартных портретных и горизонтальных пропорций; режим auto использует пропорции первого референсного изображения, что упрощает адаптацию под разные площадки размещения.
Вывод в нескольких форматах: доступны форматы jpeg, png и webp, что напрямую соответствует требованиям последующих этапов обработки к типу файла.
Редактирование с длинными инструкциями: инструкция по редактированию может содержать до 8000 символов, что позволяет описывать сложные многофакторные изменения.
Воспроизведение именованных субъектов: достаточно высокая точность воспроизведения брендов, публичных лиц, конкретных мест и других именованных субъектов — их можно прямо называть в инструкции.
Сценарии применения
- Команды электронной коммерции и рекламы правят изображения товаров — используя реальные фотографии товаров как референс, по описанию корректируют фон, освещение и композицию, получая готовые визуальные материалы, пригодные для прямого размещения.
- Дизайнеры создают постеры и изображения для соцсетей — на основе референсного макета генерируют изображение с текстовой вёрсткой и выводят графику в 2K для афиш мероприятий или публикаций в соцсетях.
- Творческие команды итерируют от эскиза к финальной доработке — сначала быстро проверяют направление в 1K, затем выводят финальный вариант в 2K, сокращая цикл от тестирования концепции до сдачи.
- Серии изображений с единым стилем — на основе одного и того же референсного изображения генерируют несколько кадров с единым стилем и субъектом для серийного производства контента.
Ограничения и рекомендации по выбору
Это линия редактирования изображений: необходимо предоставить как минимум 1 общедоступное референсное изображение в формате jpeg, png или webp; SVG не поддерживается. Поэтому она не подходит для задач чистой генерации по тексту — в таких случаях следует выбирать линию text-to-image из той же серии. Инструкция по редактированию — до 8000 символов, за один раз можно использовать не более 3 изображений. Приоритет — качество, поэтому генерация медленнее стандартной версии; для задач с высоким разрешением или требующих тонкой настройки референсных изображений может потребоваться несколько попыток для достижения желаемого результата. Поддерживается только вывод изображений, другие модальности, например видео, не охватываются.
Частые вопросы
Все частые вопросы →-
Для каких готовых изображений подходит Grok Imagine Quality?
Подходит для ключевых визуалов, обложек, рекламных концептов и высококачественных сцен, где требуются более выразительные материалы, свет, атмосфера и детали.
-
Как тарифицируются 1k и 2k?
Для 1k и 2k используются разные тарифы за изображение; за размер и формат вывода дополнительная плата не взимается. Точные суммы указаны в актуальных ценах на этой странице.
-
Почему бы не использовать стандартный режим напрямую?
Стандартный режим больше подходит для массовых черновиков и приоритета скорости; Quality выбирайте, когда в финальном ролике важнее материалы и детали.
-
Поддерживается ли референсное изображение?
Текущая линейка генерации изображений по тексту не принимает референсные изображения; если требуется высококачественное редактирование по референсному изображению, используйте grok-imagine-quality/image-to-image.
Создать задачу генерации
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-quality/image-to-image
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для grok-imagine-quality/image-to-image и маршрута default — см. таблицу параметров ниже.
promptstringОбязательноminLength 1maxLength 8000Текст инструкции для редактирования изображения, описывающий желаемый результат вывода; передаётся в виде строки, содержимое напрямую определяет направление редактирования.
image_urlsarrayОбязательноminItems 1maxItems 3Массив входных референсных изображений, элементы — общедоступные URL изображений, поддерживаются форматы jpeg/png/webp, SVG не поддерживается; количество от 1 до 3.
Array [ string ]
resolutionstringНеобязательноПо умолчанию: "1k"Разрешение выходного изображения, передаётся в виде строки; по умолчанию 1k.
1k2kaspect_ratiostringНеобязательноПо умолчанию: "auto"Соотношение сторон генерируемого изображения, передаётся в виде строки; при значении auto используется соотношение сторон первого входного изображения; по умолчанию auto.
auto2:120:919.5:916:94:33:21:1Показать все (6)
2:33:49:169:19.59:201:2output_formatstringНеобязательноПо умолчанию: "jpeg"Формат выходного изображения, передаётся в виде строки; по умолчанию jpeg.
jpegpngwebpcallbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "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-quality/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-quality/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-quality/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"
} Получить детали задачи
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"
}
}
} Статьи
Все статьи →-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Сравнительный обзор
Recraft v4.1 Flash 文生图横向对比:开发者选型与迁移指南
用每张 $0.01 的成本与纯文生图能力,判断它是否适合你的图像生成流水线
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Практика генерации изображений по тексту с recraft-v4.1-flash: 5 ценных бизнес-сценариев и ключевые моменты интеграции
Отталкиваясь от стоимости $0.01 за изображение, спланируйте внедрение генерации изображений в реальные бизнес-процессы
-
Сравнительный обзор
hailuo-2.3-fast/image-to-video — горизонтальное сравнение: как выбрать модель «изображение в видео» и что учесть при миграции
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
Похожие модели
Все модели →Тот же тип
-
Wan 2.7 Image Alibaba $0.035 /изображение -
Recraft Creative Upscale Recraft $0.357 /изображение -
FLUX.1 Fill Pro Black Forest Labs $0.071 /изображение -
Nano Banana 2 Google $0.036 /изображение -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /изображение -
Seedream 4.5 ByteDance $0.045 /изображение -
Qwen Image 3.0 Alibaba $0.036 /изображение -
Krea 2 Medium Turbo Krea $0.021 /изображение -
FLUX.2 Black Forest Labs $0.035 /изображение -
Recraft V4.1 Recraft $0.010 /изображение -
Muse Image 1.0 Meta $0.015 per task -
FLUX.1 Kontext Max Black Forest Labs $0.071 /изображение







