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

# Nano Banana Pro

> Продвинутая генерация изображений с Nano Banana Pro

Nano Banana Pro — улучшенная версия с поддержкой генерации изображений до 4K разрешения, точным рендерингом текста и до 8 референс-изображений.

<Note>
  Полная документация API: [Генерация медиа](/api-reference/media/create)
</Note>

## Обзор

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

## Преимущества Pro версии

<CardGroup cols={2}>
  <Card title="Высокое разрешение" icon="expand">
    Генерация изображений до 4K разрешения
  </Card>

  <Card title="Точный рендеринг текста" icon="font">
    Улучшенная генерация текста на изображениях
  </Card>

  <Card title="Авто-соотношение" icon="crop">
    Автоматический выбор оптимального aspect ratio
  </Card>

  <Card title="Детализация" icon="magnifying-glass">
    Более точная проработка мелких деталей
  </Card>
</CardGroup>

## Сценарии использования

<CardGroup cols={2}>
  <Card title="Профессиональная фотография" icon="camera">
    Коммерческие съёмки и каталоги
  </Card>

  <Card title="Печатная продукция" icon="print">
    Баннеры, постеры, полиграфия высокого качества
  </Card>

  <Card title="Детальные иллюстрации" icon="image">
    Сложные композиции с множеством элементов
  </Card>

  <Card title="Брендинг" icon="building">
    Визуальные материалы для брендов
  </Card>
</CardGroup>

## Примеры запросов

### Генерация изображения в высоком разрешении

<CodeGroup>
  ```typescript TypeScript theme={null}
  const response = await fetch('https://polza.ai/api/v1/media', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer <POLZA_AI_API_KEY>',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      model: 'google/gemini-3-pro-image-preview',
      input: {
        prompt: 'Фотореалистичный портрет бизнесмена в современном офисе, профессиональное студийное освещение',
        aspect_ratio: '1:1',
        image_resolution: '2K',
        output_format: 'png'
      }
    })
  });

  const result = await response.json();
  console.log(result);
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://polza.ai/api/v1/media',
      headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
      json={
          'model': 'google/gemini-3-pro-image-preview',
          'input': {
              'prompt': 'Фотореалистичный портрет бизнесмена в современном офисе, профессиональное студийное освещение',
              'aspect_ratio': '1:1',
              'image_resolution': '2K',
              'output_format': 'png'
          }
      }
  )

  print(response.json())
  ```

  ```bash cURL theme={null}
  curl -X POST "https://polza.ai/api/v1/media" \
    -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "google/gemini-3-pro-image-preview",
      "input": {
        "prompt": "Фотореалистичный портрет бизнесмена в современном офисе, профессиональное студийное освещение",
        "aspect_ratio": "1:1",
        "image_resolution": "2K",
        "output_format": "png"
      }
    }'
  ```
</CodeGroup>

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

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

  const result = await response.json();
  console.log(result);
  ```

  ```python Python theme={null}
  import requests

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

  print(response.json())
  ```

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

## Параметры

| Параметр           | Тип    | Обязательный | Описание                                                                                            |
| ------------------ | ------ | ------------ | --------------------------------------------------------------------------------------------------- |
| `model`            | string | Да           | ID модели: `google/gemini-3-pro-image-preview`                                                      |
| `prompt`           | string | Да           | Текстовое описание желаемого изображения (до 20 000 символов)                                       |
| `aspect_ratio`     | string | Нет          | Соотношение сторон: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `auto` |
| `image_resolution` | string | Нет          | Разрешение: `1K`, `2K`, `4K`                                                                        |
| `output_format`    | string | Нет          | Формат вывода: `png`, `jpeg`                                                                        |
| `images`           | array  | Нет          | Массив референс-изображений для редактирования (до 8 шт.)                                           |

## Пример запроса (cURL)

```bash theme={null}
curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3-pro-image-preview",
    "input": {
      "prompt": "Описание изображения",
      "aspect_ratio": "1:1",
      "image_resolution": "2K",
      "images": []
    },
    "async": true
  }'
```

## Сравнение с базовой версией

| Функция                 | Nano Banana | Nano Banana Pro |
| ----------------------- | ----------- | --------------- |
| Максимальное разрешение | Стандартное | До 4K           |
| Точность текста         | Базовая     | Улучшенная      |
| Авто aspect ratio       | Нет         | Да              |
| Детализация             | Стандартная | Повышенная      |

## Советы и лучшие практики

<AccordionGroup>
  <Accordion title="Используйте 4K для печати" icon="print">
    Для печатной продукции выбирайте `image_resolution: "4K"` для максимального качества.
  </Accordion>

  <Accordion title="Детализируйте освещение" icon="lightbulb">
    Pro версия отлично обрабатывает сложные световые схемы — описывайте их подробно.
  </Accordion>

  <Accordion title="Используйте auto для соотношения" icon="crop">
    Параметр `aspect_ratio: "auto"` позволит модели выбрать оптимальное соотношение для вашего контента.
  </Accordion>
</AccordionGroup>

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Seedream 4" icon="sparkles" href="/gaidy/seedream-4">
    Альтернативная модель для генерации изображений
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/media/create">
    Полная документация Media API
  </Card>
</CardGroup>