> ## 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 официальный канал генерации изображений

> Асинхронные задачи Sunburst и Flare через официальный канал, редактирование по разметке, вывод GIF и SVG, доставка через R2 и тарификация по токенам

Через официальный канал доступны две модели GPT-Image-2.6. Отправка запроса сразу возвращает ID асинхронной задачи. Изображения генерируются в фоне и сохраняются в R2 перед выдачей.

| Модель | model |
| - | - |
| Sunburst Official | `gpt-image-2.6-sunburst-official` |
| Flare Official | `gpt-image-2.6-flare-official` |

В запросах нужно использовать полное имя модели из таблицы. `gpt-image-2.6-official` — это только название серии, его нельзя передавать в `model`.

Пользователи в материковом Китае могут заменить `https://api.toapis.com` в примерах на `https://api.toapis.cn`. Создайте API Key в [консоли](https://toapis.com/console/token) и установите переменную окружения `TOAPIS_API_KEY`.

## Отправка и опрос

Отправка изображения через Flare. Для Sunburst достаточно заменить `model`:

```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-official",
    "prompt": "A small blue circle on a plain white background",
    "size": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "n": 1
  }'
```

```json theme={null}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.6-flare-official",
  "status": "pending",
  "progress": 0,
  "created_at": 1789099098,
  "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 результата, сохранённого в R2, находится в `result.data[].url`; при `failed` читайте `error`. Опрашивайте один и тот же ID задачи каждые несколько секунд; высококачественная генерация может занять несколько минут, не отправляйте запрос повторно во время ожидания. Все поля описаны в [API статуса задачи изображения](https://docs.toapis.com/docs/ru/api-reference/tasks/image-status.md).

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

**Authorization** `string` *required*

API Key ToAPIs в формате `Bearer YOUR_API_KEY`.

**model** `string` *required*

`gpt-image-2.6-sunburst-official` / `gpt-image-2.6-flare-official`.

**prompt** `string` *required*

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

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

Имена соотношений сторон (например `1:1`, `3:2`, `2:3`, `16:9`, `9:16`) или размеры в пикселях (например `1024x1024`, `1536x1024`). Для вывода GIF семантика size описана в разделе GIF. Обе стороны в пикселях должны быть кратны 16 и не меньше 16, каждая сторона — не более 3840, а отношение большей стороны к меньшей — не более 3:1; размеры свыше 2560x1440 считаются экспериментальными.

**resolution** `string`

Уровень разрешения `1k` / `2k` / `4k`. Явное значение имеет приоритет над уровнем, выведенным из `size`. Уровень влияет на фактическое потребление токенов и время генерации.

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

Шесть уровней: `auto`, `low`, `medium`, `high`, `xhigh`, `max`. `auto` позволяет модели выбирать уровень для каждого запроса. Качество влияет на фактическое потребление токенов и время.

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

От 1 до 4 изображений на запрос. При `output_format` = `svg` допустимо только `1`.

**output\_format** `string`

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

**output\_compression** `integer`

Степень сжатия 0-100, применяется только к выводу `jpeg` и `webp`.

**background** `string`

`transparent` / `opaque` / `auto`. Явная прозрачность применяется только к `png` / `webp`; `svg` прозрачен по умолчанию.

**moderation** `string`

Уровень модерации контента `auto` / `low`.

**complexity** `string`

Сложность генерации `low` / `medium` / `high`; по умолчанию `high`. Отдельно не тарифицируется.

## Референсные изображения и маски

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

`mask_url` указывает на PNG-маску с альфа-каналом; её размер должен совпадать с первым референсным изображением, и она используется только вместе с `image_urls`.

```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-official",
    "prompt": "Keep the subject and replace the masked area with a snowy forest",
    "image_urls": ["https://example.com/reference.png"],
    "mask_url": "https://example.com/mask.png",
    "quality": "high",
    "size": "1024x1024",
    "n": 1
  }'
```

## Редактирование по разметке

`markup_url` указывает на размеченное референсное изображение (либо передайте встроенный объект разметки через `markup`). Вместе с `image_urls` для исходного изображения модель редактирует по смыслу разметки. `markup_url` и `mask_url` взаимоисключающие — в одном запросе можно использовать только один из них.

```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-official",
    "prompt": "Follow the markup annotations to adjust the layout",
    "image_urls": ["https://example.com/reference.png"],
    "markup_url": "https://example.com/markup.png",
    "quality": "high",
    "n": 1
  }'
```

## Вывод GIF

Передайте `gif` в `output_format`, чтобы создать анимацию. `frame_count` задаёт число кадров (2-16), `frame_duration_ms` — длительность кадра. GIF поддерживает только text-to-image и не может сочетаться с `image_urls`, `mask_url`, `markup_url`, `markup` и `output_compression`. Передавайте `size` точным пиксельным значением (например `512x512`) или опустите его, чтобы использовать размеры кадра по умолчанию от апстрима; соотношения вроде `1:1` для GIF отклоняются.

```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-official",
    "prompt": "A paper airplane looping across a blue sky, flat illustration",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 200,
    "size": "512x512",
    "n": 1
  }'
```

## Вывод SVG

Передайте `svg` в `output_format`, чтобы создать векторное изображение. Также требуется объект `svg` с указанным `svg.model`. SVG поддерживает только text-to-image, `n` может быть только `1` и не может сочетаться с `image_urls`, `mask_url`, `markup_url`, `markup` и `output_compression`. SVG-генерация дополнительно вызывает текстовую модель, указанную в `svg.model`, и тарифицируется по её ставке.

```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-official",
    "prompt": "A minimalist mountain logo, flat vector style",
    "output_format": "svg",
    "svg": { "model": "gpt-5" },
    "n": 1
  }'
```

## Цены на токены

Обе официальные модели тарифицируются по категориям токенов: текстовый ввод, кэшированный текстовый ввод, ввод изображений, кэшированный ввод изображений и вывод изображений оплачиваются отдельно. При отправке квота резервируется, а после успеха сумма уточняется по фактическому потреблению токенов с возвратом или доплатой.

Формула стоимости в USD:

```text theme={null}
USD = (
  uncached_text_input_tokens * text_input_price
  + cached_text_input_tokens * cached_text_input_price
  + uncached_image_input_tokens * image_input_price
  + cached_image_input_tokens * cached_image_input_price
  + image_output_tokens * image_output_price
) / 1,000,000
```

GIF тарифицируется по выходным токенам всей анимации. Вывод SVG дополнительно создаёт один вызов текстовой модели `svg.model` поверх токенов изображения.

Индивидуальные цены и скидки аккаунта продолжают действовать. Итоговое списание можно проверить в журнале использования; актуальные цены — на [странице цен](https://toapis.com/pricing) и в настройках аккаунта.

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

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


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