> ## 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: текст в изображение

API вызова модели GPT Image 2 для генерации изображений из текста. Поддерживает несколько уровней качества (`low`/`medium`/`high`) и размеров. Генерирует изображения на основе текстового промпта; можно настроить формат вывода, степень сжатия и параметры фона.

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

<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. Фактическое количество возвращённых изображений может быть меньше запрошенного.

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

<ParamField body="size" type="string" default="1024x1024">
  Размер генерируемого изображения. 1024x1024 — квадрат, 1024x1536 — вертикальный формат, 1536x1024 — горизонтальный формат, 2048x2048 — квадрат 2K, 2048x1152 — горизонтальный формат 2K, 3840x2160 — горизонтальный формат 4K, 2160x3840 — вертикальный формат 4K, 2048x1360 — горизонтальный формат 3:2, 1360x2048 — вертикальный формат 2:3, 1152x2048 — вертикальный формат 9:16, 2048x1536 — горизонтальный формат 4:3, 1536x2048 — вертикальный формат 3:4, 2048x880 — сверхширокий формат 21:9, 880x2048 — сверхвертикальный формат 9:21, 688x2048 — вертикальный формат 1:3, 2048x688 — горизонтальный формат 3:1, 2048x1024 — горизонтальный формат 2:1, 1024x2048 — вертикальный формат 1:2.

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

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

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

<ParamField body="quality" type="string" default="medium">
  Уровень качества генерируемого изображения. `low` — самая высокая скорость и самая низкая стоимость; `medium` — баланс качества и скорости; `high` — лучшее качество, но самая низкая скорость и самая высокая стоимость.

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

<ParamField body="background" type="string" default="auto">
  Настройка фона.

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

<ParamField body="moderation" type="string" default="auto">
  Уровень модерации контента.

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

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

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

<ParamField body="output_compression" type="integer">
  Уровень сжатия выходного изображения (0-100). Действует только для формата `jpeg`; формат `png` не поддерживается (значение должно быть 100 или параметр не передаётся).

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

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

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