Mage API · Модель зображень
API Grok Image
Grok Imagine у трьох рівнях якості
POST https://api.mage.space/v1/grok_image/generateКоротко
API Grok Image запускає Grok Image Quality і ще 2 варіанти через Mage за адресою POST https://api.mage.space/v1/grok_image/generate. Запит із типовими налаштуваннями коштує 75 Gems (приблизно $0.075), без підписки. Grok Image приймає збережених персонажів і референси за @handle у промпті.
- ЗображенняРезультат
- 3Варіанти
- 75Gems за зображення, типово
- $0.075Приблизно, у USD
Огляд
Що вміє API Grok Image
Модель зображень Grok Imagine від xAI у трьох рівнях якості. Генерує або редагує за допомогою до 3 референсних зображень, зберігаючи деталі оригіналу. Діє фільтр безпеки xAI.
Моделі зображень Grok Imagine від xAI у трьох рівнях якості — для генерації та редагування за референсними зображеннями. Діє фільтр безпеки 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-quality"
}' | 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-quality',
});
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-quality",
})
print(request["result"]["url"])Моделі
Значення model_id для Grok Image
Передайте model_id, щоб вибрати варіант. Запит без нього використовує варіант за замовчуванням.
| model_id | Назва | За замовчуванням |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-quality | Grok Image Quality | Так |
| 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
Наша флагманська лінійка моделей для зображень
Nano Banana 2 API
Чіткий, читабельний текст, до 4K
API SDXL Plus
SDXL з виправленими обличчями та руками
Поширені запитання
Поширені запитання
Скільки коштує API Grok Image?
Яка кінцева точка API Grok Image?
Які моделі Grok Image можна викликати?
Чи підтримує Grok Image референсні зображення або персонажів?
Чи можна використовувати Grok Image у Claude або ChatGPT?
Як довго зберігаються результати Grok Image?
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.