首页/开放能力
imageHd

图片高清

上传图片并选择画质增强版本,适合老图修复、商品图提高清晰度和细节增强。

标准版 0.1 / 专业版 0.5 / 大模型增强版 3 积分/张

基础说明

上传图片并选择画质增强版本,适合老图修复、商品图提高清晰度和细节增强。

提交任务

提交图片高清任务。适用于图片放大、细节增强和老图修复,完成后返回高清结果图。

POST/api/third-party/imageHd/generate

请求头

字段类型必填说明
X-API-Tokenstring平台提供的调用凭证,用于识别当前账号或租户。
Content-Typestring提交任务时固定使用 application/json。

请求参数

字段类型必填说明
imagestring原始图片 URL,需为公网可访问的 HTTP/HTTPS 图片地址。
tool_versionstring火山画质增强模型版本: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"
  }'

响应字段

字段类型必填说明
codenumber-业务状态码,200 表示请求成功。
messagestring-本次请求的结果说明。
data.taskIdstring-任务 ID。提交成功后请保存,用于查询生成结果。
data.costnumber-本次提交预扣积分。
data.statusstring-任务初始状态,通常为 pending 或 processing。
timestampstring-响应时间,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 时自动转存。