リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
aspect_ratio | いいえ | 画面の形:横長、正方形、縦長。 auto · 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 9:21 · 16:9 · 21:9 · デフォルト: auto |
background | いいえ | 背景を残す・消す・差し替える。 auto · opaque · デフォルト: auto |
image_urls | はい | 編集・合成する写真。それぞれの役割をプロンプトに書きます。 |
input_fidelity | いいえ | How closely to keep the look of the source images. low · high · デフォルト: low |
mask_url | いいえ | 変えたい部分を塗ります。 |
num_outputs | いいえ | 一度に作る枚数。 ≥ 1 · ≤ 10 · デフォルト: 1 |
output_format | いいえ | 結果のファイル形式。 png · jpeg · webp · デフォルト: png |
output_quality | いいえ | Compression quality for JPEG and WebP, from 0 to 100. ≥ 0 · ≤ 100 |
prompt | はい | Say what to change and what must stay the same. |
quality | いいえ | 時間と料金をかけて、より細かいディテールにします。 low · medium · high · デフォルト: medium |
resolution | いいえ | 出力サイズ。大きいほど鮮明で、料金も上がります。 1k · 2k · 4k · デフォルト: 1k |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /枚 | ≈ USD |
|---|---|---|
| aspect_ratio 1:3 · quality low · resolution 1K | 0.27 | $0.0027 |
| aspect_ratio 3:1 · quality low · resolution 1K | 0.27 | $0.0027 |
| aspect_ratio 21:9 · quality low · resolution 1K | 0.37 | $0.0037 |
| aspect_ratio 9:21 · quality low · resolution 1K | 0.37 | $0.0037 |
| aspect_ratio 1:2 · quality low · resolution 1K | 0.41 | $0.0041 |
| aspect_ratio 2:1 · quality low · resolution 1K | 0.41 | $0.0041 |
| aspect_ratio 1:3 · quality low · resolution 2K | 0.43 | $0.0043 |
| aspect_ratio 3:1 · quality low · resolution 2K | 0.43 | $0.0043 |
| aspect_ratio 16:9 · quality low · resolution 1K | 0.46 | $0.0046 |
| aspect_ratio 9:16 · quality low · resolution 1K | 0.46 | $0.0046 |
| aspect_ratio 2:3 · quality low · resolution 1K | 0.54 | $0.0054 |
| aspect_ratio 3:2 · quality low · resolution 1K | 0.54 | $0.0054 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 1クレジット/枚($0.01)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
GPT Image 2 API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を openai/gpt-image-2/edit、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "auto",
"resolution": "1k",
"quality": "medium",
"num_outputs": 1,
"input_fidelity": "low"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
GPT Image 2 API についての質問
GPT Image 2 API の料金はいくらですか?
GPT Image 2の最安は画像を編集で、1クレジット($0.01)/枚からです。オプション別の料金:1:3 · low · 1K 0.27クレジット/枚、3:1 · low · 1K 0.27クレジット/枚、21:9 · low · 1K 0.37クレジット/枚、9:21 · low · 1K 0.37クレジット/枚。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのGPT Image 2のモデル名は?
POST /jobs/createTask の model フィールドに 画像を作成は openai/gpt-image-2/text-to-image;画像を編集は openai/gpt-image-2/edit を指定します。
透明な背景に対応していますか?
GPT Image 2 は対応していません。OpenAI はこのモデルで透過出力を提供していないためです。GPT Image 2.5 Sunburst と Flare は background オプションで対応しています。
どの OpenAI 画像モデルを選べばよいですか?
確実な文字と 3 段階の品質での編集なら GPT Image 2、細部と編集精度を重視するなら GPT Image 2.5 Sunburst、速さを重視するなら GPT Image 2.5 Flare です。
GPT Image 2 API の制限は?
解像度:1K · 2K · 4K;アスペクト比:auto · 1:1 · 1:2 · 1:3 · 2:1 · 2:3 +10;1回あたりの出力数:1–10;参照画像:10;プロンプトの長さ(文字):5,000。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにGPT Image 2を試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでGPT Image 2を実行でき、実行ごとに対応するコードが表示されます。
すべての GPT Image モデル
GPT Image 2.5 Flare と Sunburst は、透明背景、より高い品質段階、16枚の写真での編集に対応します。

