跳至主要內容

提升品質

用途​

此端點以更高的解析度提升上傳圖片的品質。它會將原始圖片放大至 1K、2K 或 4K 解析度，產生更清晰、更高品質的圖片。此功能與網頁應用程式「提升品質」頁面相同，該頁面預設選擇 2K。

代幣消耗： 5（1K）、7（2K）、10（4K）

方法與路徑​

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

認證​

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

必要標頭：

Authorization: Bearer {your_api_key}

請求欄位​

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

欄位名類型必填說明
imagefile必填要提升品質的原始圖片檔案（PNG 或 JPEG）
scalestring必填目標解析度。可用值："1K"、"2K"、"4K"

Scale 值​

  • "1K"：放大至 1024px 解析度
  • "2K"：放大至 2048px 解析度
  • "4K"：放大至 4096px 解析度

回應​

JobIdResponse​

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

錯誤 / 驗證規則​

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

非同步作業行為​

此端點以非同步方式處理。請求立即回傳 job_id，實際的提升品質處理於背景進行。

作業流程：

  1. 傳送圖片檔案與 scale 參數後立即回傳 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/upscale" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "scale=2K"

回應範例​

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