Перейти к содержимому

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-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Да

Параметры

Параметры Grok Image

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
aspect_ratio1: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
resolution1k, 2k

Входные данные

Какие медиафайлы принимает Grok Image

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
imageРеференсное изображение.
additional_imagesДополнительные референсные изображения.

Другие модели изображений

Другие API для генерации изображений на Mage

  • Изображения · от 37 Gems

    Guava API

    Фотореализм, неотличимый от настоящего снимка

  • Изображение · от 20 Gems

    HiDream API

    Быстрая и универсальная, с негативными промптами

  • Изображение · от 20 Gems

    Krea 2 API

    Потрясающая эстетика за секунды

  • Изображение · от 42 Gems

    Mango API

    Наше флагманское семейство моделей для изображений

  • Изображение · от 15 Gems

    MiniMax H3 Image API

    Нативные изображения 16 мегапикселей, открытые веса

  • Изображение · от 25 Gems

    MOSS-Image API

    Длинные промпты и двуязычный текст, открытые веса

FAQ

Частые вопросы

Сколько стоит API Grok Image?
Запрос Grok Image с настройками по умолчанию (Grok Image 2.0) стоит 90 Gems, около 0,09 $. Другие разрешения, длительность и варианты модели меняют цену, точная сумма списания указывается в ответе. Если генерация не удалась, Gems возвращаются. Если её заблокировала политика контента Mage, возврата нет.
Какой endpoint у API Grok Image?
POST https://api.mage.space/v1/grok_image/generate с заголовком Authorization: Bearer, содержащим ваш API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Grok Image можно вызывать?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). По умолчанию используется Grok Image 2.0.
Поддерживает ли Grok Image референсы и персонажей?
Grok Image принимает image, additional_images. Сохранённые персонажи и референсы подставляются через @handle в промпте.
Можно ли использовать Grok Image из Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просто назовите Grok Image. Ассистент считывает параметры модели через get_model и называет цену до генерации.
Как долго хранятся результаты Grok Image?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

CharactersСообщество