ToAPIsToAPIs
GPT-Image-2

GPT-Image-2 圖像生成

使用 gpt-image-2 模型生成圖像,支持文生圖和 reference_images 圖生圖

POST
/v1/images/generations

中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn。

  • 統一的圖像生成 API 接口
  • 通過 model 參數選擇 gpt-image-2
  • 支持文生圖、單圖參考和多圖參考生成
  • 異步任務管理,通過任務 ID 查詢結果

重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls / reference_images 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

Authorizationstring請求頭必填

所有接口均需要使用 Bearer Token 進行認證

獲取 API Key:訪問 API Key 管理頁面 獲取您的 API Key

使用時在請求頭中添加:

Authorization: Bearer YOUR_API_KEY

Body

modelstring請求體必填預設值: gpt-image-2

圖像生成模型名稱

示例:"gpt-image-2"

promptstring請求體必填

圖像生成的文本描述

最長 32,000 個字符(GPT image models 官方上限)

sizestring請求體預設值: 1:1

輸出圖像比例

目前支持以下全部比例:

1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、21:9、9:21

也可以傳 auto 讓上游自動選擇尺寸,但最終寬高比和像素尺寸無法保證。

resolutionstring請求體預設值: 1k

輸出分辨率檔位

支持值:1k、2k、4k

backgroundstring請求體

可選的背景參數. 傳入 "transparent" 生成透明背景圖片, 不傳此參數時正常生圖.

文生圖和帶 reference_images 的圖生圖均可使用. 一般生圖請直接省略此欄位, 無需傳入 auto 或 opaque.

在 Playground 中選擇 gpt-image-2, 將 "背景" 從預設的 "一般" 切換為 "透明" 即可. 切回 "一般" 後, 請求不再攜帶 background.

尺寸對照表

size1k2k4k
1:11024x10242048x20482880x2880
3:21536x10242048x13603520x2336
2:31024x15361360x20482336x3520
4:31024x7682048x15363312x2480
3:4768x10241536x20482480x3312
5:41280x10242560x20483216x2576
4:51024x12802048x25602576x3216
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
2:12048x10242688x13443840x1920
1:21024x20481344x26881920x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840
ninteger請求體預設值: 1

生成圖像的數量

默認:1

response_formatstring請求體預設值: url

返回格式

固定返回圖片 URL,推薦使用 url

reference_imagesstring[]請求體

參考圖 URL 列表,用於圖生圖

⚠️ 僅支持 URL 格式(不再支持 base64)

  • 公開可訪問的圖片 URL(http:// 或 https://)
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL
  • 支持單圖和多圖參考
  • 最多 14 張圖片
image_urlsstring[]請求體

向後兼容的參考圖字段

在 ToAPIs 中會自動歸一化爲 reference_images

Response

idstring

任務唯一標識符,用於查詢任務狀態

objectstring

對象類型,固定爲 generation.task

modelstring

使用的模型名稱

statusstring

任務狀態

  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
progressinteger

任務進度百分比(0-100)

created_atinteger

任務創建時間戳(Unix 時間戳)

請求示例

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "生成一張未來城市夜景海報,霓虹燈,電影感構圖",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }'
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留主體結構,把畫面改成賽博朋克風格,增強光影和細節",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "image_urls": [
      "https://example.com/source.png",
       "https://example.com/source.png",
      "https://example.com/source.png"
    ],
    "response_format": "url"
  }'
const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'Generate a futuristic city night poster with neon lighting and cinematic composition',
    n: 1,
    size: '1:1',
    resolution: '1k',
    response_format: 'url'
  })
});

const task = await response.json();
console.log(task.id, task.status);
curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "生成一隻可愛的貓咪貼紙, 背景透明",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "background": "transparent",
    "response_format": "url"
  }'

響應示例

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}