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 Key 和閘道啟用狀態，請透過 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。初始整合不支援 base64 參考圖、multipart 上傳、mask、markup、GIF、SVG、動畫和 /images/edits。

回應

連線會等待完成。JSON 在 data[].url 回傳最終圖片 URL 及可用的 Token usage。SSE 透過 image_generation.completed 和 [DONE] 結束，不保證中間圖片預覽。用戶端無需輪詢上游任務。完成狀態未知時請勿重複提交。

計費

按文字輸入、快取文字輸入、圖片輸入、快取圖片輸入和圖片輸出 Token 分別計費。請查看目前目錄價格；完成後結算預留額度。APIMart 公開參考價不能證明帳戶成本或即時可用性。