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 ещё не являются готовым изображением. Сохраните завершённое изображение вместе с заданием и выбранными настройками для дальнейшего использования.
Полезный итоговый артефакт — изображение, соответствующее заданной сцене, макету или правке. Проверьте полную композицию и мелкие детали, особенно исходный объект, границы предметов, пропорции и смысловые надписи. При последовательной работе меняйте инструкцию, связанную с видимой проблемой, и используйте выбранный результат как следующий референс. Формулируйте желаемое изменение и требования к сохранению конкретно, чтобы каждый результат можно было оценить относительно определённой творческой цели.
", "aboutText": "Grok Imagine Image 2.0 — модель xAI для генерации и редактирования изображений. Она принимает письменное описание либо описание вместе с исходными изображениями и возвращает изображение. Именной профиль 2.0 поставщика охватывает создание сцены, изменение существующего изображения, объединение объектов из референсов и преобразование визуального стиля. Сначала определите, нужна ли вам новая композиция или конкретное изменение уже имеющегося материала.\n\n### Создание изображения по заданию\n\nОпишите основной объект, его окружение, композицию, освещение и визуальное оформление. Укажите, на что зритель должен обратить внимание в первую очередь и где изображение будет использоваться. Например, задание для концепции продукта может описывать керамическую настольную лампу на светлом каменном столе, мягкий свет из окна, крупный план материала и свободное место для отдельного заголовка. Для иллюстрации задайте персонажей, действие и нужную эстетику вместо того, чтобы ожидать от одного слова, обозначающего стиль, определения всей сцены.\n\nПоставщик документирует от одного до десяти изображений на запрос генерации, по умолчанию — одно. Несколько результатов по одному заданию дают альтернативы для проверки; они не гарантируют одинаковый объект во всех вариациях. Проверьте объект, композицию и важные детали, затем сохраните версию, которая лучше всего соответствует заданию. Храните задание и выбранную вариацию вместе, чтобы последующие правки использовали нужную композицию.\n\n### Композиция, разрешение и качество\n\nРуководство по генерации документирует автоматический выбор соотношения сторон или его явное задание. В перечень вариантов входят 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. Подбирайте форму под предполагаемое размещение: квадрат для компактной плитки, вертикаль для вертикальной композиции или горизонталь для широкой сцены. Указывайте объект, чувствительный к обрезке, и пространство, необходимое макету, не полагаясь только на соотношение сторон.\n\nДокументированные настройки разрешения генерации — 1k и 2k, по умолчанию 1k. Качество — отдельная настройка с вариантами low, medium и auto. В текущем руководстве xAI по умолчанию используется auto: low для генерации и medium для редактирования; явное значение low или medium фиксирует выбранный уровень. Таким образом, разрешение и качество описывают разные настройки. Укажите важные визуальные детали и проверьте их в полученном изображении, не считая любую из этих настроек гарантией точных надписей, геометрии или сохранения объекта.\n\n### Редактирование и перенос визуального стиля\n\nПередайте изображение для изменения и опишите нужную правку относительно его видимого содержимого. Например, точечная правка может заменить тёмную стену светлой оштукатуренной поверхностью, сохранив расстановку мебели, положение камеры и тёплое освещение. Если цель — стилистическое преобразование, задайте нужную обработку: поставщик демонстрирует фотографию, аниме, масляную живопись, акварель, поп-арт и карандашный набросок. Укажите, какие элементы должны сохранить внешний вид, а какие могут измениться вместе со стилем.\n\nПроцесс редактирования производителя принимает ссылку на исходное изображение, закодированные данные изображения или идентификатор файла. Для сохранённых референсов используйте полностью загруженные изображения PNG, JPEG или WebP. Руководство также описывает последовательные правки: результат одного редактирования становится исходником для следующего. Так базовую композицию можно довести до более конкретного результата, сначала изменив мебель, а затем скорректировав освещение. Сохраняйте оригинал и выбранное промежуточное изображение в связи с каждым заданием, чтобы последующую доработку можно было проверить относительно задуманной композиции.\n\n### Объединение нескольких референсов\n\nТекущее руководство по работе с несколькими изображениями допускает до пяти исходных изображений в одной правке. Ссылайтесь на них в порядке передачи и задавайте каждому ясную роль, например объект из первого изображения и окружение из второго. По умолчанию соотношение сторон результата следует первому входному изображению; явно заданное соотношение позволяет его переопределить. Для концепции продукта в комнате опишите положение продукта, размер и соприкосновение с поверхностями помещения, затем попросите сохранить определяющие его детали. Проверьте, как объединены исходники, не предполагая, что каждый элемент был скопирован без изменений.\n\n### Получение и сохранение изображения\n\nПо умолчанию поставщик возвращает временный адрес изображения и также документирует выдачу изображения в закодированном виде. Оперативно сохраняйте сам файл, когда он нужен как материал проекта. Необязательный отложенный процесс отделяет подтверждение запроса от завершения: за идентификатором запроса следуют статусы pending, done или failed; отложенные результаты используют формат ответа с адресом и документированный срок хранения 24 часа. Отправленный запрос или статус pending ещё не являются готовым изображением. Сохраните завершённое изображение вместе с заданием и выбранными настройками для дальнейшего использования.\n\nПолезный итоговый артефакт — изображение, соответствующее заданной сцене, макету или правке. Проверьте полную композицию и мелкие детали, особенно исходный объект, границы предметов, пропорции и смысловые надписи. При последовательной работе меняйте инструкцию, связанную с видимой проблемой, и используйте выбранный результат как следующий референс. Формулируйте желаемое изменение и требования к сохранению конкретно, чтобы каждый результат можно было оценить относительно определённой творческой цели.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "345642981c2c3343cbde602b6fcfaf8a1818a59af825e2a716193bb7cbdd6ff9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "x-ai/grok-imagine-image-2.0Grok Imagine Image 2.0 создаёт изображения по письменным заданиям и редактирует существующие изображения с помощью инструкций на естественном языке. xAI документирует настраиваемые качество, разрешение и композицию, работу с несколькими изображениями-референсами, перенос стиля и последовательную доработку.
Описание раскрывает возможности модели. Доступные в 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 ещё не являются готовым изображением. Сохраните завершённое изображение вместе с заданием и выбранными настройками для дальнейшего использования.
Полезный итоговый артефакт — изображение, соответствующее заданной сцене, макету или правке. Проверьте полную композицию и мелкие детали, особенно исходный объект, границы предметов, пропорции и смысловые надписи. При последовательной работе меняйте инструкцию, связанную с видимой проблемой, и используйте выбранный результат как следующий референс. Формулируйте желаемое изменение и требования к сохранению конкретно, чтобы каждый результат можно было оценить относительно определённой творческой цели.
POST /v1/images/generationstext, imageimage| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Поле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}
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| Конфигурациявходное изображение | Шкала ставок— | Прогноз количества— | Расчётная единицаза входное изображение | Плата Вход · входное изображение · Оценка только для сравнения $0.02 за входное изображение |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.08 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nЗагрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nСохраните каждое готовое изображение; загрузите содержимое по каждому полученному 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