> ## 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.

# Modifier l’image (compatible avec OpenAI Dall-E)

> OpenAI Interface de retouche d’images au format Dall-E.

- `POST /v1/images/edits` : modifier l’image

En-têtes d'authentification standard :
- `Content-Type: application/json`

- `model: string` : requis, nom du modèle exposé
- `prompt: string` : recommandé, description de génération d’image
- `n: number` : facultatif, nombre d’images à générer
- `size: string` : facultatif, format de taille ou de résolution
- `quality: string` : facultatif, niveau de qualité
- `response_format: string` : facultatif, format de retour

Paramètres d’extension de compatibilité courants :
- `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 Paramètres d’extension dédiés :
- `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 Série Nano Banana

Modèle exposé :
- `nano-banana`
- `nano-banana-pro`
- `nano-banana-pro-2k`
- `nano-banana-pro-4k`
- `nano-banana-2`
- `nano-banana-2-2k`
- `nano-banana-2-4k`

Description des capacités :
- `nano-banana` : génération d’image à partir de texte de base, compatible aussi avec l’édition d’image
- `nano-banana-pro*` : version de qualité supérieure
- `nano-banana-2*` : famille de versions plus récente
- `*-2k` / `*-4k` : modèles haute résolution

Paramètres courants :
- Génération d’image à partir de texte : `model + prompt`
- Édition d’image : `model + prompt + image`, compatible aussi avec `image_urls`
- Extensions courantes : `n` `size` `quality` `response_format`

Exemple :

```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 Série Seedream

Modèle exposé :
- `doubao-seedream-3-0-t2i-250415`
- `doubao-seedream-4-0-250828`
- `doubao-seedream-4-5-251128`
- `doubao-seedream-5-0-260128`

Description des capacités :
- Appel unifié en génération d’image à partir de texte
- Il est recommandé de transmettre en priorité les paramètres standard : `prompt + model + size/aspect_ratio`

Paramètres courants :
- `model + prompt`
- Optionnel : `size` `aspect_ratio` `n`

### 3.3 Kling Modèle principal d’images standard

Modèle principal exposé :
- `kling-image`

Obligatoire :
- `model`
- `model_name`

`model_name` pris en charge :
- `kling-v1`
- `kling-v1-5`
- `kling-v2`
- `kling-v2-new`
- `kling-v2-1`
- `kling-v3`

Description des capacités :
- Génération d’image à partir de texte : `model + model_name + prompt`
- Génération d’image à partir d’image : ajoutez `image` sur la base de la génération d’image à partir de texte
- Génération d’image à partir de plusieurs images : transmettez `subject_image_list`, ou plusieurs `image_urls/images`
- Extension d’image : transmettez `image` et le paramètre de ratio d’extension

Paramètres courants :
- `image`
- `subject_image_list`
- `scene_image`
- `style_image`
- `aspect_ratio`
- `resolution`
- `up_expansion_ratio`
- `down_expansion_ratio`
- `left_expansion_ratio`
- `right_expansion_ratio`

Exemple :

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

### 3.4 Kling Modèle principal d’images Omni

Modèle principal exposé :
- `kling-omni-image`

Obligatoire :
- `model`
- `model_name`

`model_name` pris en charge :
- `kling-image-o1`
- `kling-v3-omni`

Paramètres courants :
- `image_list`
- `element_list`
- `resolution`
- `aspect_ratio`
- `result_type`
- `series_amount`

Exemple :

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

### 3.5 Kling Modèle d’essayage virtuel

Modèle exposé :
- `kolors-virtual-try-on-v1`
- `kolors-virtual-try-on-v1-5`

Paramètres d’entrée minimaux :
- `model + human_image + cloth_image`

Remarque :
- Ces deux modèles sont eux-mêmes des modèles principaux complets ; il n’est pas nécessaire de transmettre `model_name` à nouveau.

Exemple :

```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/fr/openapi.json POST /v1/images/edits
openapi: 3.0.0
info:
  title: Documentation de référence de 出海营 API
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAIFormat (Chat)
  - name: Format OpenAI(Responses)
  - name: Format Gemini pour la génération d’images
  - name: Génération d’imagesOpenAI au format DALL-E
  - name: Obtenir la liste des modèles
  - name: Génération vidéoHappyHorse avec Wan
  - name: Format de génération vidéo Kling
  - name: Format Omni de génération vidéo et Veo
  - name: Génération vidéo Seedance
  - name: Formats compatibles avec la génération de vidéosSora
  - name: Génération vidéo Vidu
  - name: Format de tâche de génération musicale
paths:
  /v1/images/edits:
    post:
      tags:
        - Génération d’imagesOpenAI au format DALL-E
      summary: Modifier l’image (compatible avec OpenAI Dall-E)
      description: >-
        OpenAI Interface de retouche d’images au format Dall-E.


        - `POST /v1/images/edits` : modifier l’image


        En-têtes d'authentification standard :

        - `Content-Type: application/json`


        - `model: string` : requis, nom du modèle exposé

        - `prompt: string` : recommandé, description de génération d’image

        - `n: number` : facultatif, nombre d’images à générer

        - `size: string` : facultatif, format de taille ou de résolution

        - `quality: string` : facultatif, niveau de qualité

        - `response_format: string` : facultatif, format de retour


        Paramètres d’extension de compatibilité courants :

        - `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 Paramètres d’extension dédiés :

        - `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 Série Nano Banana


        Modèle exposé :

        - `nano-banana`

        - `nano-banana-pro`

        - `nano-banana-pro-2k`

        - `nano-banana-pro-4k`

        - `nano-banana-2`

        - `nano-banana-2-2k`

        - `nano-banana-2-4k`


        Description des capacités :

        - `nano-banana` : génération d’image à partir de texte de base,
        compatible aussi avec l’édition d’image

        - `nano-banana-pro*` : version de qualité supérieure

        - `nano-banana-2*` : famille de versions plus récente

        - `*-2k` / `*-4k` : modèles haute résolution


        Paramètres courants :

        - Génération d’image à partir de texte : `model + prompt`

        - Édition d’image : `model + prompt + image`, compatible aussi avec
        `image_urls`

        - Extensions courantes : `n` `size` `quality` `response_format`


        Exemple :


        ```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 Série Seedream


        Modèle exposé :

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

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

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

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


        Description des capacités :

        - Appel unifié en génération d’image à partir de texte

        - Il est recommandé de transmettre en priorité les paramètres standard :
        `prompt + model + size/aspect_ratio`


        Paramètres courants :

        - `model + prompt`

        - Optionnel : `size` `aspect_ratio` `n`


        ### 3.3 Kling Modèle principal d’images standard


        Modèle principal exposé :

        - `kling-image`


        Obligatoire :

        - `model`

        - `model_name`


        `model_name` pris en charge :

        - `kling-v1`

        - `kling-v1-5`

        - `kling-v2`

        - `kling-v2-new`

        - `kling-v2-1`

        - `kling-v3`


        Description des capacités :

        - Génération d’image à partir de texte : `model + model_name + prompt`

        - Génération d’image à partir d’image : ajoutez `image` sur la base de
        la génération d’image à partir de texte

        - Génération d’image à partir de plusieurs images : transmettez
        `subject_image_list`, ou plusieurs `image_urls/images`

        - Extension d’image : transmettez `image` et le paramètre de ratio
        d’extension


        Paramètres courants :

        - `image`

        - `subject_image_list`

        - `scene_image`

        - `style_image`

        - `aspect_ratio`

        - `resolution`

        - `up_expansion_ratio`

        - `down_expansion_ratio`

        - `left_expansion_ratio`

        - `right_expansion_ratio`


        Exemple :


        ```json

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

        ```


        ### 3.4 Kling Modèle principal d’images Omni


        Modèle principal exposé :

        - `kling-omni-image`


        Obligatoire :

        - `model`

        - `model_name`


        `model_name` pris en charge :

        - `kling-image-o1`

        - `kling-v3-omni`


        Paramètres courants :

        - `image_list`

        - `element_list`

        - `resolution`

        - `aspect_ratio`

        - `result_type`

        - `series_amount`


        Exemple :


        ```json

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

        ```


        ### 3.5 Kling Modèle d’essayage virtuel


        Modèle exposé :

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

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


        Paramètres d’entrée minimaux :

        - `model + human_image + cloth_image`


        Remarque :

        - Ces deux modèles sont eux-mêmes des modèles principaux complets ; il
        n’est pas nécessaire de transmettre `model_name` à nouveau.


        Exemple :


        ```json

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

        ```
      operationId: createImageEdit
      parameters: []
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                model:
                  type: string
                  example: dall-e-2
                  description: Nom du modèle d’image exposé publiquement.
                  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
                image:
                  type: string
                  format: binary
                  description: >-
                    Entrée d’une seule image, couramment utilisée pour
                    l’image-à-image et l’agrandissement d’image.
                mask:
                  type: string
                  format: binary
                  description: Image de masque facultative
                prompt:
                  type: string
                  description: >-
                    Description de génération d’image. Ce paramètre peut être
                    omis pour le modèle d’essayage virtuel.
                'n':
                  type: integer
                  description: Nombre d’images à générer.
                  default: 1
                size:
                  type: string
                  enum:
                    - 256x256
                    - 512x512
                    - 1024x1024
                  description: Expression de la taille ou de la résolution.
                response_format:
                  type: string
                  description: Format de retour.
                  enum:
                    - url
                    - b64_json
                user:
                  type: string
              required:
                - model
                - image
                - prompt
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  example: dall-e-2
                  description: Nom du modèle d’image exposé publiquement.
                  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
                image:
                  type: string
                  format: binary
                  description: >-
                    Entrée d’une seule image, couramment utilisée pour
                    l’image-à-image et l’agrandissement d’image.
                mask:
                  type: string
                  format: binary
                  description: Image de masque facultative
                prompt:
                  type: string
                  description: >-
                    Description de génération d’image. Ce paramètre peut être
                    omis pour le modèle d’essayage virtuel.
                'n':
                  type: integer
                  description: Nombre d’images à générer.
                  default: 1
                size:
                  type: string
                  enum:
                    - 256x256
                    - 512x512
                    - 1024x1024
                  description: Expression de la taille ou de la résolution.
                response_format:
                  type: string
                  description: Format de retour.
                  enum:
                    - url
                    - b64_json
                user:
                  type: string
              required:
                - model
                - image
                - prompt
            examples:
              nano_banana_text2img:
                summary: Nano Banana génération d’images à partir de texte
                value:
                  model: nano-banana
                  prompt: a cute cat running in cloud
                  'n': 1
                  size: 1024x1792
              seedream_text2img:
                summary: Génération d’images à partir de texte avec Seedream
                value:
                  model: doubao-seedream-3-0-t2i-250415
                  prompt: 一张电影感海边日落人像
                  size: 1536x1024
                  'n': 1
              kling_text2img:
                summary: Kling Génération d’images à partir de texte
                value:
                  model: kling-image
                  model_name: kling-v3
                  prompt: 海边日落，电影感人像
                  aspect_ratio: '16:9'
                  'n': 1
              kling_img2img:
                summary: Kling Image à image
                value:
                  model: kling-image
                  model_name: kling-v2-1
                  prompt: 改成赛博朋克夜景风格
                  image: https://example.com/input.png
                  'n': 1
              kling_omni_image:
                summary: Kling image Omni
                value:
                  model: kling-omni-image
                  model_name: kling-v3-omni
                  prompt: 生成一张海边跳舞的图片
                  element_list:
                    - element_id: 835266081714884700
              kling_virtual_try_on:
                summary: Kling essayage virtuel
                value:
                  model: kolors-virtual-try-on-v1
                  human_image: https://example.com/human.jpg
                  cloth_image: https://example.com/cloth.jpg
      responses:
        '200':
          description: L'image a été générée avec succès
          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: |-
        Utilisez l'authentification Bearer Token.
        Format : `Authorization: Bearer sk-xxxxxx`

````