Контракт интеграции GPT Image 2.6 | Документация API

# GPT Image 2.6

GPT Image 2.6 Flare and Sunburst integration contract.

POST https://api.apihop.ai/openai/v1/images/generations

Integration is prepared for `gpt-image-2.6-flare` and `gpt-image-2.6-sunburst`. APIMart documentation still labels this upstream API an integration preview. Availability depends on your current API key and gateway activation; check `GET https://api.apihop.ai/v1/models`.

## Request

```http
POST https://api.apihop.ai/openai/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

```json
{
  "model": "gpt-image-2.6-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png",
  "n": 1
}
```

## Parameters

| Parameter | Values |
| --- | --- |
| `model` | `gpt-image-2.6-flare`, `gpt-image-2.6-sunburst` |
| `prompt` | Required text |
| `n` | 1–4 |
| `size` | `auto`, aspect ratio, `WIDTHxHEIGHT` |
| `resolution` | `1k`, `2k`, `4k` |
| `quality` | `auto`, `low`, `medium`, `high`, `xhigh`, `max` |
| `image_urls` | 0–16 HTTP(S) URLs |
| `output_format` | `png`, `jpeg`, `webp` |
| `output_compression` | 0–100; JPEG/WebP |
| `background` | `auto`, `opaque`, `transparent`; PNG/WebP |
| `complexity` | `low`, `medium`, `high` |
| `safety_identifier` | String, maximum 128 characters |
| `stream` | `false` (JSON), `true` (SSE) |

Pixel dimensions must be multiples of 16, with each side at most 3840, an aspect ratio at most 3:1, and 655,360–8,294,400 total pixels. Reference editing uses `image_urls` with public URLs on the same endpoint. This initial integration excludes base64 references, multipart uploads, masks, markup, GIF, SVG, animation, and `/images/edits`.

## Response

The connection waits for completion. JSON returns final URLs in `data[].url` and available token `usage`. SSE completes with `image_generation.completed` and `[DONE]`; partial image previews are not guaranteed. Clients do not poll the upstream task. Do not resubmit requests whose completion status is unknown.

## Pricing

Billing separates text input, cached text input, image input, cached image input, and image output tokens. Check the current catalog price; temporary reservations are reconciled after completion. Published APIMart reference prices do not prove account costs or live availability.

Интеграция подготовлена для gpt-image-2.6-flare / gpt-image-2.6-sunburst. Документация APIMart по-прежнему называет этот API предварительной интеграцией. Доступность зависит от текущего ключа API и активации шлюза; проверьте GET https://api.apihop.ai/v1/models.

Запрос

http

POST https://api.apihop.ai/openai/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

json

{
  "model": "gpt-image-2.6-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png",
  "n": 1
}

Параметры

Параметр	Значения
`model`	`gpt-image-2.6-flare`, `gpt-image-2.6-sunburst`
`prompt`	Обязательный текст
`n`	1–4
`size`	`auto`, соотношение сторон, `WIDTHxHEIGHT`
`resolution`	`1k`, `2k`, `4k`
`quality`	`auto`, `low`, `medium`, `high`, `xhigh`, `max`
`image_urls`	0–16 HTTP(S) URLs
`output_format`	`png`, `jpeg`, `webp`
`output_compression`	0–100; JPEG/WebP
`background`	`auto`, `opaque`, `transparent`; PNG/WebP
`complexity`	`low`, `medium`, `high`
`safety_identifier`	Строка, максимум 128 символов
`stream`	`false` (JSON), `true` (SSE)

Размеры должны быть кратны 16, каждая сторона не больше 3840, соотношение не больше 3:1, всего 655,360–8,294,400 пикселей. Референсы передаются публичными URL в image_urls на том же endpoint. Начальная интеграция исключает base64, multipart, маски, markup, GIF, SVG, анимацию и /images/edits.

Ответ

Соединение ожидает завершения. JSON возвращает итоговые URL в data[].url и доступные токены usage. SSE завершается событиями image_generation.completed и [DONE]; промежуточные изображения не гарантируются. Клиент не опрашивает upstream-задачу. Не отправляйте повторно запрос с неизвестным результатом.

Оплата

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