xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 создаёт изображения по письменным заданиям и редактирует существующие изображения с помощью инструкций на естественном языке. xAI документирует настраиваемые качество, разрешение и композицию, работу с несколькими изображениями-референсами, перенос стиля и последовательную доработку.

Ailoot Ultra · Картинки POST /v1/images/generations x-ai/grok-imagine-image-2.0

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Grok Imagine Image 2.0 — модель xAI для генерации и редактирования изображений. Она принимает письменное описание либо описание вместе с исходными изображениями и возвращает изображение. Именной профиль 2.0 поставщика охватывает создание сцены, изменение существующего изображения, объединение объектов из референсов и преобразование визуального стиля. Сначала определите, нужна ли вам новая композиция или конкретное изменение уже имеющегося материала.

Создание изображения по заданию

Опишите основной объект, его окружение, композицию, освещение и визуальное оформление. Укажите, на что зритель должен обратить внимание в первую очередь и где изображение будет использоваться. Например, задание для концепции продукта может описывать керамическую настольную лампу на светлом каменном столе, мягкий свет из окна, крупный план материала и свободное место для отдельного заголовка. Для иллюстрации задайте персонажей, действие и нужную эстетику вместо того, чтобы ожидать от одного слова, обозначающего стиль, определения всей сцены.

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

Композиция, разрешение и качество

Руководство по генерации документирует автоматический выбор соотношения сторон или его явное задание. В перечень вариантов входят 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 и 5:2. Подбирайте форму под предполагаемое размещение: квадрат для компактной плитки, вертикаль для вертикальной композиции или горизонталь для широкой сцены. Указывайте объект, чувствительный к обрезке, и пространство, необходимое макету, не полагаясь только на соотношение сторон.

Документированные настройки разрешения генерации — 1k и 2k, по умолчанию 1k. Качество — отдельная настройка с вариантами low, medium и auto. В текущем руководстве xAI по умолчанию используется auto: low для генерации и medium для редактирования; явное значение low или medium фиксирует выбранный уровень. Таким образом, разрешение и качество описывают разные настройки. Укажите важные визуальные детали и проверьте их в полученном изображении, не считая любую из этих настроек гарантией точных надписей, геометрии или сохранения объекта.

Редактирование и перенос визуального стиля

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

Процесс редактирования производителя принимает ссылку на исходное изображение, закодированные данные изображения или идентификатор файла. Для сохранённых референсов используйте полностью загруженные изображения PNG, JPEG или WebP. Руководство также описывает последовательные правки: результат одного редактирования становится исходником для следующего. Так базовую композицию можно довести до более конкретного результата, сначала изменив мебель, а затем скорректировав освещение. Сохраняйте оригинал и выбранное промежуточное изображение в связи с каждым заданием, чтобы последующую доработку можно было проверить относительно задуманной композиции.

Объединение нескольких референсов

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

Получение и сохранение изображения

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

Полезный итоговый артефакт — изображение, соответствующее заданной сцене, макету или правке. Проверьте полную композицию и мелкие детали, особенно исходный объект, границы предметов, пропорции и смысловые надписи. При последовательной работе меняйте инструкцию, связанную с видимой проблемой, и используйте выбранный результат как следующий референс. Формулируйте желаемое изменение и требования к сохранению конкретно, чтобы каждый результат можно было оценить относительно определённой творческой цели.

Ailoot Ultra · Картинки POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения x-ai/grok-imagine-image-2.0	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`resolution`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1K, 2K	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto	По умолчанию—
Поле`quality`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения low, medium	По умолчанию—
Поле`n`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 1	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 0 Максимум элементов: 3	По умолчанию—
Поле`provider`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt
Параметр`material_types`	Контрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Расчётная единица	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Расчётная единица—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациявходное изображение	Шкала ставок—	Прогноз количества—	Расчётная единицаза входное изображение	Плата Вход · входное изображение · Оценка только для сравнения $0.02 за входное изображение
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.08 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

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

Ailoot Ultra · Картинки

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Чтение другого содержимого

Читать существующие материалы, принадлежащие вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа

Поле	Тип
Поле`created`	Тип
Поле`data[].url`	Тип
Поле`data[].b64_json`	Тип
Поле`usage`	Тип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra x-ai/grok-imagine-image-2.0

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Какие входные данные и результаты доступны?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Какие ограничения действуют?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0