Skip to main content
POST
GPT-Image-2.5 圖像生成
普通版通過 POST /v1/images/generations 建立圖片任務, 返回任務 ID. 任務完成後通過查詢接口獲取圖片 URL. 兩個模型使用相同的請求格式: gpt-image-2.5 是系列名稱. 調用時請填寫表中的完整模型名.
本文介紹普通版. 需要按實際 token 計費時, 請使用獨立的 GPT-Image-2.5 VIP 文檔. 兩版都使用異步任務, 主要區別在 size 格式和計價方式.
中國大陸用戶請注意: 中國大陸用戶請使用 https://toapis.cn 作為接口地址(Base URL)。文檔示例中的 https://toapis.com 請替換為 https://toapis.cn
API Key 可在 控制台 建立。

快速開始

將自己的 ToAPIs API Key 設置為環境變量 TOAPIS_API_KEY, 提交任務:
提交響應示例:
保存返回的 id, 將下方的 TASK_ID 替換為該值後查詢:
任務可能經過 pending, queued, in_progress, 最終進入 completedfailed. completed 時從 result.data 讀取圖片 URL, failed 時讀取 error. 建議每隔數秒查詢一次. 完整字段見 圖片任務狀態接口. 提交成功表示任務已建立. 請等到 completed 後再下載圖片; 等待期間繼續查詢同一個任務 ID.

請求參數

string
必填
使用 Bearer YOUR_TOAPIS_API_KEY 認證.
string
必填
gpt-image-2.5-flaregpt-image-2.5-sunburst.
string
必填
圖片描述. 使用參考圖時, 描述需要保留的主體和需要修改的內容.
string
預設值:"high"
當前普通版 W8X 渠道固定使用 high, 可省略此參數. 傳入其他字符串值會被忽略, 統一使用 high. Playground 不展示質量選項.當前普通版按 resolution 定價.
string
預設值:"1:1"
畫面比例, 例如 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 21:9.推薦使用比例並顯式填寫 resolution. 服務端根據二者計算輸出像素尺寸. 普通版的比例寫法與 VIP 版的像素尺寸寫法不同.
string
預設值:"1K"
分辨率檔位, 支持 1K, 2K, 4K, 也接受小寫形式. 該字段決定普通版的計價檔位.
string
可選的背景參數. 傳入 "transparent" 生成透明背景圖片, 不傳此參數時正常生圖.文生圖和帶 reference_images 的圖生圖均可使用. 一般生圖請直接省略此欄位.
integer
預設值:1
每次請求使用 1, 生成一張圖片.
string[]
可選的參考圖 URL 列表. 圖片地址需要能被服務端訪問. 本地圖片請先通過 上傳圖片接口 獲取 URL.也兼容 image_urls. 選擇其中一個字段即可. 本接口示例使用 URL 參考圖; 需要直接上傳本地文件進行編輯時, 請參考 VIP 圖片編輯.

比例和分辨率示例

4K 表示分辨率檔位, 實際長寬取決於畫面比例, 例如正方形 4K 輸出為 2880x2880.

參考圖生成

使用同一個生成接口, 增加 reference_images. 下例使用 Sunburst, 返回值仍然是異步任務:
https://example.com/otter.png 替換為自己的參考圖 URL, 然後使用返回的任務 ID 查詢結果.

價格

以下為 2026-09-09 核對的標準價格, 每次生成一張圖片, 兩個普通版模型價格相同: 這三個價格均適用於 low, medium, high, xhigh, max. 當前參考圖輸入沒有額外的按張費用. 賬戶專屬定價或折扣可能不同, 最新價格以 模型定價頁 和賬戶實際配置為準.

與 VIP 版的區別

切換到 VIP 時, 請同時調整模型名和參數. 詳見 GPT-Image-2.5 VIP.