云凡智联

首页/开放能力

imageHd

图片高清

上传图片并按倍率放大清晰度，适合老图修复、商品图提高清晰度和细节增强。

1积分/次

基础说明

上传图片并按倍率放大清晰度，适合老图修复、商品图提高清晰度和细节增强。

提交任务

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

POST/api/third-party/imageHd/generate

请求头

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

请求参数

字段	类型	必填	说明
image	string	是	原始图片 URL，需为公网可访问的 HTTP/HTTPS 图片地址。
scaleBy	number	否	放大倍率，1-8，默认 2。

请求示例

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",
    "scaleBy": 2
  }'

响应字段

字段	类型	必填	说明
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",
    "scaleBy": 2,
    "cost": 1
  },
  "timestamp": "2026-03-31T09:33:00.000Z"
}

注意事项

图片建议清晰、主体完整，便于高清放大。
scaleBy 默认 2，建议按需取值。
提交接口只负责创建任务，生成结果请通过获取结果接口查询。
达到服务端并发提交上限时会进入等待队列；等待超时或队列满时返回 429，请稍后重试。