上传图片并选择画质增强版本,适合老图修复、商品图提高清晰度和细节增强。
标准版 0.1 / 专业版 0.5 / 大模型增强版 3 积分/张基础说明
上传图片并选择画质增强版本,适合老图修复、商品图提高清晰度和细节增强。
提交任务
提交图片高清任务。适用于图片放大、细节增强和老图修复,完成后返回高清结果图。
POST/api/third-party/imageHd/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证,用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | string | 是 | 原始图片 URL,需为公网可访问的 HTTP/HTTPS 图片地址。 |
| tool_version | string | 否 | 火山画质增强模型版本:standard(默认,0.1 积分/张)、professional(0.5 积分/张)或 max(3 积分/张)。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/imageHd/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"image": "https://your-cdn.com/product.png",
"tool_version": "professional"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码,200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存,用于查询生成结果。 |
| data.cost | number | - | 本次提交预扣积分。 |
| data.status | string | - | 任务初始状态,通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间,ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "图片高清任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"status": "pending",
"image": "https://your-cdn.com/product.png",
"tool_version": "professional",
"cost": 0.5
},
"timestamp": "2026-03-31T09:33:00.000Z"
}注意事项
- 图片建议清晰、主体完整,便于高清放大。
- tool_version 会原样传给火山 AI MediaKit:standard 为标准版、professional 为专业版、max 为大模型增强版。
- 按 tool_version 计费:standard 0.1 积分/张、professional 0.5 积分/张、max 3 积分/张。
- 放大倍率由服务端固定为 2 倍,无需在请求中传入。
- 上游为同步处理;为兼容统一任务协议,提交后仍通过 taskId 从获取结果接口读取已持久化的高清图。
- 火山结果地址仅短期有效,服务端会在配置 OSS 时自动转存。
