メインコンテンツへスキップ
POST
Create image generation
gpt-image-2 は DimiLinks の画像生成モデルで、テキストからの画像生成と画像からの画像生成に対応しています。image_urls フィールドで最大 9 枚の参照画像を指定できます。
?async=true の追加を推奨します。同期モードでは画像の完成までレスポンスが返らないため、ゲートウェイやクライアントのタイムアウトによって中断されやすくなります。

リクエスト URL

テキストから画像を生成する例

画像から画像を生成する例

非同期レスポンス

task_id を取得したら、画像タスクを取得を呼び出して結果を確認してください。

同期レスポンス

同期モードでは、画像の完成後に次のレスポンスが返ります。

結果フィールドの説明

data[].url は画像結果の URL です。次のルールで処理してください。
  • /p/img/...:相対パスです。表示またはダウンロードする前に https://lmage2.dimilinks.com を補ってください。このパスには Bearer は不要で、URL 自体に署名と有効期限が含まれています。
  • https://lmage2.dimilinks.com/p/img/...:完全な画像 URL です。そのままリクエストまたは表示できます。
非同期タスクの画像結果は、タスクレスポンスの data.data[] にあります。result.data[] ではありません。画像 URL 内の img_xxx は画像プールのリソース ID であり、送信時に返される公開タスク ID とは異なります。

パラメータ

非同期モードを有効にする方法

次のいずれかを指定すると、非同期モードになります。
  • クエリパラメータ:?async=true
  • クエリパラメータ:?wait_for_result=false
  • リクエストヘッダー:Prefer: respond-async
  • リクエストボディ:"wait_for_result": false

参照画像の形式

image_urls の使用を推奨します。
reference_images、images、image、image_url、input_image、input_images にも対応しています。

参照画像の制限

  • 1 回のリクエストで指定できる参照画像は最大 9 枚です。
  • 参照画像 1 枚あたりの最大サイズは 20 MB です。
  • HTTP(S) URL、Data URL、純粋な base64 に対応しています。
  • ブラウザの blob: URL は直接指定できません。先に自分のサーバーへアップロードするか、Data URL に変換してください。

解像度プラン別の機能差

具体的な単価はコンソールの「価格」ページを確認してください。料金はプランごとに個別に計算されます。

承認

Authorization
string
header
必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

クエリパラメータ

async
boolean

Set to true to submit an async image task.

wait_for_result
boolean

Set to false to submit an async image task.

ボディ

application/json
prompt
string
必須
model
string
デフォルト:gpt-image-2
n
integer
デフォルト:1

1k resolution allows n=1 only; 2k and 4k allow up to 4.

必須範囲: 1 <= x <= 4
size
string
例:

"1:1"

"16:9"

"3840x2160"

resolution
enum<string>
利用可能なオプション:
1k,
2k,
4k
output_format
string
例:

"png"

"jpeg"

"webp"

output_compression
integer
background
string
例:

"auto"

"transparent"

"opaque"

moderation
string
例:

"auto"

"low"

wait_for_result
boolean
image_urls
mask_url
string
response_format
string
例:

"b64_json"

user
string

レスポンス

Image generation result or async submission

task_id
string
必須
例:

"task_xxx"

data
object[]
必須
例:
created
integer
例:

1777080000