> ## 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: генерация через официальный канал
> Асинхронные задачи Sunburst и Flare, сохранение в R2 и оплата токенов по 80% официального тарифа
Обе модели GPT-Image-2.5 доступны через официальный канал Azure. После отправки сразу возвращается ID асинхронной задачи. Изображения генерируются в фоне и перед выдачей сохраняются в R2.
| Модель | model |
| ----------------- | --------------------------------- |
| Sunburst Official | `gpt-image-2.5-sunburst-official` |
| Flare Official | `gpt-image-2.5-flare-official` |
Указывайте полное имя модели из таблицы. `gpt-image-2.5-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.5-flare-official",
"prompt": "A small blue circle on a plain white background",
"quality": "low",
"size": "1024x1024",
"n": 1
}'
```
```json theme={null}
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "gpt-image-2.5-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 статуса изображений](../../tasks/image-status).
## Параметры запроса
Используйте ToAPIs API Key в формате `Bearer YOUR_API_KEY`. Учетные данные Azure не нужны.
`gpt-image-2.5-sunburst-official` / `gpt-image-2.5-flare-official`.
Описание изображения. Для запросов с референсами укажите, что сохранить и что изменить.
Поддерживаются `low`, `medium`, `high`, `xhigh` и `max`. Качество и размеры влияют на фактический расход токенов и время обработки.
Указывайте размеры в пикселях, например `1024x1024`, `1536x1024` или `1024x1536`. Произвольные размеры должны пройти проверку провайдера. В этих примерах отдельное поле resolution не требуется.
Необязательный параметр. Укажите `transparent` для прозрачного фона. Если параметр пропущен, используется значение провайдера по умолчанию. Формат PNG по умолчанию сохраняет прозрачность.
Сейчас официальный канал создает одно изображение на запрос. Укажите `1`.
## URL референсных изображений
Для генерации по изображению добавьте `image_urls` в тот же JSON-запрос генерации. URL должны быть доступны серверу. Получить URL можно через [API загрузки изображений](../../uploads/images). Референсы оплачиваются как входные токены изображений. Отправка и опрос используют тот же асинхронный процесс.
```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.5-sunburst-official",
"prompt": "Keep the subject and replace the background with a snowy forest",
"image_urls": ["https://example.com/reference.png"],
"quality": "high",
"size": "1024x1024",
"n": 1
}'
```
## Тарифы на токены
Стандартные цены проверены 2026-09-11. Для обеих официальных моделей действует 80% официального тарифа на токены, то есть скидка 20%:
| Тип | USD / 1,000,000 tokens |
| --------------------------------- | ---------------------: |
| Текст на входе | 4.00 |
| Кэшированный текст на входе | 1.00 |
| Изображение на входе | 6.40 |
| Кэшированное изображение на входе | 1.60 |
| Изображение на выходе | 24.00 |
При отправке резервируется квота, а после успешного выполнения разница рассчитывается по фактическим текстовым и графическим токенам провайдера. Все пять уровней качества используют эти ставки; фиксированной цены за изображение для каждого качества нет. Перед отправкой нужны достаточный баланс и квота API Key.
Формула стоимости в USD:
```text theme={null}
USD = (
uncached_text_input_tokens * 4
+ cached_text_input_tokens * 1
+ uncached_image_input_tokens * 6.4
+ cached_image_input_tokens * 1.6
+ image_output_tokens * 24
) / 1,000,000
```
Например, 17 некэшированных текстовых токенов на входе и 196 токенов изображения на выходе стоят `(17 * 4 + 196 * 24) / 1,000,000 = $0.004772`. Это не фиксированная цена за изображение.
Индивидуальные цены и скидки аккаунта продолжают действовать. Итоговое списание проверяйте в журнале использования. Актуальные цены определяются [страницей тарифов](https://toapis.com/pricing) и настройками аккаунта.
## Другие варианты
У [стандартной версии](../gpt-image-2.5/generation) и [VIP-версии](../gpt-image-2.5-vip/generation) свои полные имена моделей. Для описанного здесь официального канала используйте суффикс `-official`.