GPT Image 2
OpenAI gpt-image-2 — high-fidelity image generation with strong prompt following and text rendering.
料金
$0.0065/ 回
エンドポイント
/images/tasks
結果の受け取り方
非同期タスクのライフサイクル
提供状況
現在利用可能
API ドキュメント
リクエストを作成してコピー
このモデルが受け付けるオプションを選んでください。下のコードは選択に合わせて更新されます。
https://www.aisplice.store/v1/images/tasksBearer API key非同期タスクオプションこのモデルで公開されているオプションのみ表示しています。
# Requires curl and jq
API_KEY="${API_KEY:-YOUR_API_KEY}"
# 1. Submit once
SUBMITTED=$(curl --fail-with-body -sS https://www.aisplice.store/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: model-docs-$(date +%s)-$$" \\
-d '{
"model": "GPT Image 2",
"prompt": "A cinematic scene with careful composition",
"size": "1:1",
"resolution": "1K",
"quality": "auto",
"n": 1
}')
TASK_ID=$(printf '%s' "$SUBMITTED" | jq -r '.task_id // .id // empty')
if [ -z "$TASK_ID" ]; then
printf '%s\n' "$SUBMITTED" >&2
exit 1
fi
echo "task_id=$TASK_ID"
# 2. Poll until terminal
while true; do
STATUS_JSON=$(curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID" \
-H "Authorization: Bearer $API_KEY")
STATUS=$(printf '%s' "$STATUS_JSON" | jq -r '.status // empty' | tr '[:upper:]' '[:lower:]')
echo "status=$STATUS"
case "$STATUS" in
completed|succeeded|success) break ;;
failed|failure|cancelled|canceled)
printf '%s\n' "$STATUS_JSON" | jq .
exit 1
;;
esac
sleep 3
done
# 3. Fetch the final result
curl --fail-with-body -sS \
"https://www.aisplice.store/v1/images/tasks/$TASK_ID/content" \
-H "Authorization: Bearer $API_KEY" | jq .- 1タスクを送信
- 2ステータスをポーリング
- 3コンテンツを取得
本番環境では公開メディア URL を推奨します。 ローカルファイルは先にアップロードし、public_url をモデルのリクエストに指定してください。大きな Base64 のボディは避けてください。
アップロードガイドを読むパラメーターリファレンス
modelこのリクエストで使う正確なモデル識別子。
gpt-image-2prompt目的の結果を記述する指示。
size出力のアスペクト比またはサイズ。
auto1:13:22:34:33:45:44:516:99:162:11:23:11:321:99:21resolutionRequests the selected resolution natively, then applies professional upscaling only when returned pixels are below the fulfillment threshold.
1K2K4Kquality出力品質のティア。
autolowmediumhighn1imagesOptional reference images for image editing, up to 16.
レスポンスの流れ
タスクのステータス、終了状態、結果レスポンスの例。
レスポンスの流れ
タスクのステータス、終了状態、結果レスポンスの例。
{
"id": "task_xxx",
"task_id": "task_xxx",
"object": "image.task",
"model": "GPT Image 2",
"status": "queued"
}{
"created": 1720000000,
"data": [
{
"url": "https://media.example/result.png"
}
]
}待機中
queued · submitted · in_progress · processing
成功
completed · succeeded · success
失敗
failed · failure · cancelled · canceled
エラーと本番運用
再試行のルール、冪等性、最低限の本番チェックリスト。
エラーと本番運用
再試行のルール、冪等性、最低限の本番チェックリスト。
400 / 422リクエストのフィールドや対応していないオプションを修正してください。そのまま再試行しないでください。
401API キーが指定されていて有効か、Bearer トークンとして送信されているかを確認してください。
402アカウント残高が不足しています。
409Idempotency-Key が処理中か、別のボディで再利用されました。
429再試行する前に、Retry-After に従ってバックオフしてください。
5xx指数バックオフで再試行し、元の Idempotency-Key をそのまま使ってください。
- 一般向けのモバイルアプリやブラウザアプリでは、API キーをサーバーに保管してください。
- 課金対象の非同期操作ごとに、一意の Idempotency-Key を設定してください。
- 再起動後にポーリングを再開できるよう、task_id を保存してください。
- すべての HTTP リクエストにタイムアウトを設定し、サポートへの報告にはリクエスト ID を含めてください。
- 料金や対応オプションをハードコードせず、リアルタイムのモデルメタデータを読み取ってください。
料金とティア
リクエスト単価
$0.0065/ 回
ティア別料金
基本料金 $0.0065
ティア別料金 — 最終的な料金はリクエストで指定するオプションによって決まります。記載のないティアは基本料金で課金されます。
- 16:9×1$0.0065
- 1:1×1$0.0065
- 1:2×1$0.0065
- 1:3×1$0.0065
- 21:9×1$0.0065
- 2:1×1$0.0065
- 2:3×1$0.0065
- 3:1×1$0.0065
- 3:2×1$0.0065
- 3:4×1$0.0065
- 4:3×1$0.0065
- 4:5×1$0.0065
- 5:4×1$0.0065
- 9:16×1$0.0065
- 9:21×1$0.0065
- auto×1$0.0065
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
- low:2k×1.189673461538$0.007733
- low:4k×1.189673461538$0.007733
- auto:2k×2.138040769231$0.013897
- auto:4k×2.138040769231$0.013897
- medium:2k×2.138040769231$0.013897
- medium:4k×2.138040769231$0.013897
- high:2k×8.586938461538$0.055815
- high:4k×8.586938461538$0.055815
- 1k×1$0.0065
- 2k×2.138040769231$0.013897
- 4k×2.138040769231$0.013897
ここに表示される料金がそのまま請求額です — 失敗した呼び出しは自動で返金されます。
関連モデル