Введение
Отправьте описание сцены и выберите квадратную, вертикальную или горизонтальную композицию.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Изображение |
| Компания-разработчик | 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 символов; это поле не выбирает другую цену изображения. Не менее 1 символов · Не более 8000 символов |
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 text-to-image создаёт картинку из описания. Начните здесь, если сцена задумана без готовой фотографии-источника. Робот-миниатюра и фотографический портрет примерочной показывают два способа собрать задание вокруг героя и окружения.
Здесь есть prompt и пропорции холста. Выберите форму под макет, текст потратьте на содержимое. Для принятого фото товара с новой этикеткой или другой правкой используйте соседний image-to-image.
Параметры композиции
| Параметр | Допустимое значение | Применение |
|---|---|---|
| prompt | Описание до 8 000 символов | Герой, действие, материалы, место и свет. |
aspect_ratio | 1:1, 2:3, 3:2, 16:9, 9:16 | Пропорции холста; исходно 1:1. |
Вертикаль может использовать 2:3 или 9:16, широкая сцена — 3:2 либо 16:9. Примерочная использует 2:3 для мужчины и зеркальной комнаты. Без изменения aspect_ratio остаётся квадрат. Выбирайте настройку даже при слове «вертикальный» в промпте.
Промпт для понятной сцены
Свяжите героя с действием
Дайте центру ясное занятие. Робот-садовник поливает бонсай: персонаж, вода и растение относятся к одному действию. В примерочной мужчина может держать шёлковую рубашку, связывая реквизит со сценой. Для человеческих персонажей обозначьте возраст от тридцати лет и старше.
Назначение поверхностей и света
Материалы объясняют видимое: мох на металле, шёлк рядом со строгими брюками, полированное зеркало в тёплом магазине. Добавьте макромасштаб или мягкий свет бутика. Используйте конкретные решения для героя вместо несвязанных стилевых меток.
Опишите проверяемую расстановку
Для зеркал объясните связь с героем и проверьте отражения. Для масштаба миниатюры задайте соседнее растение и расстояние просмотра. Это передаёт замысел, но не гарантирует физической точности. Запишите важные детали для оценки по единым требованиям.
Наблюдения примеров
- Моховой робот поливал бонсай с хорошей макротекстурой. Это свидетельство показанного материала, не всех маленьких сцен.
- Примерочная дала портрет 2:3 мужчины без рубашки с шёлковой рубашкой. Угловые зеркала согласованно повторили его отражение.
- Чайная банка относится к правке: этикетка изменилась, крышка, стол и свет остались. Выбирайте тот эндпоинт, если начинаете с готовых деталей.
Галерея — набор наблюдаемых результатов. Миниатюра и отражения отдельны, без измеренного обещания того же качества в другом промпте. Дополнительные идеи — предложения, а не итоги тестов.
Цена и пределы запроса
Картинка имеет фиксированную цену, поддерживаемые пропорции её не меняют. До запуска смотрите сумму на странице Grok Imagine Image 2.0. Ошибки генерации бесплатны.
Издатель применяет собственный фильтр содержания; отмеченный запрос отклоняется без оплаты. Соблюдайте предел prompt и список пропорций. Здесь нет выбора разрешения или качества; не переносите настройки общего обзора в это задание.
Готовое изображение доступно 14 дней, затем удаляется. Скачайте принятое, сохраните текст и пропорции. Для новой попытки ясно измените требование и сравните по прежнему заданию.
Сценарий следующей задачи
Для направленной правки с сохраняемыми деталями принесите картинку в image-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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.










