Kontrakt integracji GPT Image 2.6 | Dokumentacja 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.

Integracja jest przygotowana dla gpt-image-2.6-flare / gpt-image-2.6-sunburst. Dokumentacja APIMart nadal opisuje to API jako podgląd integracji. Dostępność zależy od aktualnego klucza API i aktywacji bramy; sprawdź GET https://api.apihop.ai/v1/models.

Żądanie

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
}

Parametry

Parametr	Wartości
`model`	`gpt-image-2.6-flare`, `gpt-image-2.6-sunburst`
`prompt`	Wymagany tekst
`n`	1–4
`size`	`auto`, proporcje, `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`	Ciąg znaków, maksymalnie 128 znaków
`stream`	`false` (JSON), `true` (SSE)

Wymiary muszą być wielokrotnością 16, każdy bok najwyżej 3840, proporcje najwyżej 3:1, a liczba pikseli 655,360–8,294,400. Referencje korzystają z publicznych URL w image_urls na tym samym endpoint. Wstępna integracja wyklucza base64, multipart, maski, markup, GIF, SVG, animacje i /images/edits.

Odpowiedź

Połączenie czeka na zakończenie. JSON zwraca końcowe URL w data[].url i dostępne tokeny usage. SSE kończy się image_generation.completed i [DONE]; podglądy częściowe nie są gwarantowane. Klient nie odpytuje zadania upstream. Nie ponawiaj żądania o nieznanym wyniku.

Cennik

Oddzielnie rozliczane są tokeny wejścia tekstowego, tekstu z pamięci podręcznej, obrazu wejściowego, obrazu z pamięci podręcznej i obrazu wynikowego. Sprawdź aktualny cennik; rezerwacje są rozliczane po zakończeniu. Ceny referencyjne APIMart nie potwierdzają kosztów konta ani dostępności.