Mage API · Модель изображений
API Grok Image
Grok Imagine в двух вариантах
POST https://api.mage.space/v1/grok_image/generateГлавное
Grok Image API запускает Grok Image 2.0 и ещё один вариант через Mage по адресу POST https://api.mage.space/v1/grok_image/generate. Запрос с настройками по умолчанию стоит 90 Gems (около 0,09 $), без подписки. Grok Image поддерживает сохранённых персонажей и референсы по @handle в промпте.
- ИзображениеРезультат
- 2Варианты
- 90Gems за изображение по умолчанию
- $0.09Примерно, в USD
Обзор
Что умеет API Grok Image
Модель изображений Grok Imagine от xAI в двух вариантах. Создаёт или редактирует изображения по референсам (до 3 штук), сохраняя детали оригинала. Действует фильтр безопасности xAI.
Модели изображений Grok Imagine от xAI в двух вариантах для генерации и редактирования по референсам: Grok Image 2.0 (`grok-imagine-image-2.0`) — по умолчанию, и Grok Image (`grok-imagine-image`) для недорогих черновиков. xAI отключила Grok Image Quality (`grok-imagine-image-quality`) 2 ноября 2026 года, запрос с этой моделью будет отклонён. Действует фильтр безопасности xAI.
На вход принимает image, additional_images.
Быстрый старт
Вызов API Grok Image
Задайте MAGE_API_KEY, отправьте запрос на /grok_image/generate и опрашивайте status_url, пока запрос не выполнится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/grok_image/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Модели
Значения model_id для Grok Image
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Да |
Параметры
Параметры Grok Image
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 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 |
| resolution | 1k, 2k |
Входные данные
Какие медиафайлы принимает Grok Image
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
Другие модели изображений
Другие API для генерации изображений на Mage
Guava API
Фотореализм, неотличимый от настоящего снимка
HiDream API
Быстрая и универсальная, с негативными промптами
Krea 2 API
Потрясающая эстетика за секунды
Mango API
Наше флагманское семейство моделей для изображений
MiniMax H3 Image API
Нативные изображения 16 мегапикселей, открытые веса
MOSS-Image API
Длинные промпты и двуязычный текст, открытые веса
FAQ
Частые вопросы
Сколько стоит API Grok Image?
Какой endpoint у API Grok Image?
Какие модели Grok Image можно вызывать?
Поддерживает ли Grok Image референсы и персонажей?
Можно ли использовать Grok Image из Claude или ChatGPT?
Как долго хранятся результаты Grok Image?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.