# ChatGPT Images 2.6 API Полный справочник API для моделей ChatGPT Images 2.6 Flare и Sunburst. ## Варианты моделей Этот API поддерживает четыре варианта моделей: | Модель | ID | Описание | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Генерация изображений по тексту с настройками разрешения и качества | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Редактирование изображений и композиция из нескольких изображений | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Генерация изображений по тексту с настройками разрешения и качества | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Редактирование изображений и композиция из нескольких изображений | ## Краткое сравнение Flare и Sunburst поддерживают следующие одинаковые параметры запроса. | Возможность | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Входные данные | Текстовый промпт | Изображение(я) + текстовый промпт | | Варианты разрешения | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Варианты качества | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Качество по умолчанию | `medium` | `medium` | | Соотношения сторон | 10 вариантов | 10 вариантов | | Входные изображения | Нет | Обязательны (1–16 изображений) | | Форматы вывода | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Формат вывода по умолчанию | `png` | `png` | ### Поддерживаемые соотношения сторон `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (Генерация изображений по тексту) ### Конечная точка ``` POST /api/v1/image/task ``` ### Аутентификация ``` Authorization: Bearer YOUR_API_KEY ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"gpt-image-2.6-flare"` | | `prompt` | string | Промпт для генерации изображения | | `width` | integer | Значение ширины в соотношении сторон, например `16` для `16:9`; не размер в пикселях | | `height` | integer | Значение высоты в соотношении сторон, например `9` для `16:9`; не размер в пикселях | | `resolution` | string | `"1k"`, `"2k"`, или `"4k"` | Соотношение width:height должно соответствовать одному из поддерживаемых соотношений сторон, перечисленных выше. #### Необязательные | Параметр | Тип | По умолчанию | Описание | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, или `"max"` | | `output_format` | string | `"png"` | Формат вывода: `"png"`, `"jpeg"`, `"webp"`, `"gif"` или `"svg"`. Используйте `"gif"` для GIF-анимации или `"svg"` для векторного вывода SVG | | `frame_count` | integer | `9` | Количество кадров GIF: от `2` до `16`. Применяется только при значении `"gif"` параметра `output_format` | | `frame_duration_ms` | integer | `200` | Длительность кадра GIF в миллисекундах: от `20` до `2000`. Применяется только при значении `"gif"` параметра `output_format` | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (Редактирование изображений) ### Конечная точка ``` POST /api/v1/image/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Описание желаемых изменений | | `image_url_list` | string[] | URL входных изображений; от 1 до 16 изображений, каждое размером менее 50 МБ | | `width` | integer | Значение ширины в соотношении сторон, например `16` для `16:9`; не размер в пикселях | | `height` | integer | Значение высоты в соотношении сторон, например `9` для `16:9`; не размер в пикселях | | `resolution` | string | `"1k"`, `"2k"`, или `"4k"` | Соотношение width:height должно соответствовать одному из поддерживаемых соотношений сторон, перечисленных выше. #### Необязательные | Параметр | Тип | По умолчанию | Описание | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, или `"max"` | | `output_format` | string | `"png"` | Формат вывода: `"png"`, `"jpeg"` или `"webp"` | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (Генерация изображений по тексту) ### Конечная точка ``` POST /api/v1/image/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"gpt-image-2.6-sunburst"` | | `prompt` | string | Промпт для генерации изображения | | `width` | integer | Значение ширины в соотношении сторон, например `16` для `16:9`; не размер в пикселях | | `height` | integer | Значение высоты в соотношении сторон, например `9` для `16:9`; не размер в пикселях | | `resolution` | string | `"1k"`, `"2k"`, или `"4k"` | Соотношение width:height должно соответствовать одному из поддерживаемых соотношений сторон, перечисленных выше. #### Необязательные | Параметр | Тип | По умолчанию | Описание | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, или `"max"` | | `output_format` | string | `"png"` | Формат вывода: `"png"`, `"jpeg"`, `"webp"`, `"gif"` или `"svg"`. Используйте `"gif"` для GIF-анимации или `"svg"` для векторного вывода SVG | | `frame_count` | integer | `9` | Количество кадров GIF: от `2` до `16`. Применяется только при значении `"gif"` параметра `output_format` | | `frame_duration_ms` | integer | `200` | Длительность кадра GIF в миллисекундах: от `20` до `2000`. Применяется только при значении `"gif"` параметра `output_format` | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (Редактирование изображений) ### Конечная точка ``` POST /api/v1/image/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Описание желаемых изменений | | `image_url_list` | string[] | URL входных изображений; от 1 до 16 изображений, каждое размером менее 50 МБ | | `width` | integer | Значение ширины в соотношении сторон, например `16` для `16:9`; не размер в пикселях | | `height` | integer | Значение высоты в соотношении сторон, например `9` для `16:9`; не размер в пикселях | | `resolution` | string | `"1k"`, `"2k"`, или `"4k"` | Соотношение width:height должно соответствовать одному из поддерживаемых соотношений сторон, перечисленных выше. #### Необязательные | Параметр | Тип | По умолчанию | Описание | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, или `"max"` | | `output_format` | string | `"png"` | Формат вывода: `"png"`, `"jpeg"` или `"webp"` | ### Пример запроса ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Формат ответа ### Первоначальный ответ Все четыре варианта ChatGPT Images 2.6 возвращают `task_id` для опроса: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Ответ при опросе Периодически отправляйте `GET /api/v1/image/{task_id}` для проверки статуса: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### Значения статуса - `submitted`: Задача принята - `processing`: Выполняется генерация или редактирование изображения - `succeed`: Задача успешно завершена - `failed`: Задача завершилась ошибкой ## Время обработки Время обработки зависит от модели, настроек вывода, сложности промпта и количества референсных изображений. Продолжайте опрос, пока статус задачи не станет `succeed` или `failed`; принятая или обрабатываемая задача может пока не содержать готовых изображений. ## Рекомендации 1. **Чётко описывайте композицию**: ChatGPT Images 2.6 даёт лучшие результаты, когда промпты ясно описывают объект, кадрирование, освещение и желаемый стиль. 2. **Выбирайте соотношение сторон под целевое размещение**: Заранее задавайте соотношение сторон для публикаций в соцсетях, баннеров, страниц товаров или редакционных макетов. 3. **Используйте качественные исходные изображения для редактирования**: Чёткие, хорошо освещённые изображения помогают сохранить узнаваемость объектов и повысить качество локальных правок. 4. **В запросах с несколькими изображениями используйте только значимые референсы**: Для редактирования передавайте только нужные изображения, чтобы избежать противоречащих друг другу визуальных ориентиров.