跳至主要內容

重新繪製 V2

用途​

根據提示詞，使用 AI 重新繪製圖片的一部分。上傳圖片並描述要重繪的內容。此功能與網頁應用程式「重繪圖片」頁面的 V2 分頁相同（預設分頁）。

代幣消耗： 3

方法與路徑​

POST /public/v1/image-tune/inpaint/v2

認證​

請參閱認證頁面。需要 Bearer Token。

必要標頭：

Authorization: Bearer {your_api_key}

請求欄位​

請以 multipart/form-data 傳送請求。

欄位名稱類型必填說明
imagefile是要重新繪製的原始圖片檔案（PNG 或 JPEG）
promptstring是你想重繪哪一部分？提示詞會原樣送出

提示詞指南

  • 具體描述要重繪的區域與想要的結果
  • 例如："Change background to blue sky"、"Remove object in upper right corner"

回應​

成功回應 (200 OK)：

{
  "job_id": "uuid-string"
}
欄位類型說明
job_idstring已建立作業的唯一識別碼。請使用取得作業狀態查詢結果

錯誤 / 驗證規則​

情況HTTP 狀態錯誤訊息
圖片不是有效的 PNG 或 JPEG 檔案400"Invalid image file"
無效的 API 金鑰401"Invalid API key"
欄位遺漏422Validation error

非同步作業行為​

此端點會建立非同步作業。它會立即回傳 job_id，重繪會在背景進行。

輪詢方法：

  1. 儲存回應中收到的 job_id
  2. 輪詢 GET /public/v1/job/{job_id} 確認狀態
  3. 當狀態變為 Succeed 時，於 image_urls 查看結果圖片

狀態流程： Pending → Succeed 或 Failed

請求範例​

cURL：

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "prompt=Change background to blue sky"

回應範例：

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}