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取得結果內容
正式環境建議使用公開媒體網址。 先上傳本機檔案,再把 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修正請求欄位或不支援的選項,不要原樣重試。
401檢查 API 金鑰是否存在、有效,並已以 Bearer Token 傳送。
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
頁面顯示的價格即實際計費價格,呼叫失敗會自動退款。
相關模型