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

# GPT Image 2 Image Edit

API редактирования изображений OpenAI GPT Image 2. Редактирует изображения на основе текстовых промптов, поддерживает восстановление по маске, прозрачный фон, а также различные параметры качества и размера.

## Заголовки запроса

<ParamField header="Content-Type" type="string" required={true}>
  Перечисляемое значение: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Формат Bearer-аутентификации: Bearer \{\{API 密钥}}.
</ParamField>

## Тело запроса

<ParamField body="n" type="integer" default={1}>
  Количество генерируемых изображений. Фактически возвращенное количество может быть меньше запрошенного.

  Диапазон значений: \[1, 10]
</ParamField>

<ParamField body="mask" type="string">
  Дополнительное изображение, полностью прозрачные области которого указывают места, требующие редактирования. Должно быть в формате PNG с alpha-каналом.
</ParamField>

<ParamField body="size" type="string" default="1024x1024">
  Размер генерируемого изображения.

  Допустимые значения: `auto`, `688x2048`, `880x2048`, `1024x1024`, `1024x1536`, `1024x2048`, `1152x2048`, `1360x2048`, `1536x1024`, `1536x2048`, `2048x688`, `2048x880`, `2048x1024`, `2048x1152`, `2048x1360`, `2048x1536`, `2048x2048`, `2160x3840`, `3840x2160`
</ParamField>

<ParamField body="image" type="string" required={true}>
  Изображение для редактирования: URL/base64 одного изображения или массив изображений. Поддерживаемые форматы: PNG, JPEG, GIF, WebP.
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Текстовый промпт, описывающий требуемый результат редактирования, максимальная длина — 32000 символов.

  Ограничение длины: 0–32000
</ParamField>

<ParamField body="quality" type="string" default="low">
  Качество генерируемого изображения. Чем выше качество, тем больше время выполнения и стоимость.

  Допустимые значения: `low`, `medium`, `high`
</ParamField>

<ParamField body="background" type="string" default="auto">
  Должен ли фон быть непрозрачным или определяться автоматически.

  Допустимые значения: `opaque`, `auto`
</ParamField>

<ParamField body="output_format" type="string" default="png">
  Формат выходного изображения.

  Допустимые значения: `png`, `jpeg`
</ParamField>

## Информация об ответе

<ResponseField name="images" type="string[]" required={false}>
  Массив URL сгенерированных изображений.
</ResponseField>