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

# Gemini API: генерация по тексту

> Создавайте изображения Nano Banana через Gemini API BetterToken. Выберите модель, описание, разрешение и пропорции и отправьте запрос в интерактивной панели.

Создавайте изображения по описанию с Nano Banana Pro, 2 или 2.1.

`POST /v1beta/models/{model}:generateContent`

Генерация по тексту и редактирование используют один адрес API. Для редактирования в запрос добавляют референс.

## Проверить запрос

Введите BetterToken API Key в **x-goog-api-key**, выберите **model** и измените описание в **contents**. Начните с `1K` и `1:1`, затем нажмите **Send**.

<Note>
  Нажатие **Send** отправляет реальный запрос генерации и может привести к списанию средств. Дождитесь синхронного ответа. После тайм-аута или обрыва проверьте историю расходов и результат запроса, прежде чем отправлять его повторно.
</Note>

Все три модели предлагают `1K`, `2K` и `4K`. Nano Banana 2 и 2.1 поддерживают 14 пропорций, Pro — 10. `X-BetterToken-Max-Images` ограничивает число возвращаемых и оплачиваемых изображений, но не гарантирует это количество. [Пропорции](/api-reference/nano-banana#aspect-ratios)

<Warning>
  BetterToken API не поддерживает генерацию с поиском, включая Google Web Search и Image Search grounding. Не добавляйте поисковые инструменты.
</Warning>

Для генерации по тексту достаточно описания; референс не нужен. Используйте нестриминговый `generateContent`. Files, Batch, Interactions и стриминг не поддерживаются.

## Прочитать ответ

Изображения находятся в `candidates[].content.parts[].inlineData`. Переберите элементы, пропустите `thought: true`, декодируйте `data` и выберите расширение по `mimeType`. Изображение не обязательно находится первым и не всегда имеет формат PNG.

## Связанные руководства

* [Редактирование изображений](/api-reference/gemini-images-edits)
* [SDK, сохранение и последовательные правки](/api-reference/nano-banana)
* [Обзор моделей](/model-updates/nano-banana)
* <a href={"https://bettertoken.ai/pricing"}>Каталог моделей</a>


## OpenAPI

````yaml api-reference/gemini-images-generations.ru.json POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
  title: 'Gemini API: генерация по тексту'
  description: >-
    Создавайте изображения Nano Banana через Gemini API BetterToken. Выберите
    модель, описание, разрешение и пропорции и отправьте запрос в интерактивной
    панели.
  version: 1.0.0
servers:
  - url: https://bettertoken.ai
security:
  - geminiApiKey: []
paths:
  /v1beta/models/{model}:generateContent:
    post:
      summary: 'Gemini API: генерация по тексту'
      description: >-
        Создавайте изображения по описанию с Nano Banana Pro, 2 или 2.1.
        BetterToken API не поддерживает генерацию с поиском, включая Google Web
        Search и Image Search grounding. Не добавляйте поисковые инструменты.
      operationId: generateGeminiImage_ru
      parameters:
        - name: model
          in: path
          required: true
          description: Model ID BetterToken. Выберите одну из трёх моделей Nano Banana.
          schema:
            type: string
            enum:
              - nano-banana-pro
              - nano-banana-2
              - nano-banana-2.1
            default: nano-banana-2.1
        - name: X-BetterToken-Max-Images
          in: header
          description: >-
            Предел возвращаемых и оплачиваемых изображений, а не гарантированное
            количество. По умолчанию 1.
          schema:
            type: integer
            minimum: 1
            maximum: 4
            default: 1
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - contents
              properties:
                contents:
                  type: array
                  description: >-
                    История диалога. Для следующих правок сохраняйте полный
                    content модели и thoughtSignature.
                  minItems: 1
                  items:
                    type: object
                    required:
                      - parts
                    properties:
                      role:
                        type: string
                        description: >-
                          user для нового запроса; model для прошлых ответов
                          модели в истории правок.
                        enum:
                          - user
                          - model
                        default: user
                      parts:
                        type: array
                        description: >-
                          Текст и изображения. text и inlineData передаются
                          отдельными элементами.
                        minItems: 1
                        items:
                          anyOf:
                            - type: object
                              required:
                                - text
                              properties:
                                text:
                                  type: string
                                  description: >-
                                    Описание изображения или инструкция для
                                    редактирования.
                                  example: >-
                                    Студийная фотография синей керамической
                                    кружки на белом столе.
                              additionalProperties: true
                            - type: object
                              required:
                                - inlineData
                              properties:
                                inlineData:
                                  type: object
                                  description: Референс, встроенный в формате base64.
                                  required:
                                    - mimeType
                                    - data
                                  properties:
                                    mimeType:
                                      type: string
                                      description: MIME-тип референса.
                                      enum:
                                        - image/png
                                        - image/jpeg
                                      example: image/png
                                    data:
                                      type: string
                                      description: >-
                                        Байты изображения в base64 без префикса
                                        Data URL.
                                      contentEncoding: base64
                                      example: REPLACE_WITH_IMAGE_BASE64
                                  additionalProperties: false
                              additionalProperties: true
                    additionalProperties: false
                generationConfig:
                  type: object
                  description: Настройки генерации.
                  properties:
                    responseModalities:
                      type: array
                      description: Явно запросите вывод изображения.
                      items:
                        type: string
                        enum:
                          - IMAGE
                      default:
                        - IMAGE
                    candidateCount:
                      type: integer
                      enum:
                        - 1
                      default: 1
                      description: >-
                        Не указывайте или задайте целое число 1. Не передавайте
                        n в корне.
                    imageConfig:
                      type: object
                      description: Настройки выходного изображения.
                      properties:
                        imageSize:
                          type: string
                          description: Разрешение. Используйте заглавную K.
                          enum:
                            - 1K
                            - 2K
                            - 4K
                          default: 1K
                        aspectRatio:
                          type: string
                          description: >-
                            Пропорции. Pro поддерживает 10; 2 и 2.1 также
                            поддерживают 1:4, 4:1, 1:8 и 8:1.
                          enum:
                            - '1:1'
                            - '1:4'
                            - '1:8'
                            - '2:3'
                            - '3:2'
                            - '3:4'
                            - '4:1'
                            - '4:3'
                            - '4:5'
                            - '5:4'
                            - '8:1'
                            - '9:16'
                            - '16:9'
                            - '21:9'
                          default: '1:1'
                      additionalProperties: false
                  additionalProperties: false
              additionalProperties: false
            example:
              contents:
                - role: user
                  parts:
                    - text: >-
                        Студийная фотография синей керамической кружки на белом
                        столе.
              generationConfig:
                responseModalities:
                  - IMAGE
                candidateCount: 1
                imageConfig:
                  imageSize: 1K
                  aspectRatio: '1:1'
      responses:
        '200':
          description: Результат генерации. Проверьте финальные изображения и finishReason.
          content:
            application/json:
              schema:
                type: object
                properties:
                  candidates:
                    type: array
                    items:
                      type: object
                      properties:
                        content:
                          type: object
                          properties:
                            role:
                              type: string
                            parts:
                              type: array
                              items:
                                type: object
                                properties:
                                  text:
                                    type: string
                                  thought:
                                    type: boolean
                                  thoughtSignature:
                                    type: string
                                  inlineData:
                                    type: object
                                    properties:
                                      mimeType:
                                        type: string
                                      data:
                                        type: string
                                        contentEncoding: base64
                        finishReason:
                          type: string
                  promptFeedback:
                    type: object
                    additionalProperties: true
                  usageMetadata:
                    type: object
                    additionalProperties: true
              example:
                candidates:
                  - content:
                      role: model
                      parts:
                        - inlineData:
                            mimeType: image/png
                            data: BASE64_IMAGE_DATA
                    finishReason: STOP
        '400':
          description: Неверные параметры или неподдерживаемая функция.
        '401':
          description: API Key отсутствует или недействителен.
        '402':
          description: Недостаточно средств.
        '429':
          description: Ограничение запросов или перегрузка сервиса.
        '500':
          description: Ошибка генерации. Проверьте результат перед повторной отправкой.
components:
  securitySchemes:
    geminiApiKey:
      type: apiKey
      in: header
      name: x-goog-api-key
      description: BetterToken API Key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.