> ## 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 статуса изображений](https://docs.toapis.com/docs/ru/api-reference/tasks/image-status.md). ## Параметры запроса **Authorization** `string` *required* Используйте ToAPIs API Key в формате `Bearer YOUR_API_KEY`. Учетные данные Azure не нужны. **model** `string` *required* `gpt-image-2.5-sunburst-official` / `gpt-image-2.5-flare-official`. **prompt** `string` *required* Описание изображения. Для запросов с референсами укажите, что сохранить и что изменить. **quality** `string` (default: high) Поддерживаются `auto`, `low`, `medium`, `high`, `xhigh` и `max`. При значении `auto` апстрим-модель сама выбирает уровень качества для каждого запроса. Качество и размеры влияют на фактический расход токенов и время обработки. **size** `string` (default: 1024x1024) Указывайте размеры в пикселях, например `1024x1024`, `1536x1024` или `1024x1536`. Произвольные размеры должны пройти проверку провайдера. В этих примерах отдельное поле resolution не требуется. **background** `string` Необязательный параметр. Укажите `transparent` для прозрачного фона. Если параметр пропущен, используется значение провайдера по умолчанию. Формат PNG по умолчанию сохраняет прозрачность. **n** `integer` (default: 1) Сейчас официальный канал создает одно изображение на запрос. Укажите `1`. ## URL референсных изображений Для генерации по изображению добавьте `image_urls` в тот же JSON-запрос генерации. URL должны быть доступны серверу. Получить URL можно через [API загрузки изображений](https://docs.toapis.com/docs/ru/api-reference/uploads/images.md). Референсы оплачиваются как входные токены изображений. Отправка и опрос используют тот же асинхронный процесс. ```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) и настройками аккаунта. ## Другие варианты У [стандартной версии](https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5/generation.md) и [VIP-версии](https://docs.toapis.com/docs/ru/api-reference/images/gpt-image-2.5-vip/generation.md) свои полные имена моделей. Для описанного здесь официального канала используйте суффикс `-official`. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.