> ## Documentation Index
> Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana 2

> Генерация изображений до 4K — полный API-гайд

Nano Banana 2 (`google/gemini-3.1-flash-image-preview`) — модель генерации и редактирования изображений с поддержкой до 4K разрешения, точным рендерингом текста и возможностью передавать до 8 референс-изображений.

## Характеристики

| Характеристика       | Nano Banana                     | Nano Banana 2                           |
| -------------------- | ------------------------------- | --------------------------------------- |
| ID модели            | `google/gemini-2.5-flash-image` | `google/gemini-3.1-flash-image-preview` |
| Max prompt           | 20 000 символов                 | 20 000 символов                         |
| Разрешения           | —                               | 1K, 2K, 4K                              |
| Aspect ratio         | 10 вариантов                    | 11 вариантов                            |
| Референс-изображения | до 8                            | до 8                                    |

## Примеры

### Редактирование с референс-изображением

```typescript theme={null}
const response = await fetch('https://speshu.ai/api/v1/async/media/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <SPESHU_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'google/gemini-3.1-flash-image-preview',
    input: {
      prompt: "Добавь текст 'SALE 50%' крупными буквами в центре",
      image_resolution: '4K',
      images: [
        { type: 'url', data: 'https://example.com/banner.jpg' }
      ]
    }
  })
});
```

```python theme={null}
import requests

response = requests.post(
    'https://speshu.ai/api/v1/async/media/tasks',
    headers={'Authorization': 'Bearer <SPESHU_AI_API_KEY>'},
    json={
        'model': 'google/gemini-3.1-flash-image-preview',
        'input': {
            'prompt': "Добавь текст 'SALE 50%' крупными буквами в центре",
            'image_resolution': '4K',
            'images': [
                {'type': 'url', 'data': 'https://example.com/banner.jpg'}
            ]
        }
    }
)
```

```bash theme={null}
curl -X POST "https://speshu.ai/api/v1/async/media/tasks" \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "input": {
      "prompt": "Добавь текст SALE 50% крупными буквами в центре",
      "image_resolution": "4K",
      "images": [
        { "type": "url", "data": "https://example.com/banner.jpg" }
      ]
    }
  }'
```

## Ответ

API возвращает объект с ID задачи:

```json theme={null}
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "018f3b..."
  }
}
```

Опросите статус через `GET /async/media/tasks/{task_id}`:

```bash theme={null}
curl "https://speshu.ai/api/v1/async/media/tasks/018f3b..." \
  -H "Authorization: Bearer <SPESHU_AI_API_KEY>"
```

### Статусы

| Статус       | Описание                              |
| ------------ | ------------------------------------- |
| `waiting`    | В очереди                             |
| `processing` | Генерация выполняется                 |
| `success`    | Готово, URL результата в `resultJson` |
| `fail`       | Ошибка, описание в `failMsg`          |

> **Note:** Результаты хранятся **7 дней**. Для постоянного хранения используйте [Storage API](/docs/api-reference/storage/upload) с политикой `PERMANENT`.

## Советы

### 4K для печати

Для полиграфии и баннеров выбирайте `image_resolution: "4K"` — это максимальное качество модели.

### Точный рендеринг текста

Nano Banana 2 хорошо рендерит текст на изображениях. Указывайте шрифт, размер и расположение в промпте.

### Детализируйте освещение

Модель отлично обрабатывает сложные световые схемы — описывайте их подробно: студийный свет, боковое освещение, время суток.