curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "海面に広がる色鮮やかな美しい夕焼け"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2.6-sunburst",
  "object": "image.generation.task",
  "progress": 1,
  "status": "processing",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_1k_tokens",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gpt-image-2.6-sunburst",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

GPT Image 2.6

GPT Image 2.6 画像生成

GPT Image 2.6（gpt-image-2.6-sunburst / gpt-image-2.6-flare）は、テキストからの画像生成、画像から画像への生成、画像編集、注釈による編集に対応し、GIF アニメーションと SVG ベクター画像も出力できます
非同期処理方式です。返却されたタスク ID で結果を照会してください
生成された画像リンクの有効期間は 24 時間です。お早めに保存してください

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "海面に広がる色鮮やかな美しい夕焼け"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2.6-sunburst",
  "object": "image.generation.task",
  "progress": 1,
  "status": "processing",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_1k_tokens",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gpt-image-2.6-sunburst",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

承認

Authorization

string

header

必須

すべての API で Bearer Token による認証が必要です。

API Key の取得：

API Key 管理ページから API Key を取得してください。

リクエストヘッダーに追加：

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

model

enum<string>

デフォルト:gpt-image-2.6-sunburst

必須

画像生成モデル名。安定性と制御性に優れ、商用用途に適しています。

モデル ID	特徴
`gpt-image-2.6-sunburst`	細部の表現に優れ、精緻なビジュアル制作に適しています
`gpt-image-2.6-flare`	生成が速く、短いサイクルでの試行に適しています

両モデルのパラメータは同じです。同じ quality でも実際のトークン消費量に若干の差が生じる場合があります。返却される usage を基準にしてください。

利用可能なオプション:

gpt-image-2.6-sunburst,

gpt-image-2.6-flare

例:

"gpt-image-2.6-sunburst"

prompt

string

必須

生成する画像、または入力画像の編集方法を説明するプロンプト

長さの制限（両方を満たす必要があります）：

最大 32,000 文字（Unicode コードポイント単位でカウント）
prompt のテキスト自体を UTF-8 でエンコードした際に、60,000 バイト以下

文字によって UTF-8 で使用するバイト数は異なります。実際にエンコードした後のバイト数で確認してください。

いずれかの上限を超える場合は、プロンプトを短くしてから再送信してください。

推奨事項：プロンプトが 8000 トークンを超えると、生成画像が想定と一致しない場合があります。プロンプトを簡潔にすることを推奨します。

Maximum string length: 32000

例:

"海面に広がる色鮮やかな美しい夕焼け"

image_urls

string<uri>[]

参照画像のリスト。公開 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 の場合、参照画像は指定できません

例:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

mask_url

string<uri>

インペインティングマスク 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：マスクのサイズが参照画像と一致しません。参照画像と同じピクセル寸法にリサイズしてください。

例:

"https://example.com/mask.png"

markup_url

string<uri>

注釈レイヤー画像の公開 URL。円、矢印、描き込みなどで変更箇所を示し、prompt で具体的な変更内容を説明します。画像編集モードでのみ有効です（image_urls の指定が必須）。

形式要件：

透明ピクセルを含む PNG が必須です。注釈だけを描き、それ以外は透明にしてください。元画像に直接注釈を描き込まないでください
最初の参照画像と寸法が完全に一致する必要があります（幅 × 高さ、ピクセル単位）
最初の参照画像と注釈レイヤーは、それぞれ幅 × 高さが 16,777,216 px 以下である必要があります
ファイルサイズ：50MB 以下

注意：

注釈は image_urls の最初の画像に適用され、他の画像は参照用となります
mask_url とは併用できません
通常画像と GIF の編集に対応します。SVG には対応しません
model_params.markup_url に指定することもできます。両方に指定した場合はトップレベルの値が優先されます
prompt には保持したい内容も記述することをおすすめします。例：「それ以外は変更せず、赤い円を削除する」

例:

"https://example.com/markup.png"

size

string

デフォルト:auto

生成画像のサイズ。既定値は 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 を返します。自動縮小は行いません

例:

"auto"

resolution

enum<string>

デフォルト:1K

解像度階層のショートカットパラメータ。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 *

* はピクセル予算を超えたため比率を保って自動縮小された組み合わせを表します。値は大文字小文字を区別しません。

利用可能なオプション:

1K,

2K,

4K

例:

"1K"

quality

enum<string>

デフォルト:medium

レンダリング品質。出力トークン数と料金に直接影響します。既定値は 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 を使用し、完成品では複数の設定を比較して細部、所要時間、料金のバランスを調整してください

利用可能なオプション:

low,

medium,

high,

xhigh,

max

例:

"medium"

complexity

enum<string>

デフォルト:high

画像生成前の計画の深さ。quality とは独立しており、既定値は high です。

low：背景の変更や看板の文字の修正など、局所的な変更に適しています
medium：バランス重視
high：文字の多い画像、複雑なレイアウト、物体間の関係が複雑な画像に適しています

注意：

設定が高いほど時間がかかり、不要な変更が加わる場合もあります。用途に合わせて結果を比較してください
complexity の変更に追加料金はかかりません
SVG では参照画像に適用されます
model_params.complexity に指定することもできます。両方に指定した場合はトップレベルの値が優先されます

利用可能なオプション:

low,

medium,

high

例:

"high"

background

enum<string>

デフォルト:opaque

出力画像のアルファチャンネル。既定値は opaque

opaque: 不透明な背景、アルファチャンネルなし
transparent: アルファチャンネルを保持します

注意:

transparent は Preview 機能で、出力が安定しない場合があります
transparent を使う場合、output_format は png または webp のみです
output_format が gif または svg の場合、opaque のみ指定できます

利用可能なオプション:

opaque,

transparent

例:

"opaque"

output_format

enum<string>

デフォルト:png

出力ファイル形式。既定値は 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）がベクター画像に変換します。作成モデルのトークンは選択したモデルに応じて別途課金されます

利用可能なオプション:

png,

jpeg,

webp,

gif,

svg

例:

"png"

integer

デフォルト:1

生成する画像の枚数。各画像は個別に課金されます

注意:

テキスト入力トークンは n に比例して拡大します
n > 1 への対応は現時点で不安定です。1 より大きい値を指定しても 1 枚しか返らないことが多くあります。実際の枚数はレスポンスの results が基準で、課金は返却される usage に従います。複数枚が必要な場合は、1 枚ずつのリクエストを複数回送ることをおすすめします
output_format が gif または svg の場合、1 のみ指定できます

必須範囲: 1 <= x <= 10

例:

1

model_params

object

モデル固有の追加パラメータ。GIF のフレーム設定と SVG 作成モデルの設定は、このオブジェクト内に指定してください。

frame_count と frame_duration_ms は output_format=gif の場合のみ使用できます
svg_model と svg_reasoning_effort は output_format=svg の場合のみ使用できます
出力形式と追加パラメータが一致しない場合は HTTP 400 を返します。無視されることはありません

Show child attributes

callback_url

string<uri>

タスク完了後の 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 ステータスコードを返した場合は成功とみなされ、その他のステータスコードはリトライをトリガーします

例:

"https://your-domain.com/webhooks/image-task-completed"

レスポンス

画像タスクが正常に作成されました

created

integer

タスク作成タイムスタンプ

例:

1757156493

string

タスクID

例:

"task-unified-1757156493-imcg5zqt"

model

string

実際に使用されたモデル名

例:

"gpt-image-2.6-sunburst"

object

enum<string>

具体的なタスクタイプ

利用可能なオプション:

image.generation.task

progress

integer

タスク進行状況のパーセンテージ (0-100)

必須範囲: 0 <= x <= 100

例:

1

status

enum<string>

タスクの状態。待機中および生成中は processing を返し、最終状態は completed または failed になります。

利用可能なオプション:

processing,

completed,

failed

例:

"processing"

task_info

object

非同期タスク情報

Show child attributes

type

enum<string>

タスクの出力タイプ

利用可能なオプション:

text,

image,

audio,

video

例:

"image"

usage

object

使用量と課金情報

Show child attributes

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

GPT Image 2.6 画像生成

承認

ボディ

レスポンス