跳到正文
土土金API

API 參考

影像編輯 Images Edits

POST /v1/images/edits 的參數與示例:上傳原圖加提示詞修改圖片,支援多圖合成和蒙版局部重繪。multipart/form-data 格式,與 OpenAI 影像編輯介面一致,本站按原格式轉發請求。

POST /v1/images/edits 在一張或多張原圖的基礎上,按提示詞生成新圖片。常見用法是換背景、改畫面裡的文字、局部重繪,或者把商品圖和 logo 合成到一起。請求用 multipart/form-data 上傳檔案,格式與 OpenAI Images API 一致。本站把請求按原格式轉發給模型服務,不同模型支援的欄位和取值不同,以對應模型的官方說明為準。

POSThttps://www.tutujin.com/v1/images/edits

請求頭

請求頭必填說明
Authorization是Bearer sk-...,控制台建立的 API Key
Content-Type是multipart/form-data。用 SDK 或 curl -F 時會自動設定並帶上 boundary,不要手寫

請求參數

參數類型必填說明
modelstring是模型名,例如 gpt-image-1.5
imagefile是原圖,常見格式 PNG、JPEG、WEBP。GPT Image 系列可以傳多張,表單欄位名寫成 image[]
promptstring是修改要求,說明要改什麼、哪些地方保持不變
maskfile否蒙版 PNG。透明區域(alpha 為 0)是要重繪的位置,尺寸要和原圖一致,作用於第一張原圖
ninteger否生成幾張,預設 1
sizestring否輸出尺寸,可選值因模型而異
qualitystring否GPT Image 系列可選 low、medium、high、auto
response_formatstring否url 或 b64_json,部分模型只支援其中一種

請求示例

下面的例子把 logo 印到杯身上,cup.png 是商品圖,logo.png 是 logo:

curl https://www.tutujin.com/v1/images/edits \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -F model="gpt-image-1.5" \
  -F "image[]=@cup.png" \
  -F "image[]=@logo.png" \
  -F prompt="把第二张图的 logo 印在杯身正面,保持杯子形状、颜色和光线不变"

用蒙版局部重繪

只想改畫面的一部分時,再上傳一張和原圖同尺寸的 PNG 蒙版,把要重繪的區域做成透明:

cURL
curl https://www.tutujin.com/v1/images/edits \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -F model="gpt-image-1.5" \
  -F "image[]=@room.png" \
  -F mask=@mask.png \
  -F prompt="在透明区域放一盆绿植,风格和光线与房间一致"

響應示例

JSON
{
  "created": 1794000000,
  "data": [
    { "b64_json": "iVBORw0KGgo..." }
  ]
}
欄位說明
data[].b64_jsonbase64 編碼的圖片資料
data[].url圖片的臨時連結,模型返回連結時出現,會過期
usage按 token 計費的影像模型會返回輸入、輸出 tokens,原圖也計入輸入

注意事項

  • 這個介面是原樣轉發,沒有在本站單獨實測。GPT Image 以外的模型對欄位名、多圖寫法的要求可能不同,接入前先用一兩次請求確認。
  • 上傳檔案的字尾要和真實格式一致,例如 cup.png 必須真的是 PNG,否則可能報錯或出圖異常。
  • 原圖越大,請求越慢,也可能觸發請求體過大(413)。傳送前把圖片縮到夠用的尺寸。
  • 返回的連結是臨時地址,下載後轉存到自己的儲存。
  • 生圖耗時較長,客戶端超時建議設為 300 秒左右。實際扣費以控制台「操作日誌」為準。

支援此介面的模型

模型廠商最低價分組輸入 ¥/百萬輸出 ¥/百萬按次 ¥/次
nano-banana-proGoogle標準——¥0.4
fluxFlux 繪圖標準——¥0.02
flux-schnellFlux 繪圖標準——¥0.02
flux-devFlux 繪圖標準——¥0.06
gpt-4o-imageOpenAI標準——¥0.1
flux-proFlux 繪圖標準——¥0.1
grok-imagine-image-2.0xAI標準——¥0.12
gpt-image-1.5OpenAI標準——¥0.12

價格為人民幣,取各模型最低價分組;價格更新於 2026年11月13日 下午6:08。

共 31 個模型支援此介面,上表列出其中一部分。 在模型廣場檢視全部

沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。