> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT-Image-2.6 画像生成

> 標準ティアの gpt-image-2.6-flare と gpt-image-2.6-sunburst のアクセスガイド. 非同期タスク, 3段階の品質, 参照画像, GIF・SVG 出力, 解像度ベースの料金を含む

標準ティアは `POST /v1/images/generations` で画像タスクを作成し, タスク ID を返します. タスク完了後, ステータスエンドポイントで画像 URL を取得します. 両モデルとも同じリクエスト形式です:

| モデル | リクエストの model |
| - | - |
| Flare | `gpt-image-2.6-flare` |
| Sunburst | `gpt-image-2.6-sunburst` |

`gpt-image-2.6` はシリーズ名です. 必ず表の完全なモデル名を指定してください.

> [!NOTE]
>
> **中国本土のユーザーへ:** API エンドポイント (Base URL) には `https://api.toapis.cn` をご利用ください. 本ドキュメントの例に含まれる `https://api.toapis.com` を `https://api.toapis.cn` に置き換えてください.

API Key は [コンソール](https://toapis.com/dashboard) で作成します.

## クイックスタート

ToAPIs API Key を環境変数 `TOAPIS_API_KEY` に設定してタスクを送信します:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "児童絵本スタイル, 聴診器でカワウソの赤ちゃんの心音を聴く獣医",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'
```

送信レスポンスの例:

```json theme={null}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.6-flare",
  "status": "pending",
  "progress": 0,
  "created_at": 1788951900,
  "metadata": {}
}
```

返された `id` を保存し, 下記の `TASK_ID` に置き換えて結果を取得します:

```bash theme={null}
curl --fail-with-body \
  --url https://api.toapis.com/v1/images/generations/TASK_ID \
  --header "Authorization: Bearer $TOAPIS_API_KEY"
```

タスクは `pending`, `queued`, `in_progress` を経て `completed` または `failed` になります. `completed` では `result.data` から画像 URL を, `failed` では `error` を読み取ります. 数秒ごとにポーリングしてください. 全フィールドは [画像タスクステータス API](https://docs.toapis.com/docs/ja/api-reference/tasks/image-status.md) を参照してください.

送信成功はタスクが作成されたことのみを意味します. 画像のダウンロードは `completed` を待ち, 待機中は同じタスク ID をポーリングし続けてください.

## リクエストパラメータ

**Authorization** `string` *required*

`Bearer YOUR_TOAPIS_API_KEY` で認証します.

**model** `string` *required*

`gpt-image-2.6-flare` または `gpt-image-2.6-sunburst`.

**prompt** `string` *required*

画像の説明. 参照画像を使う場合は, 残す対象と変更する内容を記述してください.

**quality** `string` (default: high)

3 段階: `low`, `medium`, `high`. Playground のデフォルトは `high`. 省略時は上流のデフォルト値が使われます.

**size** `string` (default: 1:1)

アスペクト比. 例: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `5:4`, `4:5`, `16:9`, `9:16`, `21:9`.

`size` にアスペクト比を指定し, `resolution` を明示的に渡すことを推奨します. 出力ピクセル寸法は両方の値から計算されます.

`auto` を渡して上流に寸法を任せることもできますが, 最終的なアスペクト比とピクセル寸法は保証されません.

**resolution** `string` (default: 1K)

解像度ティア. `1K`, `2K`, `4K` をサポート. 小文字も可. 標準ティアではこのフィールドが料金ティアを決定します.

**n** `integer` (default: 1)

リクエストあたり `1` を指定し, 1 枚の画像を生成します.

**background** `string`

オプションの背景設定. `"transparent"` で透明背景の画像を生成します. 通常の生成では省略してください.

テキスト生成と `reference_images` を含むリクエストの両方で利用できます.

**output\_format** `string`

出力フォーマット: `png`, `jpeg`, `webp`, `gif`, `svg`. 省略時は上流のデフォルト. GIF と SVG の追加パラメータと制限は下記の各セクションを参照してください.

**frame\_count** `integer` (default: 9)

GIF のみ. フレーム数 `2`〜`64`. テキスト生成 GIF ではこの値が適用されます. 画像から GIF への生成では常に `9` フレームで出力されます.

**frame\_duration\_ms** `integer` (default: 200)

GIF のみ. フレームあたりのミリ秒数 `20`〜`2000` (`10` 刻み).

**reference\_images** `string[]`

オプションの参照画像 URL リスト, 最大 10 枚. 画像はサーバーから到達可能である必要があります. URL のみ対応し, ローカルファイルや base64 は受け付けません. ローカル画像は先に [画像アップロード API](https://docs.toapis.com/docs/ja/api-reference/uploads/images.md) で URL を取得してください.

`image_urls` も使用できます. どちらか一方を指定してください.

`"output_format": "gif"` と組み合わせると, 画像から GIF への生成になります.

## 透明背景

生成リクエストに `"background": "transparent"` を加えると透明背景の画像が得られます. 通常の生成では省略してください.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "透明な背景に赤い丸いステッカー",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "n": 1
  }'
```

タスクは通常どおりタスク ID で照会し, `result.data` から画像 URL を読み取ります.

## GIF 出力

`output_format` を `gif` に設定するとアニメーションを生成します. `frame_count` がフレーム数 (`2`〜`64`, デフォルト `9`), `frame_duration_ms` がフレームあたりの時間 (`20`〜`2000` ミリ秒, `10` 刻み, デフォルト `200`) を制御します.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "青空をループして飛ぶ紙飛行機, フラットイラスト",
    "output_format": "gif",
    "frame_count": 8,
    "frame_duration_ms": 200,
    "size": "1:1",
    "n": 1
  }'
```

### 画像から GIF

`reference_images` を追加すると既存の画像をアニメーション化できます. 画像から GIF への出力は常に `9` フレームでレンダリングされ, `frame_count` はこのモードでは無視されますが, `frame_duration_ms` は有効です.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "シーンをやわらかく動かして",
    "reference_images": ["https://example.com/scene.png"],
    "output_format": "gif",
    "frame_duration_ms": 200,
    "n": 1
  }'
```

## SVG 出力

`output_format` を `svg` に設定するとベクター画像を生成します. 追加フィールドは不要です.

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-flare",
    "prompt": "ミニマルな山のロゴ, フラットベクタースタイル",
    "output_format": "svg",
    "n": 1
  }'
```

## 比率と解像度の例

| size | 1K | 2K | 4K |
| - | - | - | - |
| `1:1` | `1024x1024` | `2048x2048` | `2880x2880` |
| `3:2` | `1536x1024` | `2048x1360` | `3520x2336` |
| `2:3` | `1024x1536` | `1360x2048` | `2336x3520` |
| `16:9` | `1536x864` | `2048x1152` | `3840x2160` |
| `9:16` | `864x1536` | `1152x2048` | `2160x3840` |

`4K` は解像度ティアであり, 実際の幅と高さはアスペクト比によって決まります. 例えば正方形の 4K 出力は `2880x2880` です.

## 参照画像による生成

同じ生成エンドポイントに `reference_images` を最大 10 枚まで追加します. 以下の例は Sunburst を使い, 非同期タスクを返します:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://api.toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "参照画像のカワウソの赤ちゃんと獣医を残し, 赤ちゃんに黄色いマフラーを付けて",
    "reference_images": ["https://example.com/otter.png"],
    "quality": "high",
    "size": "1:1",
    "resolution": "2K",
    "n": 1
  }'
```

`https://example.com/otter.png` を実際の参照画像 URL に置き換え, 返されたタスク ID で結果を照会してください.

## 料金

標準ティアは生成画像 1 枚ごとの課金で, `resolution` ティアが料金ティアを決定します. GIF と SVG 出力も同じ 1 枚あたりの料金で課金されます. 参照画像の入力には現在追加料金はありません. アカウント固有の価格や割引が適用される場合があります. 最新の価格は [モデル料金ページ](https://toapis.com/pricing) とアカウント設定で確認してください.

## 関連モデル

[GPT-Image-2.6 Official](https://docs.toapis.com/docs/ja/api-reference/images/gpt-image-2.6-official/generation.md) 版は公式チャネル経由で, 6 段階の品質, カスタムピクセルサイズ, マークアップガイド編集, トークン課金を提供します. そのチャネルでは `-official` サフィックス付きのモデル名を指定してください.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.