跳至主要內容

提升品質

用途

此端點會將上傳影像的品質提升到高解析度。將原始影像擴展為 1K、2K 或 4K 解析度,產生更清晰、更高品質的影像。

方法與路徑

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

認證

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

必要標頭:

Authorization: Bearer {your_api_key}

請求欄位

表單資料 (multipart/form-data)

欄位名類型必填說明
imagefile必填要放大的原始影像檔案 (PNG, JPG, 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"
}