Mage API · Модель изображений
Nano Banana 2 API
Чёткий читаемый текст, до 4K
POST https://api.mage.space/v1/nano_banana_v2/generateГлавное
Nano Banana 2 API запускает Nano Banana 2.1 и ещё один вариант через Mage по адресу POST https://api.mage.space/v1/nano_banana_v2/generate. Запрос с настройками по умолчанию стоит 51 Gems (около $0,051), без подписки. Nano Banana 2 поддерживает сохранённых персонажей и референсы: указывайте их в промпте через @handle.
- ИзображениеРезультат
- 2Варианты
- 51Gems за изображение по умолчанию
- $0.051Примерно, в USD
Обзор
Что умеет Nano Banana 2 API
Модели Google для создания изображений: графика и маркетинговый контент с разборчивым текстом. Лидер семейства — Nano Banana 2.1; обе модели генерируют или редактируют изображения по 14 референсам в разрешении до 4K. Действует фильтр безопасности Google.
Модели Google Nano Banana для графики с читаемым текстом и редактирования по 14 референсам в разрешении до 4K. Nano Banana 2.1 (`nano-banana-v2.1`) используется по умолчанию и стоит дешевле; Nano Banana 2 (`nano-banana-v2`) также умеет рендерить в 512. Действует фильтр безопасности Google.
На вход принимает image, additional_images.
Быстрый старт
Вызов API Nano Banana 2
Задайте MAGE_API_KEY, отправьте запрос на /nano_banana_v2/generate и опрашивайте status_url, пока запрос не завершится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/nano_banana_v2/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": "nano-banana-v2.1"
}' | 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('nano_banana_v2', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'nano-banana-v2.1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("nano_banana_v2", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "nano-banana-v2.1",
})
print(request["result"]["url"])Модели
Значения model_id для Nano Banana 2
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| nano-banana-v2 | Nano Banana 2 | |
| nano-banana-v2.1 | Nano Banana 2.1 | Да |
Параметры
Параметры Nano Banana 2
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 1:1, 3:2, 2:3, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 |
| resolution | 512, 1K, 2K, 4K |
Входные данные
Какие медиафайлы принимает Nano Banana 2
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
Другие модели изображений
Другие API для генерации изображений на Mage
API SDXL Plus
SDXL с исправленными лицами и руками
Seedream API
Seedream со строгим фильтром
Stable Diffusion v1.5 API
Классика по доступной цене
Stable Diffusion v3.5 Large API
Stable Diffusion, который лучше всех понимает запросы
Stable Diffusion XL API
SDXL, настроенная на фотореализм
Z-Image API
Самая быстрая модель для изображений в Mage
FAQ
Частые вопросы
Сколько стоит API Nano Banana 2?
Какой эндпоинт у API Nano Banana 2?
Какие модели Nano Banana 2 можно вызывать?
Поддерживает ли Nano Banana 2 референсы и персонажей?
Можно ли использовать Nano Banana 2 из Claude или ChatGPT?
Как долго хранятся результаты Nano Banana 2?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.