編輯圖像

概述Copy Anchor Link

根據原始圖像和提示詞建立編輯或擴展的圖像。

此端點同時支援：

• 下方文件中的 OpenAI 相容 multipart/form-data 上傳流程
• 為受支援的圖像到圖像模型提供 image_url、image_urls 或官方 images 參照的 JSON 請求

請求主體Copy Anchor Link

同步請求逾時： 某些圖片請求會以内嵌方式返回最終圖片，並等待生成完成。高解析度或高品質請求可能接近一分鐘甚至更久，因此請將 HTTP 用戶端逾時設定為至少 120s。如果建立回應包含 status: "pending"、task_id 或 poll_url，請改為依照返回的 poll_url 輪詢。

遠端圖片 URL：當需要 multipart 輸入時，TokenLab 會抓取 JSON image_url、image_urls 或 images[].image_url，並把圖片位元組作為 multipart image 檔案送出。URL 必須是公網 http/https，不能包含使用者名稱密碼或 fragment，不能解析到 localhost、內網或保留 IP；每次重新導向後的目標也會重新校驗。抓取到的內容必須是真實 PNG、JPEG 或 WebP 圖片。限制為單圖 50 MiB、單次請求 URL 抓取圖片總計 200 MiB、抓取逾時 30s、最多 3 次重新導向。

JSON 請求必須且只能選擇 image_url、image_urls、images 中的一項。每個 images[] 物件必須且只能包含 image_url 或 file_id 中的一項。200 MiB 總量限制包含所有來源圖片與遮罩。

回應Copy Anchor Link

非同步任務回應Copy Anchor Link

搭配 gpt-image-2 或官方 FLUX/BFL 編輯模型設定 async: true 後，請求會先建立任務，而不是等待編輯後圖片完成。回應包含 status: "pending"、task_id 和 poll_url。請輪詢 /v1/tasks/{task_id}，直到任務進入 completed 或 failed。

非同步編輯任務最終只返回圖片 URL。如果你需要原始 b64_json 圖片資料，請使用同步請求。

任務建立時可能會先預留預估費用。任務完成後按實際用量結算；失敗或逾時的任務會釋放預留費用或退回費用。

curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "image=@sunlit_lounge.png" \
  -F "mask=@mask.png" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

注意事項Copy Anchor Link

{
  "model": "hy-image-v3.5-preview",
  "prompt": "Change the table to pale blue",
  "image_url": "https://example.com/reference.png",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}