> ## 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.5 Генерация изображений

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

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

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

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

> [!NOTE]
>
> Эта страница описывает стандартную версию. Если нужно платить по фактическому расходу токенов, используйте отдельную [документацию GPT-Image-2.5 VIP](https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5-vip/generation.md). Обе версии работают как асинхронные задачи; основные различия — формат size и модель оплаты.

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

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

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

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

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-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.5-flare",
  "status": "pending",
  "progress": 0,
  "created_at": 1788951900,
  "metadata": {}
}
```

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

```bash theme={null}
curl --fail-with-body \
  --url https://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`. Запрашивайте статус каждые несколько секунд. Полный список полей описан в разделе [Статус задачи изображения](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.5-flare` или `gpt-image-2.5-sunburst`.

**prompt** `string` *required*

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

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

Сейчас стандартная версия фиксирует качество `high`, поэтому параметр можно не передавать. Любое другое строковое значение игнорируется и заменяется на `high`. В Playground опция качества не отображается.

Сейчас стандартная версия тарифицируется по resolution.

**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`.

Рекомендуем указывать соотношение и явно передавать `resolution`. Сервер рассчитывает размеры выходного изображения в пикселях по этим двум значениям. В стандартной версии используются соотношения, а в VIP-версии — размеры в пикселях.

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

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

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

**background** `string`

Необязательный параметр фона. Значение `"transparent"` включает генерацию изображения с прозрачным фоном. Без этого поля выполняется обычная генерация.

Поддерживается для генерации по тексту и запросов с `reference_images`.

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

Используйте `1` на запрос, чтобы сгенерировать одно изображение.

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

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

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

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

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

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

Готовую задачу запрашивают по ID как обычно, а URL изображения читают из `result.data`.

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

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

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

Используйте тот же эндпоинт генерации и добавьте `reference_images`. В примере ниже применяется Sunburst, и ответ по-прежнему является асинхронной задачей:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-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 задачи.

## Цены

Ниже указаны стандартные цены, проверенные 2026-09-09, за одно изображение на запрос. Обе модели стандартной версии стоят одинаково:

| resolution | USD за изображение |
| - | -: |
| 1K | 0.015 |
| 2K | 0.020 |
| 4K | 0.025 |

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

## Отличия от VIP-версии

| Пункт | Стандартная версия | VIP-версия |
| - | - | - |
| Имя модели | Без суффикса `-vip` | С суффиксом `-vip` |
| Режим задачи | Асинхронная задача, URL изображения — по ID задачи | Асинхронная задача, URL изображения — по ID задачи |
| size | Соотношение, например `16:9` | Размеры в пикселях, например `1536x1024` |
| resolution | `1K`, `2K`, `4K` | Не передаётся, размеры задаёт `size` |
| Оплата | Цена за изображение по resolution | Фактические токены текста и изображения |
| Референсные изображения | URL референсных изображений в эндпоинте генерации | Загрузка файла изображения через эндпоинт редактирования |

При переходе на VIP-версию одновременно измените имя модели и параметры. Подробности см. в разделе [GPT-Image-2.5 VIP](https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5-vip/generation.md).


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