GPT Image 2.5 | API ドキュメント

# GPT Image 2.5

Generate images with Flare or edit reference images with Sunburst.

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

Use `gpt-image-2.5-flare` for fast image generation or `gpt-image-2.5-sunburst` for precise editing. Check `GET https://api.apihop.ai/v1/models` for availability with your API key.

## 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.5-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "n": 1
}
```

| Parameter | Values |
| --- | --- |
| `model` | Required: `gpt-image-2.5-flare` or `gpt-image-2.5-sunburst` |
| `prompt` | Required text describing the image or edit |
| `n` | Integer from 1 to 4; default 1 |
| `size` | `auto`, aspect ratio, or pixel dimensions such as `1600x1200` |
| `resolution` | `1k` (default), `2k`, `4k`; ignored for exact pixel sizes |
| `quality` | `low`, `medium`, `high`, `xhigh`, `max`, `auto` (default) |
| `image_urls` | Up to 16 publicly accessible HTTP(S) image URLs |
| `output_format` | `png` (default), `jpeg`, `webp` |
| `output_compression` | Integer from 0 to 100 for JPEG or WebP |
| `background` | `auto`, `opaque`, `transparent`; transparent requires PNG or WebP |
| `moderation` | `low` (default), `auto` |
| `stream` | `false` (default) for JSON, `true` for SSE completion events |

Supported aspect ratios: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `5:4`, `4:5`, `16:9`, `9:16`, `2:1`, `1:2`, `21:9`, `9:21`, `3:1`, `1:3`. Exact pixel dimensions must be multiples of 16, have no side above 3840 pixels, an aspect ratio at most 3:1, and 655,360 to 8,294,400 total pixels. For example, square `4k` output is 2880x2880, not 4096x4096.

## Reference Images

```json
{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "Keep the product and its lettering. Replace the background with a white studio.",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}
```

References use this JSON generation endpoint. Upload local images to your own storage first. Base64 data URIs, multipart uploads, masks, and a separate `/images/edits` endpoint are outside this model's public contract.

## Response

The HTTP connection waits for completion; clients do not poll an upstream task. JSON responses include final image URLs and available token usage:

```json
{
  "created": 1789035000,
  "data": [{"url": "https://example.com/generated-image.png"}],
  "usage": {"input_tokens": 15, "output_tokens": 196, "total_tokens": 211}
}
```

With `stream: true`, wait for `image_generation.completed` and `[DONE]` on the same connection. Partial image previews are not guaranteed.

## Pricing

Billing uses actual text input, cached text input, image input, cached image input, and image output tokens. Both variants have the same token prices. The model catalog shows your current price and the separate OpenAI reference price. An image is not a fixed-price unit: prompt length, references, size, quality, and count affect the total. A temporary reservation is reconciled after completion. Choosing an explicit quality makes expected usage clearer.

Invalid parameters return 400; authentication failures return 401; insufficient balance returns 402. An unavailable model returns 404, rate limits return 429, and generation failures return 5xx. Do not automatically resubmit a request whose completion status is unknown.

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for error codes, streaming failures, and retry boundaries.

高速な画像生成には gpt-image-2.5-flare、精密な編集には gpt-image-2.5-sunburst を使用してください。自分の 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.5-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "n": 1
}

パラメータ	値
`model`	必須：`gpt-image-2.5-flare` または `gpt-image-2.5-sunburst`
`prompt`	画像または編集内容を説明するテキスト。必須
`n`	1〜4 の整数。既定値は 1
`size`	`auto`、アスペクト比、または `1600x1200` などのピクセル寸法
`resolution`	`1k`（既定）、`2k`、`4k`。正確なピクセル寸法を指定した場合は無視されます
`quality`	`low`、`medium`、`high`、`xhigh`、`max`、`auto`（既定）
`image_urls`	公開アクセス可能な HTTP(S) 画像 URL を最大 16 件
`output_format`	`png`（既定）、`jpeg`、`webp`
`output_compression`	JPEG または WebP 用の 0〜100 の整数
`background`	`auto`、`opaque`、`transparent`。透過には PNG または WebP が必要です
`moderation`	`low`（既定）、`auto`
`stream`	`false`（既定）は JSON、`true` は SSE の完了イベント

対応するアスペクト比：1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21、3:1、1:3。正確なピクセル寸法は 16 の倍数とし、各辺は 3840 ピクセル以下、アスペクト比は最大 3:1、総ピクセル数は 655,360〜8,294,400 にする必要があります。たとえば正方形の 4k 出力は 2880x2880 であり、4096x4096 ではありません。

参照画像

json

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "Keep the product and its lettering. Replace the background with a white studio.",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}

参照画像にも、この JSON 生成エンドポイントを使用します。ローカル画像は先に自分のストレージへアップロードしてください。Base64 データ URI、マルチパートアップロード、マスク、別個の /images/edits エンドポイントは、このモデルの公開仕様の範囲外です。

レスポンス

HTTP 接続は完了まで待機します。クライアントが上流のタスクをポーリングすることはありません。 JSON レスポンスには、最終的な画像 URL と、取得可能なトークン使用量が含まれます。

json

{
  "created": 1789035000,
  "data": [{"url": "https://example.com/generated-image.png"}],
  "usage": {"input_tokens": 15, "output_tokens": 196, "total_tokens": 211}
}

stream: true の場合は、同じ接続上で image_generation.completed と [DONE] を待ってください。途中段階の画像プレビューは保証されません。

料金

課金には、実際のテキスト入力、キャッシュ済みテキスト入力、画像入力、キャッシュ済み画像入力、画像出力のトークンが使用されます。両方のバリエーションのトークン単価は同じです。モデルカタログには、現在の利用料金と、それとは別の OpenAI 参考価格が表示されます。画像 1 枚あたりの固定料金ではありません。プロンプトの長さ、参照画像、サイズ、品質、枚数が合計費用に影響します。完了後に一時的な予約額が精算されます。品質を明示的に指定すると、想定使用量を把握しやすくなります。

無効なパラメータは 400、認証の失敗は 401、残高不足は 402 を返します。利用できないモデルは 404、レート制限は 429、生成の失敗は 5xx を返します。完了状態が不明なリクエストを自動的に再送信しないでください。

エラーコード、ストリーミングの失敗、再試行の制約については、エラーコードとトラブルシューティングを参照してください。