image-clarity-enhance
通过 Flyelep AI 工具接口增强图片清晰度,支持单张或批量处理。 当用户要求做 AI 超清、提升图片清晰度、批量增强模糊图片时使用此技能。
Flyelep AI超清
通过 Flyelep AI Tool API 增强图片清晰度,并返回增强后的新图片 URL。
重要:这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口,禁止通过浏览器访问 Flyelep 网站。
API 接口信息
- URL:
POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/imageClarityEnhance - Content-Type:
application/json - 认证方式: 在请求头中传入
secretKey(密钥需由用户在 Flyelep 开放平台申请:https://www.flyelep.cn/controlboard) - 超时时间: 建议 120-300 秒
请求头示例:
Content-Type: application/json
secretKey: 用户提供的API密钥
安全说明:不要将真实密钥写入技能文件、示例代码仓库或持久化配置中,应在运行时由用户动态提供。
请求 Body
{
"imgUrls": "https://example.com/img1.jpg,https://example.com/img2.jpg",
"enhanceStrength": "light"
}
响应格式
{
"code": 200,
"msg": null,
"data": "https://example.com/clear1.jpg,https://example.com/clear2.jpg",
"result": {
"fileUrlList": ["https://example.com/clear1.jpg", "https://example.com/clear2.jpg"],
"taskId": 2118243882832912400
}
}
code=200表示调用成功;判断成功只看code,业务失败时 HTTP 状态码仍是 200,code为 500 或 9999,原因在msg里,且不带resultmsg成功时为nulldata为超清后的图片地址,多张时以英文逗号,分隔(为兼容已接入的调用方保留)result.fileUrlList为结果图片 URL 数组,按输入顺序排列,新接入优先读这个字段result.taskId为本次主任务 ID,可凭它调用/api/v1/poster/queryTaskResult复查每张图的明细;它是 19 位长整数,用 JavaScript 等解析时按字符串处理,避免丢精度- 批量时部分图片失败不影响其余图片:结果里只包含成功的图片,数量可能少于输入,不能按下标与输入一一对应;全部失败时整个请求返回错误,
msg为第一张失败的原因 - 返回结果应逐个展示给用户,不要回读图片内容
参数说明
必传参数
重要:以下必传参数必须通过询问用户获取,agent 不可自行填写。调用本技能时,应先向用户列出必传参数与可选参数表格,由用户确认或提供后再执行。
| 字段 | 默认值 | 说明 |
|---|---|---|
| imgUrls | - | 图片链接字符串,单张直接传,多张用英文逗号分隔 |
| enhanceStrength | light | 增强强度:light、standard、strong。不传或传空时按 light 处理,建议每次显式传值 |
可选参数
| 字段 | 默认值 | 说明 |
|---|---|---|
| imageUrlList | - | 图片链接数组,与 imgUrls、imageUrl 三选一;同时传时优先级为 imageUrlList > imgUrls > imageUrl |
| imageUrl | - | 单张图片链接,与 imgUrls 二选一 |
| physicalWidthMm | - | 印刷成品物理宽度(毫米),与 physicalHeightMm 同时传且都大于 0 时,结果按 300DPI 等比放大并居中裁剪到该尺寸,用于印刷 |
| physicalHeightMm | - | 印刷成品物理高度(毫米),须与 physicalWidthMm 一起传 |
参数映射规则
imgUrls:
- 接口要求传字符串,不是数组
- 单张图片时直接传一个 URL 字符串
- 多张图片时,用英文逗号
,按顺序拼接 - 每个链接都应为公网可访问的图片直链,不要传网页地址
- 也可以改用
imageUrlList(字符串数组)传多张,或用imageUrl字段传单张图片;同时传时优先级为imageUrlList>imgUrls>imageUrl - 如果用户提供本地文件路径,先按「本地文件上传」章节换取公网直链,再填入此参数
enhanceStrength:
light:轻度增强,输出约放大 2 倍,按基础单价计费standard:标准增强,输出约放大 4 倍,按 2 倍单价计费strong:强力增强,输出约放大 8 倍,按 3 倍单价计费- 不区分大小写;不传或传空时按
light处理;传上述三个以外的值会报错 - 只对成功的图片扣算力:扣费 = 成功张数 × 强度倍数 × 单价
推荐默认规则:
- 用户未指定增强强度时,默认传
light - 用户强调“尽量自然、轻微增强”时,传
light - 用户强调“尽可能清晰、强力修复”时,传
strong
图片规格限制
每张源图需满足以下限制(服务端下载原图后逐张校验):
- 格式:服务端能识别尺寸的常见图片格式,建议
JPG、PNG - 最短边不低于
256px - 最长边不超过
2048px,超出时会提示先压缩图片 - 文件大小不超过
10MB - 链接必须能被服务端直接下载(返回 HTTP 200)
不满足的图片单张失败,msg 会给出具体原因和当前尺寸或大小;批量时其余图片照常处理。
本地文件上传
用户提供的是本地文件路径而不是公网直链时,先把文件上传换取直链,再调用本接口。已安装 file-upload 技能时以该技能为准;未安装时按下面的说明直接调用上传接口。
- URL:
POST https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload - 请求方式:
multipart/form-data,文件字段名固定为file,单次只能上传一个文件,多个文件并发调用多次 - 认证方式: 请求头传
secretKey,与本技能使用同一个密钥 - 超时时间: 图片建议 60-120 秒
- 不要手动设置
Content-Type请求头,让 HTTP 客户端自动生成带 boundary 的值,手写会导致服务端解析失败 - 图片仅支持
bmp、gif、jpg、jpeg、png,webp需先转成png或jpg;文件名必须带正确后缀,服务端靠它判断格式 - 原文件名不会出现在 URL 里,中文名、空格、特殊字符都能直接上传,不需要提前改名
- 上传不消耗算力,但服务端不做去重:同一个文件在一次任务里只上传一次,记下
fullPath复用
成功响应取 data.fullPath 作为公网直链(不带签名,按 24 小时限时链接对待,拿到后直接用于本次调用,不要长期保存):
{
"code": 200,
"msg": null,
"data": {
"relativePath": "oss_ai_agent_h_24/2026-11-12/3f2a9c1b7d84e6f5a0123b4c5d6e7f80.png",
"fullPath": "https://oss-agent-7346.flyelep.cn/oss_ai_agent_h_24/2026-11-12/3f2a9c1b7d84e6f5a0123b4c5d6e7f80.png",
"serviceProvider": null
}
}
判断成功只看 code,业务失败时 HTTP 状态码仍是 200,code 为 500 或 9999,原因在 msg 里。
# Windows/PowerShell(用 curl.exe,PowerShell 里的 curl 是 Invoke-WebRequest 的别名)
curl.exe -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload" -H "secretKey: 你的密钥" --max-time 120 -F "file=@C:/path/to/product.png"
# macOS/Linux
curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload" -H "secretKey: 你的密钥" --max-time 120 -F "file=@./product.png"
图片入桶前会先过内容审核,审核不通过整个请求失败,需换图重试。拿到 code=9999、msg 为 服务繁忙,请稍后再试 时,先自查三项:是否漏了 secretKey 请求头、表单字段名是否为 file、文件是否超出服务端体积上限。密钥、格式、审核、体积类错误重试无效,只有网络超时、5xx 和存储类异常值得重试。
调用示例
跨平台调用说明:
- 请求头必须包含
Content-Type: application/json; charset=utf-8和secretKey- Windows/PowerShell:因 GBK 编码问题,必须先将 JSON 写入临时文件
payload_temp.json(UTF-8 无 BOM),再用curl.exe --% --data-binary @payload_temp.json发送请求。使用 Write 工具创建文件,或用 .NET API[System.IO.File]::WriteAllText("payload_temp.json", $json, [System.Text.UTF8Encoding]::new($false))。调用后用rm payload_temp.json清理。- macOS/Linux:bash/zsh 默认 UTF-8,可直接内联 JSON:
curl -X POST URL -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --data-binary 'JSON单行内容'
示例 1:单张图片标准超清
前置步骤:向用户索取图片路径或 URL。如用户提供本地文件,先按「本地文件上传」章节换取公网直链。
Windows/PowerShell:
步骤 1:创建 payload_temp.json(两种方式任选其一):
方式 A(使用 Write 工具):
{
"imgUrls": "https://example.com/img1.jpg",
"enhanceStrength": "standard"
}
方式 B(无 Write 工具,PowerShell 执行):
[System.IO.File]::WriteAllText("payload_temp.json", '{"imgUrls":"https://example.com/img1.jpg","enhanceStrength":"standard"}', [System.Text.UTF8Encoding]::new($false))
步骤 2:执行请求:
curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/imageClarityEnhance" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 300 --data-binary @payload_temp.json
步骤 3:清理临时文件:
rm payload_temp.json
macOS/Linux:
curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/imageClarityEnhance" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 300 --data-binary '{"imgUrls":"https://example.com/img1.jpg","enhanceStrength":"standard"}'
示例 2:批量图片轻度超清
前置步骤:向用户索取图片路径或 URL。如用户提供本地文件,先按「本地文件上传」章节换取公网直链。
Windows/PowerShell:
步骤 1:创建 payload_temp.json(两种方式任选其一):
方式 A(使用 Write 工具):
{
"imgUrls": "https://example.com/img1.jpg,https://example.com/img2.jpg",
"enhanceStrength": "light"
}
方式 B(无 Write 工具,PowerShell 执行):
[System.IO.File]::WriteAllText("payload_temp.json", '{"imgUrls":"https://example.com/img1.jpg,https://example.com/img2.jpg","enhanceStrength":"light"}', [System.Text.UTF8Encoding]::new($false))
步骤 2:执行请求:
curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/imageClarityEnhance" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 300 --data-binary @payload_temp.json
步骤 3:清理临时文件:
rm payload_temp.json
macOS/Linux:
curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/imageClarityEnhance" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 300 --data-binary '{"imgUrls":"https://example.com/img1.jpg,https://example.com/img2.jpg","enhanceStrength":"light"}'
常见错误及解决方案
| 错误 | 原因与解决 |
|---|---|
msg 为 密钥无效! / 密钥格式错误! | secretKey 错误、被截断或已失效,向用户重新索取 |
code 为 9999、msg 为 服务繁忙,请稍后再试 | 最常见原因是漏传 secretKey 请求头,先自查请求头 |
| HTTP 405 Not Allowed | 请求方法错误,必须使用 POST |
imgUrls 格式错误 | 该字段必须是字符串,多张图用英文逗号分隔;要传数组请改用 imageUrlList |
图片链接不能为空 | imageUrlList、imgUrls、imageUrl 都没传或都是空值 |
enhanceStrength 仅支持 light / standard / strong | enhanceStrength 传了其他值,改成三者之一 |
图片下载失败... | 传入的链接不是公网直链、已过期,或源站限制访问 |
图片尺寸超出 AIGC 超分范围... / 图片尺寸过小... / 图片大小超出 AIGC 超分范围... | 不满足上面的图片规格限制,按提示压缩、裁剪或换图,原样重试无效 |
点数不足 | 账户算力不足,让用户充值后再试,重试无效 |
| 请求超时 | 批量图片较多或增强强度较高时,可适当增大超时时间 |
执行流程
- 向用户询问
secretKey(API 密钥必须由用户提供,agent 不可自行填写) - 收集一张或多张图片 URL(如用户提供本地文件,先按「本地文件上传」章节换取公网直链)
- 将多张 URL 用英文逗号拼接为
imgUrls - 根据用户意图选择
enhanceStrength - 确认源图尽量满足规格限制
- 在请求头中传入
secretKey,调用接口 - 将返回的
result.fileUrlList(或按逗号拆分data)逐个展示;数量少于输入时告诉用户有图片处理失败
该接口不接收自然语言提示词,不需要构造额外文案。当用户只是说“帮我变清晰一点”时,用本技能并传 light;当用户明确要求“放大尺寸、提分辨率”时,改用无损放大(image-enlarge)技能,那里的 scalingRatio 是放大倍数。
Related skills
- Downloads
- 1.5kAll time
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v1.0.5
- License
- MIT-0
