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

# Генерация изображений GPT-Image-2.6

> Руководство по стандартным моделям gpt-image-2.6-flare и gpt-image-2.6-sunburst: асинхронные задачи, три уровня качества, референсные изображения, GIF и SVG вывод, тарификация по разрешению

Стандартный уровень создаёт задачу генерации изображения через `POST /v1/images/generations` и возвращает ID задачи. После завершения получите URL изображения через endpoint статуса. Обе модели используют одинаковый формат запроса:

| Модель | `model` в запросе |
| - | - |
| Flare | `gpt-image-2.6-flare` |
| Sunburst | `gpt-image-2.6-sunburst` |

`gpt-image-2.6` — название серии. Всегда передавайте полное имя модели из таблицы.

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://api.toapis.cn` в качестве API endpoint (Base URL). Замените `https://api.toapis.com` на `https://api.toapis.cn` в примерах этого документа.

Создайте API Key в [консоли](https://toapis.com/dashboard).

## Быстрый старт

Установите свой ToAPIs API Key в переменную окружения `TOAPIS_API_KEY` и отправьте задачу:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Стиль детской книжки: ветеринар слушает стетоскопом сердцебиение детёныша выдры",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'
```

Пример ответа при отправке:

```json theme={null}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.6-flare",
  "status": "pending",
  "progress": 0,
  "created_at": 1788951900,
  "metadata": {}
}
```

Сохраните возвращённый `id`, замените `TASK_ID` ниже на это значение и запросите результат:

```bash theme={null}
curl --fail-with-body \
  --url https://api.toapis.com/v1/images/generations/TASK_ID \
  --header "Authorization: Bearer $TOAPIS_API_KEY"
```

Задача проходит через `pending`, `queued`, `in_progress` и завершается статусом `completed` или `failed`. При `completed` читайте URL изображения из `result.data`, при `failed` — `error`. Опрашивайте каждые несколько секунд. Полный набор полей описан в [API статуса задачи изображения](https://docs.toapis.com/docs/ru/api-reference/tasks/image-status.md).

Успешная отправка означает только создание задачи. Дождитесь `completed` перед скачиванием изображения и продолжайте опрашивать тот же ID задачи.

## Параметры запроса

**Authorization** `string` *required*

Аутентификация через `Bearer YOUR_TOAPIS_API_KEY`.

**model** `string` *required*

`gpt-image-2.6-flare` или `gpt-image-2.6-sunburst`.

**prompt** `string` *required*

Описание изображения. При использовании референсных изображений опишите, что сохранить и что изменить.

**quality** `string` (default: high)

Три уровня: `low`, `medium`, `high`. В Playground по умолчанию `high`. Если не передать, используется значение по умолчанию на стороне провайдера.

**size** `string` (default: 1:1)

Соотношение сторон, например `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `5:4`, `4:5`, `16:9`, `9:16`, `21:9`.

Рекомендуем задавать `size` как соотношение сторон и явно передавать `resolution`; выходные размеры в пикселях вычисляются из обоих значений.

Можно передать `auto`, чтобы провайдер сам выбрал размеры, но итоговое соотношение сторон и размеры в пикселях не гарантируются.

**resolution** `string` (default: 1K)

Уровень разрешения. Поддерживаются `1K`, `2K` и `4K`, строчные буквы тоже принимаются. На стандартном уровне это поле определяет тариф.

**n** `integer` (default: 1)

Передайте `1` на запрос для генерации одного изображения.

**background** `string`

Необязательная настройка фона. Передайте `"transparent"` для генерации изображения с прозрачным фоном. Для обычной генерации поле не передаётся.

Работает и для текстовых запросов, и для запросов с `reference_images`.

**output\_format** `string`

Формат вывода: `png`, `jpeg`, `webp`, `gif` или `svg`. Если не передать, используется формат по умолчанию у провайдера. Дополнительные параметры и ограничения GIF и SVG описаны в соответствующих разделах ниже.

**frame\_count** `integer` (default: 9)

Только для GIF. Количество кадров от `2` до `64`. Текст-в-GIF использует это значение; image-to-GIF всегда рендерится с `9` кадрами.

**frame\_duration\_ms** `integer` (default: 200)

Только для GIF. Длительность кадра в миллисекундах от `20` до `2000` с шагом `10`.

**reference\_images** `string[]`

Необязательный список URL референсных изображений, до 10 штук. Изображения должны быть доступны серверу. Поддерживаются только URL: локальные файлы и base64 не принимаются. Для локальных изображений сначала получите URL через [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md).

Также принимается `image_urls`. Используйте одно из двух полей.

В сочетании с `"output_format": "gif"` референсные изображения дают вывод image-to-GIF.

## Прозрачный фон

Добавьте `"background": "transparent"` в запрос генерации, чтобы получить изображение с прозрачным фоном. Для обычной генерации поле не передаётся.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Красная круглая наклейка на прозрачном фоне",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "n": 1
  }'
```

Задача запрашивается по ID как обычно; читайте URL изображения из `result.data`.

## Вывод GIF

Установите `output_format` в `gif` для генерации анимации. `frame_count` задаёт количество кадров (от `2` до `64`, по умолчанию `9`), а `frame_duration_ms` — длительность кадра (от `20` до `2000` миллисекунд с шагом `10`, по умолчанию `200`).

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Бумажный самолётик, кружащий по голубому небу, плоская иллюстрация",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 200,
    "size": "1:1",
    "n": 1
  }'
```

### Image-to-GIF

Добавьте `reference_images`, чтобы анимировать существующее изображение. Вывод image-to-GIF всегда рендерится с `9` кадрами; `frame_count` в этом режиме игнорируется, а `frame_duration_ms` продолжает действовать.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Оживить сцену мягким движением",
    "reference_images": ["https://example.com/scene.png"],
    "output_format": "gif",
    "frame_duration_ms": 200,
    "n": 1
  }'
```

## Вывод SVG

Установите `output_format` в `svg` для генерации векторной графики. Дополнительные поля не требуются.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "Минималистичный логотип горы, плоский векторный стиль",
    "output_format": "svg",
    "n": 1
  }'
```

## Примеры соотношений и разрешений

| size | 1K | 2K | 4K |
| - | - | - | - |
| `1:1` | `1024x1024` | `2048x2048` | `2880x2880` |
| `3:2` | `1536x1024` | `2048x1360` | `3520x2336` |
| `2:3` | `1024x1536` | `1360x2048` | `2336x3520` |
| `16:9` | `1536x864` | `2048x1152` | `3840x2160` |
| `9:16` | `864x1536` | `1152x2048` | `2160x3840` |

`4K` — это уровень разрешения; фактическая ширина и высота зависят от соотношения сторон. Например, квадратный вывод 4K — `2880x2880`.

## Генерация с референсными изображениями

Используйте тот же endpoint генерации и добавьте `reference_images` — до 10 изображений. Пример ниже использует Sunburst и также возвращает асинхронную задачу:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "Сохранить детёныша выдры и ветеринара с референсного изображения и добавить детёнышу жёлтый шарф",
    "reference_images": ["https://example.com/otter.png"],
    "quality": "high",
    "size": "1:1",
    "resolution": "2K",
    "n": 1
  }'
```

Замените `https://example.com/otter.png` на URL своего референсного изображения и запросите результат по возвращённому ID задачи.

## Тарификация

Стандартный уровень тарифицируется за каждое сгенерированное изображение, а уровень `resolution` определяет ценовой уровень. GIF и SVG вывод тарифицируются по той же цене за изображение. Ввод референсных изображений сейчас не имеет дополнительной платы. Индивидуальные цены или скидки могут отличаться; актуальные цены смотрите на [странице тарифов](https://toapis.com/pricing) и в настройках аккаунта.

## Связанные модели

Версия [GPT-Image-2.6 Official](https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.6-official/generation.md) работает через официальный канал с шестью уровнями качества, произвольными размерами в пикселях, редактированием по разметке и тарификацией по токенам. Для этого канала используйте имена моделей с суффиксом `-official`.


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