提升质量
用途
此端点会将上传图片的质量提升到更高分辨率。将原始图片扩展到 1K、2K 或 4K 分辨率，生成更清晰、更高质量的图片。此功能与 Web 应用「提升质量」页面相同，该页面默认选择 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)
| 字段名 | 类型 | 必需 | 说明 |
|---|---|---|---|
image | file | 必需 | 要提升质量的原始图片文件 (PNG 或 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"
}