提升品質
用途
此端點會將上傳影像的品質提升到高解析度。將原始影像擴展為 1K、2K 或 4K 解析度，產生更清晰、更高品質的影像。
方法與路徑
- HTTP Method:
POST - Path:
/public/v1/image-tune/upscale
認證
此端點需要 Bearer Token 認證。詳細資訊請參閱認證指南。
必要標頭：
Authorization: Bearer {your_api_key}
請求欄位
表單資料 (multipart/form-data)
| 欄位名 | 類型 | 必填 | 說明 |
|---|---|---|---|
image | file | 必填 | 要放大的原始影像檔案 (PNG, JPG, JPEG 等) |
scale | string | 必填 | 目標解析度。可能的值："1K", "2K", "4K" |
Scale 值
"1K": 放大至 1024px 基準解析度"2K": 放大至 2048px 基準解析度"4K": 放大至 4096px 基準解析度
回應
JobIdResponse
| 欄位名 | 類型 | 說明 |
|---|---|---|
job_id | UUID | 已建立作業的唯一識別碼。使用此 ID 查詢作業狀態 |
錯誤 / 驗證規則
| HTTP 狀態碼 | 錯誤情境 | 說明 |
|---|---|---|
400 Bad Request | Invalid image file | Invalid image file |
401 Unauthorized | 認證失敗 | 無效的 API 金鑰或遺漏的認證標頭 |
404 Not Found | 使用者不存在 | 找不到 API 金鑰連結的使用者 |
422 Unprocessable Entity | 驗證失敗 | 必填欄位遺漏或無效的 scale 值 |
非同步作業行為
此端點以非同步方式處理。請求立即回傳 job_id，實際放大處理於背景進行。
作業流程：
- 傳送影像檔案與 scale 參數後立即回傳
job_id - 背景進行放大處理
- 使用
GET /job/{job_id}端點輪詢確認狀態 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"
}