API Guava

Главное

API Guava запускает Guava и ещё 4 варианта через Mage по адресу POST https://api.mage.space/v1/guava/generate. Запрос с настройками по умолчанию стоит 37 Gems (около $0,037), без подписки. Сохранённые персонажи и референсы подставляются через @handle в промпте.

• Изображение

  Результат

• 5

  Варианты

• 37

  Gems за изображение по умолчанию

• $0.037

  Примерно, в USD

Обзор

Что умеет API Guava

Наше семейство фотореалистичных моделей для портретов, моды и предметной съёмки с натуральной кожей, тканями и светом. Принимает референсы и Characters, до 2K.

Семейство фотореалистичных моделей Mage для портретов, моды и предметной съёмки, которые не отличить от настоящих фотографий, с поддержкой референсов. Сейчас актуальная пара — Guava 2 и Guava 2 Pro.

На вход принимает image, additional_images.

Быстрый старт

Как вызвать Guava API

Задайте MAGE_API_KEY, отправьте запрос на /guava/generate и опрашивайте status_url, пока запрос не завершится.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "guava"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('guava', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'guava',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("guava", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "guava",
})

print(request["result"]["url"])

Модели

Значения model_id для Guava

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

Параметры

Параметры Guava

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

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

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

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

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

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

FAQ

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

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

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

Похожие материалы

• API нейросети для генерации изображений
• Справочник по Guava API
• Песочница Guava
• Все модели API
• MCP-сервер Mage