Введение
Пронумеруйте переданные изображения в промпте и укажите нужную замену или правку.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Компания-разработчик | xAI |
| Идентификатор | grok/imagine-image-2.0 |
| Сценарии изображения | Генерация по тексту и редактирование по изображениям |
| Лимит инструкции | До 8 000 символов в обоих сценариях |
| Источники правки | От 1 до 5 изображений в |
| Имена референсов | Image 1, Image 2 и далее по порядку входа |
| Поддерживаемые пропорции | 1:1, 2:3, 3:2, 16:9, 9:16 |
| Исходный холст | 1:1 для генерации и правки |
| Основа тарифа | Фиксированная цена за картинку; пропорции её не меняют; неудачные задачи бесплатны |
| Доступ к файлам | Созданные файлы удаляются через 14 дней |
Ключевые возможности и особенности
Одна примерочная, несколько отражений
Примерочная 2:3 показывает мужчину с шёлковой рубашкой среди угловых зеркал и тёплого света бутика. В этом результате отражения согласованы. Используйте сцену для совместного задания героя, одежды-реквизита, комнаты и света; каждый раз проверяйте отражения.
Моховой садовник рядом с бонсай
Тест робота дал покрытого мхом героя, поливающего бонсай, с убедительной макротекстурой. Маленький объект, ясное действие и близкий вид объясняют масштаб. Опишите поверхность и свет, затем оцените результат: это свидетельство конкретной миниатюры, не общий балл качества.
Замените этикетку, оставьте окружение
В тесте чайной банки рисованная цветочная этикетка с золотой фольгой заменила простой дизайн при сохранении крышки, стола и света. Это точечная правка с названным сохранением. Обозначьте банку Image 1, опишите этикетку и сохраняемое, затем сравните с фото.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите правки в пределах 8 000 символов, называя исходники Image 1, Image 2 и далее; длина промпта не меняет фиксированную цену изображения. Не менее 1 символов · Не более 8000 символов |
image_urls | Да | Передайте 1–5 URL исходных изображений для правки; число входных файлов не образует отдельного ценового уровня. Не менее 1 элементов · Не более 5 элементов |
aspect_ratio | Нет | Для правок доступны 1:1, 2:3, 3:2, 16:9 и 9:16; по умолчанию — 1:1, цена одинакова для всех форм. |
Стоимость
$0.028 / изображение
Правки Grok оплачиваются за каждое выходное изображение по фиксированному тарифу; соотношение сторон не меняет цену, неудачные правки бесплатны.
Сценарии использования
Модные сцены бутика
Стройте портрет вокруг одежды, тёплого магазинного света и угловых зеркал. Примерочная 2:3 последовательно отражает того же мужчину и даёт конкретный ориентир композиции.
Миниатюрные миры с материалами
Задайте маленькому персонажу понятную работу вместо списка несвязанных вещей. Моховой робот поливал бонсай; тест показал фактурную поверхность макросцены.
Оформление готовой чайной банки
Начните с принятого фото товара и запросите этикетку. Измеренная правка добавила рисованные цветы сливы и золотую фольгу, сохранив крышку, стол и свет.
Правки с ролями источников
Используйте до пяти картинок, если нужно несколько источников. Объясните вклад каждого номера и сохраняемые детали: число входов — настройка, а не доказательство совпадения любой композиции с референсом.
Портретные и широкие концепции
До генерации выберите вертикальный, квадратный или широкий холст под размещение. Пять пропорций доступны обоим сценариям; переход между ними цену не меняет.
Руководство по промптам и практические советы
Выберите новый кадр или правку
Начните с описания новой картинки или одной–пяти исходных для изменения. Используйте разрешённые фотографии; люди во входах должны быть совершеннолетними без имитации личности.
Опишите сцену либо изменение
Для новой сцены задайте героя, действие, место и свет. В правке назначьте роли Image 1, Image 2 и следующим, затем сохраняемые детали.
Подберите форму размещения
Выберите 1:1, 2:3, 3:2, 16:9 или 9:16 под композицию. Исходно квадрат; форма не влияет на цену изображения.
Оцените детали и сохраните
Сверьте результат с заданием, особенно отражения и сохраняемые предметы. Скачайте в пределах 14 дней доступности и храните с промптом.
Правка картинки с названными изменениями
Редактор Grok Imagine Image 2.0 начинает с одной–пяти картинок и инструкции. Подходит, если фото или дизайн уже содержит сохраняемые детали. Источник даёт материал, prompt объясняет изменение и то, что остаётся.
Чайная банка — точечный пример упаковки. Простая банка получила рисованную этикетку с цветами сливы и золотой фольгой при сохранении крышки, стола и света. Это полезно для похожего замысла, но не устанавливает неизменность остальных деталей любой правки.
Входы и форма результата
| Параметр | Допустимое значение | Подготовка инструкции |
|---|---|---|
| prompt | До 8 000 символов | Изменения, роли и сохраняемые детали. |
image_urls | От 1 до 5 URL картинок | Порядок согласован с Image 1, Image 2 и далее в prompt. |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | Выберите форму результата; исходно 1:1. |
Для этикетки, как в тесте банки, достаточно одного источника. Добавляйте другой ради названного вклада: Image 1 даёт фото товара, Image 2 — рисунок этикетки. Это предлагаемый шаблон, отдельный от измеренного результата банки.
Задайте aspect_ratio частью задания. Формы те же, что у генерации; исходно квадрат. Выбирайте портрет или горизонталь под размещение, не оставляя решение о холсте предложению внутри сцены.
Построение инструкции правки
Разные роли референсов
Ссылайтесь прямо на позиции. Укажите, где банка, где другой элемент дизайна и что задаёт место. До отправки сверяйте с порядком image_urls. Больше референсов означает больше описываемых источников, а не исчезновение необходимости объяснить их связь.
Конкретная замена
Для упаковки меняется рисованная этикетка с цветами сливы и золотыми акцентами. Это объясняет, что разместить на банке. В своём задании называйте предмет и новый дизайн, материал или место вместо неопределённого улучшения.
Перечень сохранения
После изменений назовите сохраняемые части. Инструкция банки фиксирует крышку, стол и свет. Сверьте каждую с источником по получении. Если изменилась нужная деталь, явно назовите её в следующей инструкции и оцените новый результат снова.
Ответственная подготовка портретов
Не выдавайте себя за другого человека, а для изображений людей берите только фотографии взрослых, на использование которых есть разрешение. Портретные идеи страницы задают людей от тридцати лет. Опишите одежду, настроение, место и свет как правку, привязав сохранение к разрешённому человеку источника.
Что установил тест редактирования
Измеренный результат банки добавил цветочный рисунок с золотом, сохранив крышку, стол и исходное освещение. Это конкретное изменение с ясным списком сохранения, не гарантия личности, точных букв или повторных раундов.
Зеркала примерочной — генерация по тексту, не тест стабильности правок. Предложенные портрет и товар из двух источников — новые идеи. Сверяйте правку с её реальными источниками, не считая другой пример доказательством композиции.
Оплата, фильтр и сохранение
Правка оплачивается за выходную картинку по фиксированной цене. aspect_ratio её не меняет. Перед отправкой смотрите текущий тариф модели; ошибка правки бесплатна.
Издатель применяет фильтр содержания: отмеченные запросы отклоняются без платы. Соблюдайте число входов и предел prompt. Здесь перечислены prompt, image_urls и aspect_ratio; обсуждаемые где-либо mask или quality не входят в таблицу.
Скачайте правку за 14 дней до удаления генераций. Храните источники, порядок, принятую инструкцию и скачанное вместе для ясной основы следующей перемены.
Когда выбрать другой эндпоинт
Для новой сцены без сохраняемых картинок используйте text-to-image. Nano Banana 2 Lite принимает до десяти референсов, если нужно больше пяти. Для заданного текста и изменения по маске Ideogram 4.5 имеет эти настройки. Это различия входов и управления, а не обещание сохранения каждой детали.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "xai/grok-imagine-image-2.0/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.











