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

# Генерация изображений (OpenAI совместимо с Dall-E)

> OpenAI Интерфейс генерации изображений в формате Dall-E.

- `POST /v1/images/generations`: создать задачу генерации изображения

Стандартные заголовки аутентификации:
- `Content-Type: application/json`

- `model: string`: обязательно, внешнее имя модели
- `prompt: string`: рекомендуется, описание для генерации изображения
- `n: number`: необязательно, количество генерируемых изображений
- `size: string`: необязательно, указание размера или разрешения
- `quality: string`: необязательно, уровень качества
- `response_format: string`: необязательно, формат ответа

Часто используемые совместимые расширенные параметры:
- `image`
- `image_url`
- `image_urls`
- `image_list`
- `subject_image_list`
- `scene_image`
- `style_image`
- `negative_prompt`
- `aspect_ratio`
- `resolution`
- `callback_url`
- `external_task_id`

Kling Специальные расширенные параметры:
- `model_name`
- `element_list`
- `result_type`
- `series_amount`
- `human_image`
- `cloth_image`
- `up_expansion_ratio`
- `down_expansion_ratio`
- `left_expansion_ratio`
- `right_expansion_ratio`

### 3.1 Серия Nano Banana

Публичная модель:
- `nano-banana`
- `nano-banana-pro`
- `nano-banana-pro-2k`
- `nano-banana-pro-4k`
- `nano-banana-2`
- `nano-banana-2-2k`
- `nano-banana-2-4k`

Описание возможностей:
- `nano-banana`: базовая генерация изображений по тексту, также совместима с редактированием изображений
- `nano-banana-pro*`: версия более высокого качества
- `nano-banana-2*`: более новое семейство версий
- `*-2k` / `*-4k`: модели с высоким разрешением

Часто используемые параметры:
- Text-to-image: `model + prompt`
- Редактирование изображений: `model + prompt + image`, также совместимо с `image_urls`
- Часто используемые расширения: `n` `size` `quality` `response_format`

Пример:

```json
{
  "model": "nano-banana",
  "prompt": "a cute cat running in cloud",
  "n": 1,
  "size": "1024x1792"
}
```

```json
{
  "model": "nano-banana-pro",
  "prompt": "把主体改成赛博朋克夜景",
  "image": "https://example.com/input.png",
  "n": 1
}
```

### 3.2 Серия Seedream

Публичная модель:
- `doubao-seedream-3-0-t2i-250415`
- `doubao-seedream-4-0-250828`
- `doubao-seedream-4-5-251128`
- `doubao-seedream-5-0-260128`

Описание возможностей:
- Единый вызов в режиме text-to-image
- Рекомендуется в первую очередь передавать стандартные параметры: `prompt + model + size/aspect_ratio`

Часто используемые параметры:
- `model + prompt`
- Необязательно: `size` `aspect_ratio` `n`

### 3.3 Kling Основная модель для обычных изображений

Основная публичная модель:
- `kling-image`

Обязательно:
- `model`
- `model_name`

Поддерживаемые `model_name`:
- `kling-v1`
- `kling-v1-5`
- `kling-v2`
- `kling-v2-new`
- `kling-v2-1`
- `kling-v3`

Описание возможностей:
- Text-to-image: `model + model_name + prompt`
- Image-to-image: на основе text-to-image добавьте `image`
- Генерация по нескольким изображениям: передайте `subject_image_list` или несколько `image_urls/images`
- Расширение изображения: передайте `image` и параметр коэффициента расширения

Часто используемые параметры:
- `image`
- `subject_image_list`
- `scene_image`
- `style_image`
- `aspect_ratio`
- `resolution`
- `up_expansion_ratio`
- `down_expansion_ratio`
- `left_expansion_ratio`
- `right_expansion_ratio`

Пример:

```json
{
  "model": "kling-image",
  "model_name": "kling-v3",
  "prompt": "海边日落，电影感人像",
  "aspect_ratio": "16:9",
  "n": 1
}
```

### 3.4 Kling Основная модель изображений Omni

Основная публичная модель:
- `kling-omni-image`

Обязательно:
- `model`
- `model_name`

Поддерживаемые `model_name`:
- `kling-image-o1`
- `kling-v3-omni`

Часто используемые параметры:
- `image_list`
- `element_list`
- `resolution`
- `aspect_ratio`
- `result_type`
- `series_amount`

Пример:

```json
{
  "model": "kling-omni-image",
  "model_name": "kling-v3-omni",
  "prompt": "生成一张海边跳舞的图片",
  "element_list": [
    {
      "element_id": 835266081714884677
    }
  ]
}
```

### 3.5 Kling Модель виртуальной примерки

Публичная модель:
- `kolors-virtual-try-on-v1`
- `kolors-virtual-try-on-v1-5`

Минимальные входные параметры:
- `model + human_image + cloth_image`

Описание:
- Эти две модели сами по себе являются полноценными основными моделями, поэтому `model_name` передавать не нужно

Пример:

```json
{
  "model": "kolors-virtual-try-on-v1",
  "human_image": "https://example.com/human.jpg",
  "cloth_image": "https://example.com/cloth.jpg"
}
```



## OpenAPI

````yaml api-reference/ru/openapi.json POST /v1/images/generations
openapi: 3.0.0
info:
  title: Справочная документация API для "出海营"
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: Формат OpenAI (Chat)
  - name: Формат OpenAI (Responses)
  - name: Формат Gemini для генерации изображений
  - name: Генерация изображенийOpenAI в формате DALL-E
  - name: Получить список моделей
  - name: Генерация видеоHappyHorse и Wan
  - name: ФорматKling генерации видео
  - name: Видео-генерация Omni и формат Veo
  - name: Генерация видео Seedance
  - name: Совместимый формат для Sora генерации видео
  - name: Генерация видео Vidu
  - name: Формат задачи генерации музыки
paths:
  /v1/images/generations:
    post:
      tags:
        - Генерация изображенийOpenAI в формате DALL-E
      summary: Генерация изображений (OpenAI совместимо с Dall-E)
      description: >-
        OpenAI Интерфейс генерации изображений в формате Dall-E.


        - `POST /v1/images/generations`: создать задачу генерации изображения


        Стандартные заголовки аутентификации:

        - `Content-Type: application/json`


        - `model: string`: обязательно, внешнее имя модели

        - `prompt: string`: рекомендуется, описание для генерации изображения

        - `n: number`: необязательно, количество генерируемых изображений

        - `size: string`: необязательно, указание размера или разрешения

        - `quality: string`: необязательно, уровень качества

        - `response_format: string`: необязательно, формат ответа


        Часто используемые совместимые расширенные параметры:

        - `image`

        - `image_url`

        - `image_urls`

        - `image_list`

        - `subject_image_list`

        - `scene_image`

        - `style_image`

        - `negative_prompt`

        - `aspect_ratio`

        - `resolution`

        - `callback_url`

        - `external_task_id`


        Kling Специальные расширенные параметры:

        - `model_name`

        - `element_list`

        - `result_type`

        - `series_amount`

        - `human_image`

        - `cloth_image`

        - `up_expansion_ratio`

        - `down_expansion_ratio`

        - `left_expansion_ratio`

        - `right_expansion_ratio`


        ### 3.1 Серия Nano Banana


        Публичная модель:

        - `nano-banana`

        - `nano-banana-pro`

        - `nano-banana-pro-2k`

        - `nano-banana-pro-4k`

        - `nano-banana-2`

        - `nano-banana-2-2k`

        - `nano-banana-2-4k`


        Описание возможностей:

        - `nano-banana`: базовая генерация изображений по тексту, также
        совместима с редактированием изображений

        - `nano-banana-pro*`: версия более высокого качества

        - `nano-banana-2*`: более новое семейство версий

        - `*-2k` / `*-4k`: модели с высоким разрешением


        Часто используемые параметры:

        - Text-to-image: `model + prompt`

        - Редактирование изображений: `model + prompt + image`, также совместимо
        с `image_urls`

        - Часто используемые расширения: `n` `size` `quality` `response_format`


        Пример:


        ```json

        {
          "model": "nano-banana",
          "prompt": "a cute cat running in cloud",
          "n": 1,
          "size": "1024x1792"
        }

        ```


        ```json

        {
          "model": "nano-banana-pro",
          "prompt": "把主体改成赛博朋克夜景",
          "image": "https://example.com/input.png",
          "n": 1
        }

        ```


        ### 3.2 Серия Seedream


        Публичная модель:

        - `doubao-seedream-3-0-t2i-250415`

        - `doubao-seedream-4-0-250828`

        - `doubao-seedream-4-5-251128`

        - `doubao-seedream-5-0-260128`


        Описание возможностей:

        - Единый вызов в режиме text-to-image

        - Рекомендуется в первую очередь передавать стандартные параметры:
        `prompt + model + size/aspect_ratio`


        Часто используемые параметры:

        - `model + prompt`

        - Необязательно: `size` `aspect_ratio` `n`


        ### 3.3 Kling Основная модель для обычных изображений


        Основная публичная модель:

        - `kling-image`


        Обязательно:

        - `model`

        - `model_name`


        Поддерживаемые `model_name`:

        - `kling-v1`

        - `kling-v1-5`

        - `kling-v2`

        - `kling-v2-new`

        - `kling-v2-1`

        - `kling-v3`


        Описание возможностей:

        - Text-to-image: `model + model_name + prompt`

        - Image-to-image: на основе text-to-image добавьте `image`

        - Генерация по нескольким изображениям: передайте `subject_image_list`
        или несколько `image_urls/images`

        - Расширение изображения: передайте `image` и параметр коэффициента
        расширения


        Часто используемые параметры:

        - `image`

        - `subject_image_list`

        - `scene_image`

        - `style_image`

        - `aspect_ratio`

        - `resolution`

        - `up_expansion_ratio`

        - `down_expansion_ratio`

        - `left_expansion_ratio`

        - `right_expansion_ratio`


        Пример:


        ```json

        {
          "model": "kling-image",
          "model_name": "kling-v3",
          "prompt": "海边日落，电影感人像",
          "aspect_ratio": "16:9",
          "n": 1
        }

        ```


        ### 3.4 Kling Основная модель изображений Omni


        Основная публичная модель:

        - `kling-omni-image`


        Обязательно:

        - `model`

        - `model_name`


        Поддерживаемые `model_name`:

        - `kling-image-o1`

        - `kling-v3-omni`


        Часто используемые параметры:

        - `image_list`

        - `element_list`

        - `resolution`

        - `aspect_ratio`

        - `result_type`

        - `series_amount`


        Пример:


        ```json

        {
          "model": "kling-omni-image",
          "model_name": "kling-v3-omni",
          "prompt": "生成一张海边跳舞的图片",
          "element_list": [
            {
              "element_id": 835266081714884677
            }
          ]
        }

        ```


        ### 3.5 Kling Модель виртуальной примерки


        Публичная модель:

        - `kolors-virtual-try-on-v1`

        - `kolors-virtual-try-on-v1-5`


        Минимальные входные параметры:

        - `model + human_image + cloth_image`


        Описание:

        - Эти две модели сами по себе являются полноценными основными моделями,
        поэтому `model_name` передавать не нужно


        Пример:


        ```json

        {
          "model": "kolors-virtual-try-on-v1",
          "human_image": "https://example.com/human.jpg",
          "cloth_image": "https://example.com/cloth.jpg"
        }

        ```
      operationId: createImageGeneration
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: Внешнее имя модели изображений.
                  example: dall-e-3
                  enum:
                    - nano-banana
                    - doubao-seedream-3-0-t2i-250415
                    - kling-image
                    - kling-omni-image
                    - kolors-virtual-try-on-v1
                    - kolors-virtual-try-on-v1-5
                prompt:
                  type: string
                  description: >-
                    Описание для генерации изображения. Для модели виртуальной
                    примерки можно не передавать.
                'n':
                  type: integer
                  description: Количество создаваемых изображений.
                  default: 1
                size:
                  type: string
                  description: Описание размера или разрешения.
                  enum:
                    - 1024x1024
                    - 1024x1792
                    - 1792x1024
                quality:
                  type: string
                  description: Уровень качества.
                  enum:
                    - standard
                    - hd
                style:
                  type: string
                  description: Стиль
                  enum:
                    - vivid
                    - natural
                response_format:
                  type: string
                  description: Формат ответа.
                  enum:
                    - url
                    - b64_json
                user:
                  type: string
                  description: Идентификатор пользователя
              required:
                - model
                - prompt
            examples:
              nano_banana_text2img:
                summary: Nano Banana Генерация изображений по тексту
                value:
                  model: nano-banana
                  prompt: a cute cat running in cloud
                  'n': 1
                  size: 1024x1792
              seedream_text2img:
                summary: 'Seedream: генерация изображений по тексту'
                value:
                  model: doubao-seedream-3-0-t2i-250415
                  prompt: 一张电影感海边日落人像
                  size: 1536x1024
                  'n': 1
              kling_text2img:
                summary: Kling Генерация изображений по тексту
                value:
                  model: kling-image
                  model_name: kling-v3
                  prompt: 海边日落，电影感人像
                  aspect_ratio: '16:9'
                  'n': 1
              kling_img2img:
                summary: Kling Генерация изображения по изображению
                value:
                  model: kling-image
                  model_name: kling-v2-1
                  prompt: 改成赛博朋克夜景风格
                  image: https://example.com/input.png
                  'n': 1
              kling_omni_image:
                summary: Kling изображение Omni
                value:
                  model: kling-omni-image
                  model_name: kling-v3-omni
                  prompt: 生成一张海边跳舞的图片
                  element_list:
                    - element_id: 835266081714884700
              kling_virtual_try_on:
                summary: Kling Виртуальная примерка
                value:
                  model: kolors-virtual-try-on-v1
                  human_image: https://example.com/human.jpg
                  cloth_image: https://example.com/cloth.jpg
      responses:
        '200':
          description: Изображение успешно создано
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    ImageResponse:
      type: object
      properties:
        created:
          type: integer
        data:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
              b64_json:
                type: string
              revised_prompt:
                type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Используйте проверку подлинности Bearer Token.
        Формат: `Authorization: Bearer sk-xxxxxx`

````