> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.6 画像生成 > - GPT Image 2.6（gpt-image-2.6-sunburst / gpt-image-2.6-flare）は、テキストからの画像生成、画像から画像への生成、画像編集、注釈による編集に対応し、GIF アニメーションと SVG ベクター画像も出力できます - 非同期処理方式です。返却されたタスク ID で[結果を照会](/ja/api-manual/task-management/get-task-detail)してください - 生成された画像リンクの有効期間は 24 時間です。お早めに保存してください ## OpenAPI ````yaml ja/api-manual/image-series/gpt-image-2.6/gpt-image-2.6-image-generation.json POST /v1/images/generations openapi: 3.1.0 info: title: gpt-image-2.6 API description: AIモデルを使用して画像タスクを作成、複数のモデルとパラメータ設定に対応 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 本番環境 security: - bearerAuth: [] tags: - name: 画像生成 description: AI画像生成関連のAPI paths: /v1/images/generations: post: tags: - 画像生成 summary: gpt-image-2.6 API description: >- - GPT Image 2.6（gpt-image-2.6-sunburst / gpt-image-2.6-flare）は、テキストからの画像生成、画像から画像への生成、画像編集、注釈による編集に対応し、GIF アニメーションと SVG ベクター画像も出力できます - 非同期処理方式です。返却されたタスク ID で[結果を照会](/ja/api-manual/task-management/get-task-detail)してください - 生成された画像リンクの有効期間は 24 時間です。お早めに保存してください operationId: createImageGenerationGptImage26 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ImageGenerationRequest' examples: text_to_image: summary: テキストから画像（シンプル） value: model: gpt-image-2.6-sunburst prompt: 海面に広がる色鮮やかな美しい夕焼け text_to_image_hd: summary: テキストから画像（高精細 16:9） value: model: gpt-image-2.6-sunburst prompt: 夕暮れ時の未来都市スカイラインのシネマティックなワイドショット size: '16:9' resolution: 4K quality: high 'n': 1 complexity: high text_to_image_pixel: summary: テキストから画像（明示的なピクセル指定） value: model: gpt-image-2.6-sunburst prompt: ミニマルなロゴデザイン size: 1024x1024 quality: medium image_edit: summary: 画像から画像 / 画像編集 value: model: gpt-image-2.6-sunburst prompt: 彼女の隣に可愛い猫を追加 size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png callback_url: https://your-domain.com/webhook/image-done image_inpaint: summary: インペインティング（マスク付き） value: model: gpt-image-2.6-sunburst prompt: 空を星空に置き換えてください size: '1:1' resolution: 1K quality: medium image_urls: - https://example.com/input.png mask_url: https://example.com/mask.png markup_edit: summary: 注釈による編集（markup） value: model: gpt-image-2.6-flare prompt: 赤い円の中の花瓶を単色のコバルトブルーの陶器に変更し、それ以外は変更せず、赤い円を削除する quality: medium image_urls: - https://example.com/kitchen.png markup_url: https://example.com/markup.png batch_generation: summary: バッチ生成 value: model: gpt-image-2.6-sunburst prompt: ピクセルアート風の可愛いロボット size: '1:1' resolution: 2K quality: high 'n': 4 gif_animation: summary: GIF アニメーション value: model: gpt-image-2.6-flare prompt: 夜風でランタンがゆっくり揺れる、始点と終点が滑らかにつながるループ output_format: gif size: auto quality: medium model_params: frame_count: 9 frame_duration_ms: 200 svg_vector: summary: SVG ベクター画像 value: model: gpt-image-2.6-sunburst prompt: パン屋のフラットなロゴ、麦の穂と円形のエンブレム output_format: svg quality: medium model_params: svg_model: gpt-6.1-terra gif_animation_pixel: summary: GIF アニメーション（フレームサイズ指定） value: model: gpt-image-2.6-flare prompt: 子猫が自然な動きでまばたきする、始点と終点がつながるループ output_format: gif size: 720x720 quality: low model_params: frame_count: 16 frame_duration_ms: 200 responses: '200': description: 画像タスクが正常に作成されました content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: リクエストパラメータが無効です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: 未認証、トークンが無効または期限切れ content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 残高不足、チャージが必要です content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: アクセスが拒否されました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: gpt-image-2.6-sunburst' type: invalid_request_error '429': description: リクエスト頻度制限を超えました content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: サーバー内部エラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: ImageGenerationRequest: type: object required: - model - prompt properties: model: type: string description: >- 画像生成モデル名。安定性と制御性に優れ、商用用途に適しています。 | モデル ID | 特徴 | |---|---| | `gpt-image-2.6-sunburst` | 細部の表現に優れ、精緻なビジュアル制作に適しています | | `gpt-image-2.6-flare` | 生成が速く、短いサイクルでの試行に適しています | 両モデルのパラメータは同じです。同じ `quality` でも実際のトークン消費量に若干の差が生じる場合があります。返却される `usage` を基準にしてください。 enum: - gpt-image-2.6-sunburst - gpt-image-2.6-flare default: gpt-image-2.6-sunburst example: gpt-image-2.6-sunburst prompt: type: string description: >- 生成する画像、または入力画像の編集方法を説明するプロンプト **長さの制限（両方を満たす必要があります）：** - 最大 `32,000` 文字（Unicode コードポイント単位でカウント） - `prompt` のテキスト自体を UTF-8 でエンコードした際に、`60,000` バイト以下 文字によって UTF-8 で使用するバイト数は異なります。実際にエンコードした後のバイト数で確認してください。 いずれかの上限を超える場合は、プロンプトを短くしてから再送信してください。 **推奨事項：** プロンプトが `8000` トークンを超えると、生成画像が想定と一致しない場合があります。プロンプトを簡潔にすることを推奨します。 example: 海面に広がる色鮮やかな美しい夕焼け maxLength: 32000 image_urls: type: array description: >- 参照画像のリスト。公開 URL を指定でき、画像から画像への生成や画像編集に使用します。 **注意：** - 1 リクエストで指定できる入力画像は `1~16` 枚です - 画像 1 枚あたりのファイルサイズ：`50MB` 以下 - 画像 1 枚あたりの画素数：幅 × 高さが `178,956,970` px 以下 - 各辺の長さ：幅・高さともに `23170` px 以下。超過するとエラーが発生する場合があります - 対応形式：`.jpeg`、`.jpg`、`.png`、`.webp` - URL を使用する場合、サーバーから直接表示またはダウンロードできる必要があります（通常、`.png` や `.jpg` などの画像拡張子で終わる URL） - 画像から画像への生成や画像編集では、参照画像自体に追加の画像入力トークンが発生します - `markup_url` を使用する場合、注釈は最初の画像に適用され、他の画像は参照用となります。最初の画像の幅 × 高さは `16,777,216` px 以下である必要があります - `output_format` が `svg` の場合、参照画像は指定できません items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png mask_url: type: string format: uri description: >- インペインティング マスク URL — 参照画像の再生成したい領域を指定します。**画像編集モードでのみ有効**（`image_urls` と併用必須）です。テキストのみから画像を生成する場合は、`mask_url` を指定しても無視されます。 **形式要件：** - **アルファチャンネル付き PNG である必要があります**：透明ピクセル（`alpha < 255`）= 再生成領域、不透明ピクセル = 元画像保持 - **マスクの寸法は参照画像と完全に一致**する必要があります（幅 × 高さ、ピクセル単位） - リクエストごとに 1 枚のマスクのみ **注意：** - `image_urls` に少なくとも 1 枚の参照画像が必要です。マスク単独では効果がありません - `markup_url` とは併用できません - よくあるエラー： - `Invalid mask image format - mask image missing alpha channel`：アップロードされた画像にアルファチャンネルがありません（JPEG、不透明 PNG など）。透明領域のある PNG として再エクスポートしてください。 - `Invalid mask image format - mask size does not match image size`：マスクのサイズが参照画像と一致しません。参照画像と同じピクセル寸法にリサイズしてください。 example: https://example.com/mask.png markup_url: type: string format: uri description: >- 注釈レイヤー画像の公開 URL。円、矢印、描き込みなどで変更箇所を示し、`prompt` で具体的な変更内容を説明します。**画像編集モードでのみ有効**です（`image_urls` の指定が必須）。 **形式要件：** - **透明ピクセルを含む PNG が必須**です。注釈だけを描き、それ以外は透明にしてください。元画像に直接注釈を描き込まないでください - **最初の参照画像と寸法が完全に一致**する必要があります（幅 × 高さ、ピクセル単位） - 最初の参照画像と注釈レイヤーは、それぞれ幅 × 高さが `16,777,216` px 以下である必要があります - ファイルサイズ：`50MB` 以下 **注意：** - 注釈は `image_urls` の最初の画像に適用され、他の画像は参照用となります - `mask_url` とは併用できません - 通常画像と GIF の編集に対応します。SVG には対応しません - `model_params.markup_url` に指定することもできます。両方に指定した場合はトップレベルの値が優先されます - `prompt` には保持したい内容も記述することをおすすめします。例：「それ以外は変更せず、赤い円を削除する」 example: https://example.com/markup.png size: type: string description: >- 生成画像のサイズ。既定値は `auto` です。通常画像と SVG の参照画像には以下の共通ルールを適用します。GIF には④の独立したルールを適用します。 **① 通常画像 / SVG 参照画像：アスペクト比形式（15 種類）** - `1:1`：正方形 - `1:2` / `2:1`：縦長 / 横長 - `1:3` / `3:1`：非常に縦長 / 横長（上限の 3:1） - `2:3` / `3:2`：標準的な縦向き / 横向き - `3:4` / `4:3`：従来の縦向き / 横向き - `4:5` / `5:4`：ソーシャルメディアでよく使われる比率 - `9:16` / `16:9`：スマートフォン / デスクトップのワイド画面 - `9:21` / `21:9`：ウルトラワイド **② 通常画像 / SVG 参照画像：ピクセル指定形式**：`WxH`（または `W×H`）。例：`1024x1024`、`1536x1024`、`3840×2160` - 幅と高さはともに `16` の整数倍である必要があります - 各辺の範囲：`[16, 3840]` - 総画素数：`655,360 ≤ width × height ≤ 8,294,400`（約 0.65 MP ~ 8.29 MP） - 長辺と短辺の比：`≤ 3:1` **③ 通常画像 / SVG 参照画像：`auto`**：モデルがサイズを自動決定します（この場合、`resolution` は適用されません）。 **④ GIF 出力**：`size` は各フレームのサイズを表します。`auto` とピクセル指定形式のみをサポートし、比率形式は使用できません。 - `auto` の場合、各フレームは `512×512` になります - 明示的に指定するフレームの幅と高さは、ともに `16` の正の整数倍である必要があります - GIF の各フレームには、通常画像の最小画素数 `655,360` は適用されません。たとえば `512x512` は有効です - 全フレームを並べた画像全体が、辺の長さ、総画素数、アスペクト比の制限を満たす必要があります。配置方法とフレームサイズの上限は `model_params.frame_count` を参照してください - `resolution` は適用されません **上限を超えた場合：** - 通常画像 / SVG 参照画像で比率と `resolution` の組み合わせが上限を超える場合、比率を保ったまま最大サイズまで自動縮小します（例：4K 2:1 → 3840×1920） - GIF の明示的なフレームサイズが上限を超える場合、HTTP 400 を返します。自動縮小は行いません default: auto example: auto resolution: type: string description: >- 解像度階層のショートカットパラメータ。`size` が比率形式の場合のみ有効、明示的ピクセル形式および GIF 出力ではこのフィールドは無視されます **ピクセルバジェット規則**（目標総ピクセル数と `size` の比率から幅と高さを算出、結果は 16 の倍数に揃えられます）: - `1K`: ~1 MP（1024² = 1,048,576 ピクセル） - `2K`: ~4 MP（2048² = 4,194,304 ピクセル） - `4K`: ~8.29 MP（3840×2160 = 8,294,400 ピクセル、上限値） **横向き / 正方形の実際の出力サイズ**（縦向きは対応する横向きの幅と高さを入れ替えたもの、例: `2:3` = `3:2` の反転）: | 比率 | 1K | 2K | 4K | |---|---|---|---| | `1:1` | 1024×1024 | 2048×2048 | 2880×2880 | | `2:1` | 1456×720 | 2896×1456 | 3840×1920 \* | | `3:1` | 1776×592 | 3552×1184 | 3840×1280 \* | | `3:2` | 1248×832 | 2512×1680 | 3520×2352 | | `4:3` | 1184×880 | 2368×1776 | 3312×2480 \* | | `5:4` | 1152×912 | 2288×1824 | 3216×2576 | | `16:9` | 1360×768 | 2736×1536 | 3840×2160（UHD）| | `21:9` | 1568×672 | 3136×1344 | 3840×1648 \* | \* はピクセル予算を超えたため比率を保って自動縮小された組み合わせを表します。値は大文字小文字を区別しません。 enum: - 1K - 2K - 4K default: 1K example: 1K quality: type: string description: >- レンダリング品質。出力トークン数と料金に直接影響します。既定値は `medium` です。 | 値 | 出力トークン（1024²）| 画像出力料金の比率（1024²）| |---|---|---| | `low` | 824 | ~0.57× | | `medium` | 1,449 | 1.0× | | `high` | 1,756 | ~1.21× | | `xhigh` | 3,122 | ~2.15× | | `max` | 7,024 | ~4.85× | **注意：** - 表は画像出力料金のみの比較で、入力料金と SVG 作成モデルの料金は含みません - 表は `1024×1024` を基準としています。出力トークン数は総画素数とアスペクト比によって変わります。実際の値は返却される `usage` を基準にしてください - GIF は全フレームを並べた画像全体で計算します。SVG では参照画像に適用されます - 素早い下書きには `low` を使用し、完成品では複数の設定を比較して細部、所要時間、料金のバランスを調整してください enum: - low - medium - high - xhigh - max default: medium example: medium complexity: type: string description: |- 画像生成前の計画の深さ。`quality` とは独立しており、既定値は `high` です。 - `low`：背景の変更や看板の文字の修正など、局所的な変更に適しています - `medium`：バランス重視 - `high`：文字の多い画像、複雑なレイアウト、物体間の関係が複雑な画像に適しています **注意：** - 設定が高いほど時間がかかり、不要な変更が加わる場合もあります。用途に合わせて結果を比較してください - `complexity` の変更に追加料金はかかりません - SVG では参照画像に適用されます - `model_params.complexity` に指定することもできます。両方に指定した場合はトップレベルの値が優先されます enum: - low - medium - high default: high example: high background: type: string description: |- 出力画像のアルファチャンネル。既定値は `opaque` - `opaque`: 不透明な背景、アルファチャンネルなし - `transparent`: アルファチャンネルを保持します **注意:** - `transparent` は Preview 機能で、出力が安定しない場合があります - `transparent` を使う場合、`output_format` は `png` または `webp` のみです - `output_format` が `gif` または `svg` の場合、`opaque` のみ指定できます enum: - opaque - transparent default: opaque example: opaque output_format: type: string description: >- 出力ファイル形式。既定値は `png` です。 - `png`：可逆圧縮。透明背景に対応します - `jpeg`：非可逆圧縮。ファイルサイズを小さくできます - `webp`：ファイルサイズと品質を両立し、透明背景にも対応します - `gif`：GIF アニメーション。フレーム数と表示時間は `model_params` を参照してください - `svg`：SVG ベクター画像。ロゴやアイコンなど、品質を落とさず拡大縮小する図形に適しています **注意：** - `background` が `transparent` の場合、`png` または `webp` のみ使用できます - `gif` はテキストからの生成と画像編集に対応します - `gif` と `svg` では `n` は `1` のみ指定できます - `svg` はテキストからの画像生成のみ対応します - SVG は、まず画像モデルが参照画像を生成し、その後、作成モデル（`model_params.svg_model`）がベクター画像に変換します。作成モデルのトークンは選択したモデルに応じて別途課金されます enum: - png - jpeg - webp - gif - svg default: png example: png 'n': type: integer description: >- 生成する画像の枚数。各画像は個別に課金されます **注意:** - テキスト入力トークンは `n` に比例して拡大します - `n > 1` への対応は現時点で不安定です。1 より大きい値を指定しても 1 枚しか返らないことが多くあります。実際の枚数はレスポンスの `results` が基準で、課金は返却される `usage` に従います。複数枚が必要な場合は、1 枚ずつのリクエストを複数回送ることをおすすめします - `output_format` が `gif` または `svg` の場合、`1` のみ指定できます minimum: 1 maximum: 10 default: 1 example: 1 model_params: type: object description: >- モデル固有の追加パラメータ。GIF のフレーム設定と SVG 作成モデルの設定は、このオブジェクト内に指定してください。 - `frame_count` と `frame_duration_ms` は `output_format=gif` の場合のみ使用できます - `svg_model` と `svg_reasoning_effort` は `output_format=svg` の場合のみ使用できます - 出力形式と追加パラメータが一致しない場合は HTTP 400 を返します。無視されることはありません properties: frame_count: type: integer description: >- GIF アニメーションのフレーム数。`output_format` が `gif` の場合のみ使用できます。既定値は `9` です。 全フレームを並べた 1 枚の画像として生成します。明示的に指定するフレームの幅と高さは、ともに `16` の正の整数倍である必要があります。各フレームには通常画像の最小画素数は適用されません。表内の辺の長さはピクセル単位です。 | フレーム数 | フレームごとの上限 | サイズ例 | |---|---|---| | `2`~`8` | ≤ 1,036,800 画素。一辺 ≤ 960、もう一辺 ≤ 1920 | `960x1072` | | `9` | ≤ 921,600 画素。両辺とも ≤ 1280 | `1280x720` | | `10`~`12` | ≤ 691,200 画素。一辺 ≤ 1280、もう一辺 ≤ 960 | `960x720` | | `13`~`16` | ≤ 518,400 画素。両辺とも ≤ 960 | `720x720` | **配置ルール（列 × 行）：** - `2`~`8` フレーム：`4×2` または `2×4` - `9` フレーム：`3×3` - `10`~`12` フレーム：`3×4` または `4×3`。必要に応じて `4×4` を試します - `13`~`16` フレーム：`4×4` **以下の条件もすべて満たす必要があります：** - 少なくとも 1 つの配置方法で、画像全体の各辺が `3840` px 以下、総画素数が `8,294,400` 以下、長辺と短辺の比が `3:1` 以下になること - `4×4` の配置では、各フレームが `13`~`16` フレームの場合の画素数と辺の上限を満たすこと - どの配置方法でも収まらない場合は HTTP 400 を返します。表内の画素数と辺の上限だけを満たせばよいわけではありません `size` が `auto` の場合、各フレームは `512×512` で、すべてのフレーム数に対応します。出力トークンは配置後の画像全体で計算し、各フレームの分を個別に合算するわけではありません。 minimum: 2 maximum: 16 default: 9 example: 9 frame_duration_ms: type: integer description: >- GIF の各フレームの表示時間（ミリ秒）。`output_format` が `gif` の場合のみ使用できます。既定値は `200` で、10 ミリ秒単位に丸められます。 minimum: 20 maximum: 2000 default: 200 example: 200 svg_model: type: string description: >- 参照画像を SVG に変換する作成モデル。`output_format` が `svg` の場合のみ使用できます。既定値は `gpt-6.1-terra` です。 **注意：** - 作成モデルが消費するトークンは、選択したモデルに応じて別途課金されます - タスク結果の `usage` に `svg_model`、`svg_input_tokens`、`svg_output_tokens` が返されます - 作成モデルの入力・出力トークンは別項目として返され、`usage.total_tokens` には含まれません enum: - gpt-6.1-terra - gpt-6.1-sol - gpt-6-astra - gpt-6-sol - gpt-6-luna default: gpt-6.1-terra example: gpt-6.1-terra svg_reasoning_effort: type: string description: >- SVG 作成モデルの推論強度。`output_format` が `svg` の場合のみ使用できます。省略すると、作成モデルの既定値 `medium` が使用されます。 | 作成モデル | 指定可能な値 | |---|---| | `gpt-6.1-terra`、`gpt-6-sol`、`gpt-6-luna` | `none`、`low`、`medium`、`high`、`xhigh`、`max` | | `gpt-6.1-sol`、`gpt-6-astra` | `low`、`medium`、`high`、`xhigh`、`max` | **注意：** - 推論トークンは作成モデルの出力トークンに含まれます enum: - none - low - medium - high - xhigh - max example: medium callback_url: type: string description: >- タスク完了後の HTTPS コールバックアドレス **コールバックタイミング：** - タスクが完了、失敗、またはキャンセルされた時にトリガーされます - 課金確認完了後に送信されます **セキュリティ制限：** - HTTPS プロトコルのみサポート - 内部 IP アドレスへのコールバックは禁止（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など） - URL の長さは `2048` 文字以内 **コールバックメカニズム：** - タイムアウト：`10` 秒 - 失敗時最大 `3` 回リトライ（`1` 秒/`2` 秒/`4` 秒後にリトライ） - コールバックレスポンスボディの形式はタスククエリ API のレスポンス形式と一致 - コールバックアドレスが 2xx ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: タスク作成タイムスタンプ example: 1757156493 id: type: string description: タスクID example: task-unified-1757156493-imcg5zqt model: type: string description: 実際に使用されたモデル名 example: gpt-image-2.6-sunburst object: type: string enum: - image.generation.task description: 具体的なタスクタイプ progress: type: integer description: タスク進行状況のパーセンテージ (0-100) minimum: 0 maximum: 100 example: 1 status: type: string description: >- タスクの状態。待機中および生成中は `processing` を返し、最終状態は `completed` または `failed` になります。 enum: - processing - completed - failed example: processing task_info: $ref: '#/components/schemas/TaskInfo' description: 非同期タスク情報 type: type: string enum: - text - image - audio - video description: タスクの出力タイプ example: image usage: $ref: '#/components/schemas/Usage' description: 使用量と課金情報 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: エラーコード識別子 message: type: string description: エラー説明 type: type: string description: エラータイプ TaskInfo: type: object properties: can_cancel: type: boolean description: タスクがキャンセル可能かどうか example: true estimated_time: type: integer description: 予想完了時間（秒） minimum: 0 example: 100 Usage: type: object description: タスク作成時の仮引き落とし情報。実際の使用量とトークンの内訳は、タスク完了後にタスク照会 API で取得してください。 properties: billing_rule: type: string description: >- 課金ルール。GPT Image 2.6 は 1,000 トークン単位で課金され、画像、テキスト入力、SVG 作成モデルの使用量は、それぞれの単価で計算されます。 enum: - per_1k_tokens example: per_1k_tokens credits_reserved: type: number description: 予想消費クレジット数 minimum: 0 example: 2.5 user_group: type: string description: ユーザーグループカテゴリ example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- すべての API で Bearer Token による認証が必要です。 **API Key の取得：** [API Key 管理ページ](https://evolink.ai/dashboard/keys)から API Key を取得してください。 **リクエストヘッダーに追加：** ``` Authorization: Bearer YOUR_API_KEY ``` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.