# Nano Banana 2

> Главная модель Google: быстрые картинки и правка фото, точные надписи на изображении, до 14 фото за раз.

Nano Banana 2 — основная модель Google для картинок. Хорошо сохраняет лица и персонажей, пишет читаемые надписи на изображениях, понимает длинные подробные описания и может взять до 14 ваших фото, чтобы изменить их, объединить или перенести стиль.

| Режим | ID | Цена |
|---|---|---|
| [Изменить фото](#изменить-фото) | `nano-banana-2` | 0.5K $0.015 · 1K $0.015 · 2K $0.020 · 4K $0.025 |
| [Создать картинку](#создать-картинку) | `nano-banana-2` | 0.5K $0.015 · 1K $0.015 · 2K $0.020 · 4K $0.025 |

Оба режима — одна модель `nano-banana-2`: если передать фото, она их отредактирует или использует как референсы.

## Изменить фото

Загрузите фото и опишите, что изменить. ID: `nano-banana-2` · 0.5K $0.015 · 1K $0.015 · 2K $0.020 · 4K $0.025 за картинку · до 1 мин

**Параметры** (поле `input`)

| Параметр | Обязательный | Описание | Значения (по умолчанию — жирным) |
|---|---|---|---|
| `prompt` | да | Что нарисовать или что изменить | текст, до 20000 символов |
| `image_input` | да | Ссылки на ваши фото (https), до 14 шт. | `["https://…"]` |
| `aspect_ratio` | нет | Форма картинки | **`auto`** `1:1` `2:3` `3:2` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` `1:4` `4:1` `1:8` `8:1` |
| `resolution` | нет | Размер по длинной стороне: 0.5K ≈ 512 px, 1K ≈ 1024 px, 2K ≈ 2048 px, 4K ≈ 4096 px. Размеры больше родного — апскейл готовой картинки (Lanczos + лёгкая резкость): 4K у Nano Banana 2 и Pro из 2K, 2K у Nano Banana из 1K, 2K и 4K у GPT Image из родных ~1,5K | `0.5K` **`1K`** `2K` `4K` |
| `output_format` | нет | Формат файла | **`jpg`** `png` |

**Пример**

```bash
curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"Сделай фон ночным неоновым городом","image_input":["https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"],"aspect_ratio":"auto","resolution":"1K"}}'
```

```python
import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "nano-banana-2",
      "input": {
        "prompt": "Сделай фон ночным неоновым городом",
        "image_input": [
          "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
        ],
        "aspect_ratio": "auto",
        "resolution": "1K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "nano-banana-2",
    "input": {
      "prompt": "Сделай фон ночным неоновым городом",
      "image_input": [
        "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
      ],
      "aspect_ratio": "auto",
      "resolution": "1K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Создать картинку

Опишите картинку — модель создаст её с нуля. ID: `nano-banana-2` · 0.5K $0.015 · 1K $0.015 · 2K $0.020 · 4K $0.025 за картинку · до 1 мин

**Параметры** (поле `input`)

| Параметр | Обязательный | Описание | Значения (по умолчанию — жирным) |
|---|---|---|---|
| `prompt` | да | Что нарисовать или что изменить | текст, до 20000 символов |
| `aspect_ratio` | нет | Форма картинки | **`auto`** `1:1` `2:3` `3:2` `3:4` `4:3` `4:5` `5:4` `9:16` `16:9` `21:9` `1:4` `4:1` `1:8` `8:1` |
| `resolution` | нет | Размер по длинной стороне: 0.5K ≈ 512 px, 1K ≈ 1024 px, 2K ≈ 2048 px, 4K ≈ 4096 px. Размеры больше родного — апскейл готовой картинки (Lanczos + лёгкая резкость): 4K у Nano Banana 2 и Pro из 2K, 2K у Nano Banana из 1K, 2K и 4K у GPT Image из родных ~1,5K | `0.5K` **`1K`** `2K` `4K` |
| `output_format` | нет | Формат файла | **`jpg`** `png` |

**Пример**

```bash
curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"Кот-астронавт в неоновом городе, кинематографичный свет","aspect_ratio":"auto","resolution":"1K"}}'
```

```python
import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "nano-banana-2",
      "input": {
        "prompt": "Кот-астронавт в неоновом городе, кинематографичный свет",
        "aspect_ratio": "auto",
        "resolution": "1K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}
```

```javascript
const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "nano-banana-2",
    "input": {
      "prompt": "Кот-астронавт в неоновом городе, кинематографичный свет",
      "aspect_ratio": "auto",
      "resolution": "1K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
```

## Совместимость

Запросы в формате apimart/OpenAI тоже работают:

- `model`: `nano-banana-2`, `google/nano-banana-2`, `nano-banana-2-ext`, `gemini-3.1-flash-image-preview`, `gemini-3.1-flash-image-preview-official`.
- `size` вместо `aspect_ratio`: соотношение (`16:9`) или точный размер (`1600x1200`) — возьмём ближайшее поддерживаемое соотношение.
- Фото можно передать в `image_urls`, `image_input` или `input_urls`. Параметры можно передать и без обёртки `input` — на верхнем уровне тела запроса.
- `resolution` в любом регистре (`1k`, `2K`); `jpg` и `jpeg` — одно и то же. `n` — только `1` (одна картинка за запрос).
- `nsfw_check`, `official_fallback`, `google_search` принимаются, но не влияют на результат.

## Результат

Как у любой задачи: запросите [recordInfo](https://docs.mixmedia.tech/endpoints/record-info) или получите [callback](https://docs.mixmedia.tech/callbacks). Ссылки на картинки — в `resultJson` (хранятся 24 часа).

Свои фото загрузите через [files/upload](https://docs.mixmedia.tech/endpoints/upload) или передайте любые публичные https-ссылки.