📦 Product Color Change通过 — 产品颜色变更通过

v1.0.0

Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。

0· 19·0 当前·0 累计

by @flyelepai (flyelep)

AI模型访问

下载技能包

最后更新

2026/4/20

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

medium confidence

该技能的行为（调用 Flyelep API 并需提供 secretKey，同时接受任意图片 URL）与其声明目的相符，但技能元数据未声明所需凭据，且指令允许传递外部/内部 URL（可能存在数据泄露/SSRF 风险），因此包内部不一致，使用前需澄清。

评估建议

安装前，请向技能作者确认以下事项： 1. SKILL.md 要求 Flyelep API 的 secretKey，但技能元数据未声明任何必需凭据——请作者添加声明的环境变量（如 FLYELEP_SECRET_KEY 或 primaryEnv），以便安全提供密钥。 2. 不要将长期有效的 master API 密钥直接粘贴在技能文件中；应在运行时提供，或使用最小权限的 scoped key。 3. 技能会把任何 sourceUrl 转发给 Flyelep——避免传入内部、私有或敏感端点（可能通过第三方请求泄露内部数据）。使用前请要求作者提供 URL 校验/净化方案。 4. 发送图片或内部 URL 前，先验证 Flyelep 的服务身份（域名、TLS）并查阅其隐私/数据保留政策。 5. 若需带凭据的自主代理调用，请谨慎：能调用外部服务且未声明凭据的自主技能风险更高。若作者无法解决上述不一致（在元数据中声明凭据、文档化安全 URL 限制、提供源码仓库/主页），则视该技能为不可信。...

详细分析 ▾

ℹ 用途与能力

名称与描述（通过 Flyelep 更改产品颜色）与运行时指令一致：该技能仅向 Flyelep 的 productColorChange 端点发出 HTTP POST 请求。SKILL.md 中除所述目的外无额外功能。

⚠ 指令范围

运行时指令要求在请求头中提供 `secretKey`，并指示智能体将用户提供的图片 URL 与提示通过 POST 请求发送至外部 Flyelep API。指令允许任意 `sourceUrl` 值（公开图片链接），不做任何限制或校验，意味着用户提供的 URL 可能诱导外部服务访问内部或敏感端点（SSRF/数据泄露）。文档还明确警告不要使用浏览器，却未给出安全 URL 格式或过滤建议。

✓ 安装机制

这是一个仅含指令的技能，没有安装配置，也没有代码文件，因此不会写入磁盘，安装风险低。

⚠ 凭证需求

SKILL.md 明确要求 Flyelep 的 `secretKey` 头用于认证，但技能元数据中未声明任何必需的环境变量或主凭证。这种不一致是实质性缺陷：技能需要密钥，却在元数据中未请求，导致用户可能不知道运行时必须提供 API key，也不清楚应如何提供。

✓ 持久化与权限

该技能未标记 always:true，使用平台的默认自主调用设置；无迹象表明其试图修改其他技能或系统配置。

安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/20

Flyelep 产品换色技能首发版 - 通过 Flyelep AI HTTP API 实现图像商品智能换色。 - 需 POST 请求并附带用户 secretKey 鉴权。 - 支持用清晰文本提示修改颜色，可保留材质、光影或品牌标识。 - 可选模型：gemini-2.5（默认）或 gemini-3-pro。 - 返回换色后图片 URL，不直接处理或展示图片内容。 - 提供提示词撰写、错误处理及最佳实践指引。

● 无害

安装命令

点击复制

官方npx clawhub@latest install flye-product-color-change

镜像加速npx clawhub@latest install flye-product-color-change --registry https://cn.longxiaskill.com

技能文档

通过 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/productColorChange
Content-Type: application/json
认证方式: 在请求头中传入 secretKey
超时时间: 建议 120-300 秒

认证方式

所有 AI 工具接口均需在请求头中传入 secretKey。该密钥需由用户在 Flyelep 开放平台申请获得。请求头示例： ``

http  
Content-Type: application/json  
secretKey: 用户提供的API密钥

安全说明：secretKey 必须放在请求头中，这是 AI 工具接口的统一鉴权要求。不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。

`请求 Body`

json  
{  
  "sourceUrl": "https://example.com/product_red.jpg",  
  "textPrompt": "将商品颜色改为深蓝色",  
  "modelType": 0  
}

  
响应格式  
统一响应结构：

json  
{  
  "code": 200,  
  "msg": "操作成功",  
  "data": "https://example.com/product_blue.jpg"  
}

code=200 表示调用成功

msg 为接口返回说明

data 为换色后的图片 URL

返回结果应直接展示给用户，不要回读图片内容。  
参数说明  
必传参数  
| 字段 | 默认值 | 说明 |  
|------|--------|------|  
| sourceUrl | - | 原图链接 |  
| modelType | - | 模型类型：

0=gemini-2.5，1=gemini-3-pro

 |  
推荐传入参数  
| 字段 | 默认值 | 说明 |  
|------|--------|------|  
| textPrompt | - | 换色提示词，如“将商品颜色改为深蓝色” |  
参数映射规则  
sourceUrl  
传入待换色商品的原图公网 URL  
必须是图片直链，不要传网页地址  
原图应尽量清晰展示商品主体和原始颜色  
modelType

0：gemini-2.5

1：gemini-3-pro

推荐默认规则：

用户未指定模型时，默认传 0

`textPrompt`


文档将其标为必需  
直接描述目标颜色及必要约束  
应尽量明确“将什么改成什么颜色”  
推荐写法示例：

将商品颜色改为深蓝色

把包包主体颜色改为奶油白，保留金属扣件颜色不变

将耳机外壳换成哑光黑色，保持材质质感与光影不变

把杯身改为浅绿色，保留品牌标识和背景不变

`提示词边界`


优先描述颜色，不要把换色需求扩写成换材质或换商品  
如果用户只是想“更换商品”，应改用商品替换 skill  
如果用户想“换背景”，应改用场景替换 skill

说明：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 type 字段，调用方无需传入 type。

`调用示例`


基础商品换色：

bash  
curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange" \  
  -H "Content-Type: application/json" \  
  -H "secretKey: 你的密钥" \  
  --max-time 300 \  
  -d '{  
    "sourceUrl": "https://example.com/product_red.jpg",  
    "textPrompt": "将商品颜色改为深蓝色",  
    "modelType": 1  
  }'

强调保留材质与光影的换色：`bash curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange" \ -H "Content-Type: application/json" \ -H "secretKey: 你的密钥" \ --max-time 300 \ -d '{ "sourceUrl": "https://example.com/product_watch.jpg", "textPrompt": "将表带改为深棕色皮革观感，保留金属表盘和整体光影不变", "modelType": 1 }'`

`常见错误及解决方案`


| 错误 | 原因与解决 |  
|------|-----------|  
| HTTP 401 /

code 非 200 | secretKey

 无效、缺失或已过期，确认请求头是否正确传入 |  
| HTTP 405 Not Allowed | 请求方法错误，必须使用

POST

 |  
|

sourceUrl

 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |  
|

modelType 非 0/1 | 模型类型只支持 0 或 1

 |  
| 换色结果偏差较大 |

textPrompt

 过于模糊，可补充目标颜色、材质观感和保留项 |  
| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |  
| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |  
提示词处理  
该接口支持

textPrompt`，商品换色的结果高度依赖提示词描述质量。执行时应遵循：

明确目标颜色
明确保留项：材质、品牌标识、背景、光影、构图
避免把“换色”写成“换商品”或“换背景”
对多部件商品可明确指定仅修改哪个部位

当用户要求“同款不同色”“把红色改成蓝色”时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。

数据来源：ClawHub ↗ · 中文优化：龙虾技能库