API изображений Grok Imagine: текст в изображение, изображение в изображение и Quality

Ключевые моменты

• API изображений Grok Imagine на HiAPI включает четыре эндпоинта: стандартная версия и Quality, каждая из которых предоставляет текст в изображение и изображение в изображение. Структура запросов у всех четырёх одинакова, отличается только id модели.
• Стандартная версия стоит $0.03 за изображение как при 1K, так и при 2K. Quality — $0.07 при 1K и $0.10 при 2K. За изображение в изображение взимается небольшая дополнительная плата за каждое референсное изображение (1–3 референса).
• При одном и том же промпте стандартная версия нарисовала обычный конус без ручки и рёбер жёсткости; Quality же нарисовала узнаваемую пуровер-воронку. Можно использовать стандартную версию для черновиков и массовых задач, а Quality — для финального результата.Откройте страницу модели текст в изображение и попробуйте; новые аккаунты получают 200 бесплатных кредитов.

Какой эндпоинт выбрать

id модели	Входные данные	Цена за изображение	Сценарии использования
grok-imagine/text-to-image	промпт	$0.03 (1K и 2K)	черновики, массовая генерация, сверхширокие баннеры
grok-imagine-quality/text-to-image	промпт	$0.07 (1K) / $0.10 (2K)	финальные изображения продуктов, детали и материалы
grok-imagine/image-to-image	промпт + 1–3 изображения	$0.03 + $0.003 за каждое референсное изображение	композитинг продукта в сцену, пакетная ретушь
grok-imagine-quality/image-to-image	промпт + 1–3 изображения	$0.08 (1K) / $0.10 (2K) + $0.015 за каждое референсное изображение	переосвещение и смена стиля при полном сохранении субъекта

Актуальные цены HiAPI на 19 октября 2026 г. За неудачные задачи плата не взимается.

Редактирование с одним референсным изображением стоит $0.033 в стандартной версии и $0.095 в Quality 1K. Полный обзор серии, включая видео и Grok Imagine Image 2.0, см. в разделе Цены API Grok Imagine.

Один промпт: стандартная версия vs Quality

1:1, 2K, PNG, по одному запуску каждого:

matte ceramic pour-over coffee dripper on a pure white seamless background, studio softbox lighting, centered, no shadow gradient beyond a soft contact shadow, no text, no watermark, no props, e-commerce product photography, sharp focus

Стандартная версия:

grok-imagine/text-to-image, 1:1, 2K, 2048×2048, $0.03, около 80 секунд.

Quality:

Сгенерировать этот промпт в Quality →

grok-imagine-quality/text-to-image, 1:1, 2K, 2048×2048, $0.10, около 78 секунд.

В чём разница:

• Сам объект: стандартная версия отрисовала чистый, но обобщённый конус, больше похожий на миску, чем на воронку. Quality нарисовала все детали, которые делают её пуровер-воронкой: внутренние спиральные рёбра жёсткости, ручку и основание с дренажными отверстиями.
• Оба выполнили требования к фону: чистый белый, по центру, только мягкая контактная тень, без реквизита и текста.
• Одинаковый размер и скорость: оба вернули изображение 2048×2048 примерно за 80 секунд. Уровень качества меняет детализацию, а не размер вывода.

Для известного продукта Quality стоит доплаты в $0.07. Для мудбордов или макетов, где сам объект обобщённый, стандартной версии достаточно.

Изображение в изображение: поместите свой продукт в сцену

Передайте 1–3 публичных URL изображений в image_urls и опишите нужные изменения. Если aspect_ratio задан как auto (значение по умолчанию для изображение в изображение), выходные данные принимают форму первого изображения в списке. Один и тот же промпт, одни и те же два изображения, только изменён порядок — и получились два разных кадрирования:

grok-imagine/image-to-image, изображение продукта первым, возвращает 1248×832 (3:2).

Тот же запрос, изображение сцены первым, возвращает 1024×1024 (1:1).

Чтобы управлять кадрированием, поставьте первым изображение нужной формы или явно задайте aspect_ratio.

В Quality его сильная сторона — изменить одну вещь, сохранив всё остальное неизменным. Это переосвещение сохранило лицо, куртку, чашку и композицию:

Relight this photo as late golden hour: warm low sun coming from the left,
long soft shadows across the table, amber rim light on her hair and jacket.
Keep her face, expression, pose, the corduroy jacket, the marble table, the
coffee cup and the entire composition exactly the same. Photorealistic, same
camera angle, same framing.

grok-imagine-quality/image-to-image, 1K, auto (вход 3:2, выход 1248×832), одно референсное изображение, $0.095, 39 секунд.

Работающая схема: одним предложением укажите, что нужно изменить, затем перечислите всё, что должно остаться неизменным. Дополнительные рецепты см. в разделе Промпты для изображение в изображение Grok Imagine Quality.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/text-to-image",
    "input": {
      "prompt": "A lighthouse on a rocky cliff at golden hour, waves crashing below, photorealistic",
      "aspect_ratio": "2:1",
      "resolution": "2k",
      "output_format": "png"
    }
  }'

Вы получите taskId. Опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}, пока data.status не станет success, затем скачайте data.output[0].url. Ссылка истекает, сохраните файл сразу.

Python: все четыре эндпоинта

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, prompt, image_urls=None, timeout_s=300, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    if image_urls:
        body["input"]["image_urls"] = image_urls
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Draft on standard, then re-run the keeper on Quality
draft = generate("grok-imagine/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="1k")
final = generate("grok-imagine-quality/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="2k")

# Composite a product into a scene; the first image sets the shape
edit = generate("grok-imagine/image-to-image",
                "Place the product from the first image on the desk in the second image, matching its light",
                image_urls=["https://your-cdn.example.com/product.jpg",
                            "https://your-cdn.example.com/scene.jpg"])

Параметры

Поле	Обязательно	Значения	Описание
prompt	Да	текст	Всё, что вы хотите или чего хотите избежать, пишите здесь
image_urls	Только для изображение в изображение	1–3 URL	jpeg, png или webp; SVG не поддерживается; каждое референсное изображение увеличивает цену
aspect_ratio	Нет	2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2; изображение в изображение также принимает auto	auto следует за первым изображением
resolution	Нет	1k (по умолчанию), 2k	в нижнем регистре; влияет на цену только в Quality
output_format	Нет	jpeg (по умолчанию), png, webp

Сверхширокие 2:1 и 20:9 подходят для баннеров. 21:9 нет; используйте 20:9.

Ошибки, с которыми вы столкнётесь

Все перечисленные ниже ошибки возвращают HTTP 400 при отправке, поэтому задача не создаётся и плата не взимается:

• resolution: value must be one of '1k', '2k': вы отправили 2K. Используйте нижний регистр.
• aspect_ratio: value must be one of ...: обычно это 21:9. Используйте 20:9.
• additional properties 'n' not allowed (или seed, negative_prompt, size): этих полей не существует. Одна задача генерирует одно изображение; для нескольких изображений отправляйте несколько задач.
• image_urls: missing required field: для изображение в изображение требуется хотя бы одно изображение.

Недействительный ключ возвращает 401. Ошибки после создания задачи отображаются при опросе как status: "fail", поэтому проверяйте data.status, а не только HTTP-код.

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

Стандартная версия или Quality?

Черновики делайте в стандартной версии за $0.03. Как только промпт и макет работают, перезапустите финальный результат в Quality. В стандартной версии 2K и 1K стоят одинаково, поэтому там всегда запрашивайте 2k.

Это то же самое, что Grok Imagine Image 2.0?

Нет. grok-imagine-image-2.0 — отдельная, более новая модель по $0.052 за изображение. См. Руководство по API текст в изображение Grok Imagine Image 2.0.

Можно ли получить несколько изображений за один запрос?

Нет. Поля n нет. Отправляйте по одной задаче на изображение; они выполняются параллельно.

Сколько живут выходные данные?

Ссылки output[0].url истекают. Скачивайте и сохраняйте самостоятельно сразу после успешного завершения задачи.

Больше реальных выходных данных: Изображения товарного каталога в стандартной версии и Композитинг сцен из фотографий продуктов. О видео см. Руководство по API видео Grok Imagine.