跳至主要內容

POST /image-tune/inpaint/v1

用途​

此端點使用 AI 自然修改圖片的特定部分。根據上傳的圖片與提示詞,修改指定區域以產生想要的結果。此功能與網頁應用程式「重繪圖片」頁面的 V1 分頁相同(網頁應用程式預設開啟 V2 分頁)。

代幣消耗: 5

方法與路徑​

  • HTTP Method: POST
  • Path: /public/v1/image-tune/inpaint/v1

認證​

此端點需要 Bearer Token 認證。詳細資訊請參閱認證指南。

必要標頭:

Authorization: Bearer {your_api_key}

請求欄位​

表單資料 (multipart/form-data)​

欄位名類型必填說明
imagefile必填要重新繪製的原始圖片檔案(PNG 或 JPEG)
promptstring必填描述重繪內容的文字提示詞

Prompt 指南​

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

回應​

JobIdResponse​

欄位名類型說明
job_idUUID已建立作業的唯一識別碼。使用此 ID 查詢作業狀態

錯誤 / 驗證規則​

HTTP 狀態碼錯誤情境說明
400 Bad RequestInvalid image fileInvalid image file
401 Unauthorized認證失敗無效的 API 金鑰或遺漏的認證標頭
404 Not Found使用者不存在找不到 API 金鑰連結的使用者
422 Unprocessable Entity驗證失敗必填欄位遺漏

非同步作業行為​

此端點以非同步方式處理。請求立即回傳 job_id,實際的重繪處理於背景進行。

作業流程:

  1. 傳送圖片檔案與提示詞後立即回傳 job_id
  2. 背景進行重繪處理
  3. 使用 GET /job/{job_id} 端點輪詢確認狀態
  4. status 變更為 Succeed 時,於 image_urls 查看結果圖片 URL

輪詢間隔: 建議 1-2 秒

請求範例​

cURL​

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/inpaint/v1" \
-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"
}