{"id":"cb8c1378-c979-4624-84b9-863e4348a045","entityType":"agent","slug":"clawhub-flyelepai-flyelep-product-color-change","name":"product-color-change","canonicalUrl":"https://www.xpersona.co/agent/clawhub-flyelepai-flyelep-product-color-change","canonicalPath":"/agent/clawhub-flyelepai-flyelep-product-color-change","generatedAt":"2026-10-11T07:43:32.442Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":null},"description":"通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Skill: product-color-change Owner: flyelepai Summary: 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-08-28T03:15:35.121Z | user - Updated API parameter modelType to require value 9 (was previously 0); only 9 is now supported. - Added optional parameters: prompt (for supplementary instructions) and replaceImageUrl (for color reference im","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s175rfkzzv81fcfhp65sjggxa984fmry:flyelep-product-color-change","sourceUrl":"https://clawhub.ai/flyelepai/flyelep-product-color-change","homepage":"https://clawhub.ai/flyelepai/skills/flyelep-product-color-change","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/flyelepai/flyelep-product-color-change","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/flyelepai/skills/flyelep-product-color-change","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Skill: product-color-change Owner: flyelepai Summary: 通过 Flyelep AI 工具接口智能识别图片中的商"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":null},"stars":null,"forks":null,"downloads":1143,"packageName":null,"latestVersion":"1.0.4","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T05:41:53.952Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T05:41:53.966Z","lastCrawledAt":"2026-10-11T05:41:53.952Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T05:41:53.953Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.4","createdAt":"2026-08-28T03:15:35.121Z","changelog":"- Updated API parameter `modelType` to require value `9` (was previously `0`); only `9` is now supported. - Added optional parameters: `prompt` (for supplementary instructions) and `replaceImageUrl` (for color reference image). - Clarified steps for uploading local files to obtain a public URL when only a file path is provided. - Expanded error handling and troubleshooting, including new parameter validation and file upload limits. - Improved structured instructions, parameter documentation, and sample calls for both Windows and macOS/Linux environments. - Removed the file `skill-card.md` from the package.","fileCount":3,"zipByteSize":6235},{"version":"1.0.3","createdAt":"2026-08-07T06:15:10.871Z","changelog":"- Removed the file: skill-card.md. - Updated required parameter handling: now agents must ask users for all required parameters before executing, and must present a parameter table for user confirmation. - Changed modelType to always default/fixed to 0 (was previously allowed 0/1). - Added detailed, platform-specific API calling procedures and encoding notes (Windows/PowerShell, macOS/Linux), with new requirements for handling JSON payloads and file cleanup. - Updated error table to reflect only modelType=0 is valid. - Clarified textPrompt and parameter collection process, strengthening compliance requirements.","fileCount":3,"zipByteSize":5231},{"version":"1.0.2","createdAt":"2026-04-27T03:58:18.035Z","changelog":"- No file changes detected in this version. - No updates or modifications were made to the skill or its documentation. - Functionality, usage, and API details remain unchanged.","fileCount":3,"zipByteSize":4153},{"version":"1.0.1","createdAt":"2026-04-27T01:16:41.555Z","changelog":"- 添加了 Flyelep 开放平台注册/密钥申请链接至认证方式说明。 - 其余文档内容保持不变。","fileCount":2,"zipByteSize":2834},{"version":"1.0.0","createdAt":"2026-04-20T09:59:00.519Z","changelog":"Initial release of the Flyelep product color change skill. - Supports intelligent color changing of products in images via the Flyelep AI HTTP API. - Requires POST requests with user-provided secretKey for authentication. - Allows color modification using clear text prompts, supporting details like preserving material, light, or branding. - Supports model selection between gemini-2.5 (default) and gemini-3-pro. - Returns the URL of the color-changed image; does not directly process or display image content. - Provides guidance on prompt writing, error handling, and best practices for optimal results.","fileCount":2,"zipByteSize":2820}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s175rfkzzv81fcfhp65sjggxa984fmry:flyelep-product-color-change","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T07:43:32.441Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-color-change/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":null},"readme":"Skill: product-color-change\n\nOwner: flyelepai\n\nSummary: 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n\nTags: latest:1.0.4\n\nVersion history:\n\nv1.0.4 | 2026-08-28T03:15:35.121Z | user\n\n- Updated API parameter `modelType` to require value `9` (was previously `0`); only `9` is now supported.\n- Added optional parameters: `prompt` (for supplementary instructions) and `replaceImageUrl` (for color reference image).\n- Clarified steps for uploading local files to obtain a public URL when only a file path is provided.\n- Expanded error handling and troubleshooting, including new parameter validation and file upload limits.\n- Improved structured instructions, parameter documentation, and sample calls for both Windows and macOS/Linux environments.\n- Removed the file `skill-card.md` from the package.\n\nv1.0.3 | 2026-08-07T06:15:10.871Z | user\n\n- Removed the file: skill-card.md.\n- Updated required parameter handling: now agents must ask users for all required parameters before executing, and must present a parameter table for user confirmation.\n- Changed modelType to always default/fixed to 0 (was previously allowed 0/1).\n- Added detailed, platform-specific API calling procedures and encoding notes (Windows/PowerShell, macOS/Linux), with new requirements for handling JSON payloads and file cleanup.\n- Updated error table to reflect only modelType=0 is valid.\n- Clarified textPrompt and parameter collection process, strengthening compliance requirements.\n\nv1.0.2 | 2026-04-27T03:58:18.035Z | user\n\n- No file changes detected in this version.\n- No updates or modifications were made to the skill or its documentation.\n- Functionality, usage, and API details remain unchanged.\n\nv1.0.1 | 2026-04-27T01:16:41.555Z | user\n\n- 添加了 Flyelep 开放平台注册/密钥申请链接至认证方式说明。\n- 其余文档内容保持不变。\n\nv1.0.0 | 2026-04-20T09:59:00.519Z | user\n\nInitial release of the Flyelep product color change skill.\n\n- Supports intelligent color changing of products in images via the Flyelep AI HTTP API.\n- Requires POST requests with user-provided secretKey for authentication.\n- Allows color modification using clear text prompts, supporting details like preserving material, light, or branding.\n- Supports model selection between gemini-2.5 (default) and gemini-3-pro.\n- Returns the URL of the color-changed image; does not directly process or display image content.\n- Provides guidance on prompt writing, error handling, and best practices for optimal results.\n\nArchive index:\n\nArchive v1.0.4: 3 files, 6235 bytes\n\nFiles: skill-card.md (2217b), SKILL.md (11993b), _meta.json (147b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: product-color-change\ndescription: >-\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n---\n# Flyelep 商品换色\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\n\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\n\n## API 接口信息\n\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\n- **Content-Type**: `application/json`\n- **认证方式**: 在请求头中传入 `secretKey`（密钥需由用户在 Flyelep 开放平台申请：https://www.flyelep.cn/controlboard）\n- **超时时间**: 建议 120-300 秒\n\n请求头示例：\n\n```http\nContent-Type: application/json\nsecretKey: 用户提供的API密钥\n```\n\n> **安全说明**：不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\n\n## 请求 Body\n\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 9\n}\n```\n\n## 响应格式\n\n```json\n{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}\n```\n\n- `code=200` 表示调用成功\n- `msg` 为接口返回说明\n- `data` 为换色后的图片 URL\n\n返回结果应直接展示给用户，不要回读图片内容。\n\n## 参数说明\n\n### 必传参数\n\n> **重要**：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。\n\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| sourceUrl | - | 原图链接 |\n| textPrompt | - | 换色提示词，如\"将商品颜色改为深蓝色\" |\n| modelType | 9 | 模型类型：当前仅支持传 `9`（Flyelep Image 2） |\n\n### 可选参数\n\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| prompt | - | 补充提示词，用于描述换色位置、不换色区域等，会与 `textPrompt` 拼接后一起下发 |\n| replaceImageUrl | - | 颜色参考图，最多 1 张 |\n\n### 参数映射规则\n\n**sourceUrl**：\n- 传入待换色商品的原图公网 URL\n- 必须是图片直链，不要传网页地址\n- 原图应尽量清晰展示商品主体和原始颜色\n- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数\n\n**textPrompt**：\n- 文档将其标为必需\n- 直接描述目标颜色及必要约束\n- 应尽量明确\"将什么改成什么颜色\"\n\n推荐写法示例：\n\n- `将商品颜色改为深蓝色`\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\n\n**提示词边界**：\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\n- 如果用户只是想\"更换商品\"，应改用商品替换 skill\n- 如果用户想\"换背景\"，应改用场景替换 skill\n\n**prompt**：\n- 与 `textPrompt` 是两个独立字段，服务端会把两者用中文逗号拼接后再下发\n- 适合承载\"只改哪个部位、哪些区域不要动\"这类补充约束\n- 只传 `prompt` 不传 `textPrompt` 时也能生效\n\n**modelType**：\n- 当前接口仅支持 `9`（Flyelep Image 2），必传\n- 传其他值会报「无效的模型类型」\n\n**replaceImageUrl**：\n- 可选，用于提供颜色参考图\n- 只支持 1 张，传多张会被接口拒绝，报「该操作类型最多只能上传1张图片」\n\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\n\n## 本地文件上传\n\n用户提供的是本地文件路径而不是公网直链时，先把文件上传换取直链，再调用本接口。已安装 `file-upload` 技能时以该技能为准；未安装时按下面的说明直接调用上传接口。\n\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload`\n- **请求方式**: `multipart/form-data`，文件字段名固定为 `file`，单次只能上传一个文件，多个文件并发调用多次\n- **认证方式**: 请求头传 `secretKey`，与本技能使用同一个密钥\n- **超时时间**: 图片建议 60-120 秒\n- **不要手动设置 `Content-Type` 请求头**，让 HTTP 客户端自动生成带 boundary 的值，手写会导致服务端解析失败\n- 图片仅支持 `bmp`、`gif`、`jpg`、`jpeg`、`png`，`webp` 需先转成 `png` 或 `jpg`；文件名必须带正确后缀，服务端靠它判断格式\n- 原文件名不会出现在 URL 里，中文名、空格、特殊字符都能直接上传，不需要提前改名\n- 上传不消耗算力，但服务端不做去重：同一个文件在一次任务里只上传一次，记下 `fullPath` 复用\n\n成功响应取 `data.fullPath` 作为公网直链，永久有效、不带签名：\n\n```json\n{\n \"code\": 200,\n \"msg\": null,\n \"data\": {\n \"relativePath\": \"cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png\",\n \"fullPath\": \"https://agent-1404002717.cos.ap-guangzhou.myqcloud.com/cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png\",\n \"serviceProvider\": null\n }\n}\n```\n\n判断成功只看 `code`，业务失败时 HTTP 状态码仍是 200，`code` 为 500 或 9999，原因在 `msg` 里。\n\n```bash\n# Windows/PowerShell（用 curl.exe，PowerShell 里的 curl 是 Invoke-WebRequest 的别名）\ncurl.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\"\n\n# macOS/Linux\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload\" -H \"secretKey: 你的密钥\" --max-time 120 -F \"file=@./product.png\"\n```\n\n图片入桶前会先过内容审核，审核不通过整个请求失败，需换图重试。拿到 `code=9999`、`msg` 为 `服务繁忙，请稍后再试` 时，先自查三项：是否漏了 `secretKey` 请求头、表单字段名是否为 `file`、文件是否超出服务端体积上限。密钥、格式、审核、体积类错误重试无效，只有网络超时、5xx 和存储类异常值得重试。\n\n## 调用示例\n\n> **跨平台调用说明**：\n> - 请求头必须包含 `Content-Type: application/json; charset=utf-8` 和 `secretKey`\n> - **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` 清理。\n> - **macOS/Linux**：bash/zsh 默认 UTF-8，可直接内联 JSON：`curl -X POST URL -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --data-binary 'JSON单行内容'`\n\n### 示例 1：基础商品换色\n\n**前置步骤**：向用户索取图片路径或 URL。如用户提供本地文件，先按「本地文件上传」章节换取公网直链。\n\n**Windows/PowerShell**：\n\n步骤 1：创建 `payload_temp.json`（两种方式任选其一）：\n\n方式 A（使用 Write 工具）：\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 9\n}\n```\n\n方式 B（无 Write 工具，PowerShell 执行）：\n```powershell\n[System.IO.File]::WriteAllText(\"payload_temp.json\", '{\"sourceUrl\":\"https://example.com/product_red.jpg\",\"textPrompt\":\"将商品颜色改为深蓝色\",\"modelType\":9}', [System.Text.UTF8Encoding]::new($false))\n```\n\n步骤 2：执行请求：\n```bash\ncurl.exe --% -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary @payload_temp.json\n```\n\n步骤 3：清理临时文件：\n```bash\nrm payload_temp.json\n```\n\n**macOS/Linux**：\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary '{\"sourceUrl\":\"https://example.com/product_red.jpg\",\"textPrompt\":\"将商品颜色改为深蓝色\",\"modelType\":9}'\n```\n\n### 示例 2：强调保留材质与光影的换色\n\n**前置步骤**：向用户索取图片路径或 URL。如用户提供本地文件，先按「本地文件上传」章节换取公网直链。\n\n**Windows/PowerShell**：\n\n步骤 1：创建 `payload_temp.json`（两种方式任选其一）：\n\n方式 A（使用 Write 工具）：\n```json\n{\n \"sourceUrl\": \"https://example.com/product_watch.jpg\",\n \"textPrompt\": \"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\n \"modelType\": 9\n}\n```\n\n方式 B（无 Write 工具，PowerShell 执行）：\n```powershell\n[System.IO.File]::WriteAllText(\"payload_temp.json\", '{\"sourceUrl\":\"https://example.com/product_watch.jpg\",\"textPrompt\":\"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\"modelType\":9}', [System.Text.UTF8Encoding]::new($false))\n```\n\n步骤 2：执行请求：\n```bash\ncurl.exe --% -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary @payload_temp.json\n```\n\n步骤 3：清理临时文件：\n```bash\nrm payload_temp.json\n```\n\n**macOS/Linux**：\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary '{\"sourceUrl\":\"https://example.com/product_watch.jpg\",\"textPrompt\":\"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\"modelType\":9}'\n```\n\n## 常见错误及解决方案\n\n| 错误 | 原因与解决 |\n|------|-----------|\n| HTTP 401 / `code` 非 200 | `secretKey` 无效、缺失或已过期，确认请求头是否正确传入 |\n| HTTP 405 Not Allowed | 请求方法错误，必须使用 `POST` |\n| `sourceUrl` 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |\n| `无效的模型类型` | `modelType` 不在支持范围，当前仅支持 `9` |\n| `该操作类型最多只能上传1张图片` | `replaceImageUrl` 传了多张，商品换色只接受 1 张 |\n| 换色结果偏差较大 | `textPrompt` 过于模糊，可补充目标颜色、材质观感和保留项 |\n| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |\n| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |\n\n## 执行流程\n\n1. **向用户询问 `secretKey`**（API 密钥必须由用户提供，agent 不可自行填写）\n2. 收集原图 URL（如用户提供本地文件，先按「本地文件上传」章节换取公网直链）\n3. 与用户确认换色需求，构造 `textPrompt`，`modelType` 固定填 `9`\n4. 在请求头中传入 `secretKey`，调用接口\n5. 将返回的换色结果图片 URL 直接展示给用户\n\n该接口支持 `textPrompt`，商品换色的结果高度依赖提示词描述质量。执行时应遵循：\n\n1. 明确目标颜色\n2. 明确保留项：材质、品牌标识、背景、光影、构图\n3. 避免把\"换色\"写成\"换商品\"或\"换背景\"\n4. 对多部件商品可明确指定仅修改哪个部位\n\n当用户要求\"同款不同色\"\"把红色改成蓝色\"时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1787886935121\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:\n\nUses the Flyelep AI Tool API to identify products in an image, change their color according to the user's prompt, and return the new image URL.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[flyelepai](https://clawhub.ai/user/flyelepai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agents use this skill when a user wants product images recolored while preserving the product, branding, background, composition, and other requested details.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Product images and the Flyelep API key are sent to a third-party service.\n\nMitigation: Use only with images and credentials that the user is comfortable sharing with Flyelep, and require the API key at runtime instead of storing it in files or examples.\n\nRisk: Local image uploads may create permanent unsigned public URLs without documented deletion or expiry control.\n\nMitigation: Avoid uploading confidential, personal, regulated, unreleased, or metadata-sensitive images unless the user accepts that exposure.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/flyelepai/skills/flyelep-product-color-change)\n- [Flyelep product color change API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange)\n- [Flyelep open platform control board](https://www.flyelep.cn/controlboard)\n- [Flyelep file upload API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with JSON payloads and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a user-provided Flyelep secretKey and an image URL or uploaded image URL; successful calls return a recolored image URL.]\n\n## Skill Version(s):\n\n1.0.4 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.3: 3 files, 5231 bytes\n\nFiles: skill-card.md (2592b), SKILL.md (9066b), _meta.json (147b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: product-color-change\r\ndescription: >-\r\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\r\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\r\n---\r\n# Flyelep 商品换色\r\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\r\n\r\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\r\n\r\n## API 接口信息\r\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\r\n- **Content-Type**: `application/json`\r\n- **认证方式**: 在请求头中传入 `secretKey`\r\n- **超时时间**: 建议 120-300 秒\r\n\r\n## 认证方式\r\n所有 AI 工具接口均需在请求头中传入 `secretKey`。该密钥需由用户在 Flyelep 开放平台申请获得：https://www.flyelep.cn/controlboard 。\r\n\r\n请求头示例：\r\n\r\n```http\r\nContent-Type: application/json\r\nsecretKey: 用户提供的API密钥\r\n```\r\n\r\n> **安全说明**：`secretKey` 必须放在请求头中，这是 AI 工具接口的统一鉴权要求。不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\r\n\r\n## 请求 Body\r\n```json\r\n{\r\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\r\n \"textPrompt\": \"将商品颜色改为深蓝色\",\r\n \"modelType\": 0\r\n}\r\n```\r\n\r\n## 响应格式\r\n统一响应结构：\r\n\r\n```json\r\n{\r\n \"code\": 200,\r\n \"msg\": \"操作成功\",\r\n \"data\": \"https://example.com/product_blue.jpg\"\r\n}\r\n```\r\n\r\n- `code=200` 表示调用成功\r\n- `msg` 为接口返回说明\r\n- `data` 为换色后的图片 URL\r\n\r\n返回结果应直接展示给用户，不要回读图片内容。\r\n\r\n## 参数说明\r\n### 必传参数\r\n\r\n> **重要**：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。\r\n\r\n| 字段 | 默认值 | 说明 |\r\n|------|--------|------|\r\n| sourceUrl | - | 原图链接 |\r\n| textPrompt | - | 换色提示词，如\"将商品颜色改为深蓝色\" |\r\n| modelType | - | 模型类型：无论任何情况，都默认填 `0` |\r\n\r\n## 参数映射规则\r\n### sourceUrl\r\n- 传入待换色商品的原图公网 URL\r\n- 必须是图片直链，不要传网页地址\r\n- 原图应尽量清晰展示商品主体和原始颜色\r\n\r\n### textPrompt\r\n- 文档将其标为必需\r\n- 直接描述目标颜色及必要约束\r\n- 应尽量明确“将什么改成什么颜色”\r\n\r\n推荐写法示例：\r\n\r\n- `将商品颜色改为深蓝色`\r\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\r\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\r\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\r\n\r\n### 提示词边界\r\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\r\n- 如果用户只是想“更换商品”，应改用商品替换 skill\r\n- 如果用户想“换背景”，应改用场景替换 skill\r\n\r\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\r\n\r\n## 调用示例\r\n- **重要**：调用 API 时，必须设置 `Content-Type: application/json; charset=utf-8` 请求头。以下分平台说明：\r\n- **Windows/PowerShell 环境**：\r\n - 必须采用以下流程：**先将请求体 JSON 写入当前工作目录下的临时文件 `payload_temp.json`，再通过 Shell 工具调用 `curl.exe --data-binary @payload_temp.json` 发送请求**。这是因为 PowerShell 使用 GBK 编码，而服务端使用 UTF-8 解析，直接在命令行中嵌入中文 JSON 会导致乱码。\r\n - 使用 `curl.exe`（而非 `curl`，后者在 PowerShell 中是 `Invoke-WebRequest` 的别名）。必须在 `curl.exe` 后加 `--%` 停止 PowerShell 解析，否则 `@` 会被误判为 splatting 操作符导致报错。\r\n - **文件创建方式**：根据可用工具选择其一（均需确保 UTF-8 **无 BOM** 编码，否则服务端 JSON 解析会在 position 0 报错）：\r\n - **方式 A（有 Write 工具）**：使用 Write 工具创建 `payload_temp.json`\r\n - **方式 B（无 Write 工具）**：使用 Shell 的 .NET API 创建文件（`Set-Content -Encoding UTF8` 会带 BOM，不可用）\r\n- **macOS/Linux 环境**：\r\n - bash/zsh 默认使用 UTF-8 编码，可直接内联中文 JSON，无需临时文件。命令中使用 `curl`（无需 `.exe`，无需 `--%`）。\r\n - 推荐内联写法：`curl -X POST URL -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --data-binary 'JSON单行内容'`，一步完成\r\n - 也可使用临时文件方式：`curl --data-binary @payload_temp.json`\r\n- **清理**：API 返回结果后，务必删除 `payload_temp.json` 临时文件（如使用了临时文件）。\r\n\r\n**示例 1：基础商品换色**\r\n\r\n步骤 1：创建 `payload_temp.json`，内容如下：\r\n```json\r\n{\r\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\r\n \"textPrompt\": \"将商品颜色改为深蓝色\",\r\n \"modelType\": 0\r\n}\r\n```\r\n> 方式 B（无 Write 工具）：\r\n> ```powershell\r\n> $json = '{\"sourceUrl\":\"https://example.com/product_red.jpg\",\"textPrompt\":\"将商品颜色改为深蓝色\",\"modelType\":0}'\r\n> [System.IO.File]::WriteAllText(\"payload_temp.json\", $json, [System.Text.UTF8Encoding]::new($false))\r\n> ```\r\n\r\n步骤 2：使用 Shell 工具执行：\r\n```bash\r\ncurl.exe --% -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary @payload_temp.json\r\n```\r\n\r\n> **macOS/Linux 内联写法**（无需临时文件）：\r\n> ```bash\r\n> curl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary '{\"sourceUrl\":\"https://example.com/product_red.jpg\",\"textPrompt\":\"将商品颜色改为深蓝色\",\"modelType\":0}'\r\n> ```\r\n\r\n步骤 3：清理临时文件：\r\n```bash\r\nrm payload_temp.json\r\n```\r\n\r\n**示例 2：强调保留材质与光影的换色**\r\n\r\n步骤 1：创建 `payload_temp.json`，内容如下：\r\n```json\r\n{\r\n \"sourceUrl\": \"https://example.com/product_watch.jpg\",\r\n \"textPrompt\": \"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\r\n \"modelType\": 0\r\n}\r\n```\r\n> 方式 B（无 Write 工具）：\r\n> ```powershell\r\n> $json = '{\"sourceUrl\":\"https://example.com/product_watch.jpg\",\"textPrompt\":\"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\"modelType\":0}'\r\n> [System.IO.File]::WriteAllText(\"payload_temp.json\", $json, [System.Text.UTF8Encoding]::new($false))\r\n> ```\r\n\r\n步骤 2：使用 Shell 工具执行：\r\n```bash\r\ncurl.exe --% -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary @payload_temp.json\r\n```\r\n\r\n> **macOS/Linux 内联写法**（无需临时文件）：\r\n> ```bash\r\n> curl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" -H \"Content-Type: application/json; charset=utf-8\" -H \"secretKey: 你的密钥\" --max-time 300 --data-binary '{\"sourceUrl\":\"https://example.com/product_watch.jpg\",\"textPrompt\":\"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\"modelType\":0}'\r\n> ```\r\n\r\n步骤 3：清理临时文件：\r\n```bash\r\nrm payload_temp.json\r\n```\r\n\r\n## 常见错误及解决方案\r\n| 错误 | 原因与解决 |\r\n|------|-----------|\r\n| HTTP 401 / `code` 非 200 | `secretKey` 无效、缺失或已过期，确认请求头是否正确传入 |\r\n| HTTP 405 Not Allowed | 请求方法错误，必须使用 `POST` |\r\n| `sourceUrl` 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |\r\n| `modelType` 非 0 | 模型类型只支持 `0` |\r\n| 换色结果偏差较大 | `textPrompt` 过于模糊，可补充目标颜色、材质观感和保留项 |\r\n| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |\r\n| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |\r\n\r\n## 提示词处理\r\n该接口支持 `textPrompt`，商品换色的结果高度依赖提示词描述质量。\r\n\r\n执行时应遵循：\r\n\r\n1. 明确目标颜色\r\n2. 明确保留项：材质、品牌标识、背景、光影、构图\r\n3. 避免把“换色”写成“换商品”或“换背景”\r\n4. 对多部件商品可明确指定仅修改哪个部位\r\n\r\n当用户要求“同款不同色”“把红色改成蓝色”时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。\n\nFile v1.0.3:_meta.json\n\n{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.3\",\n \"publishedAt\": 1786083310871\n}\n\nFile v1.0.3:skill-card.md\n\n## Description:\n\nUses the Flyelep AI Tool API to identify a product in an image and generate a new image URL with the product color changed while preserving the product.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[flyelepai](https://clawhub.ai/user/flyelepai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill when they need an agent to collect a product image URL, color-change prompt, and Flyelep API key, call Flyelep's product color-change endpoint, and return the resulting image URL.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Product image URLs, prompts, and the Flyelep API key are sent to a third-party Flyelep service.\n\nMitigation: Install and use the skill only after confirming that this data sharing is acceptable for the intended products, prompts, and account.\n\nRisk: The Flyelep secretKey may be exposed if stored in skill files, persistent configuration, temporary payloads, or shell history.\n\nMitigation: Provide the key only at runtime through secure secret handling where available, avoid committing or saving real keys, and remove any temporary payload file after the API call.\n\nRisk: Color-change output can be inaccurate when the prompt is vague or the source image does not clearly show the product and target area.\n\nMitigation: Use a clear public image URL and a specific prompt that names the target color, preserved materials, background, brand marks, lighting, and any product parts that should not change.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/flyelepai/skills/flyelep-product-color-change)\n- [Flyelep product color-change API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange)\n- [Flyelep open platform controlboard](https://www.flyelep.cn/controlboard)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, guidance]\n\n**Output Format:** [Markdown guidance with JSON request bodies, shell command examples, and a returned image URL.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a user-provided public source image URL, color-change prompt, modelType 0, and Flyelep secretKey at runtime.]\n\n## Skill Version(s):\n\n1.0.3 (source: server-resolved release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.2: 3 files, 4153 bytes\n\nFiles: skill-card.md (2572b), SKILL.md (5320b), _meta.json (147b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: product-color-change\ndescription: >-\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n---\n# Flyelep 商品换色\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\n\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\n\n## API 接口信息\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\n- **Content-Type**: `application/json`\n- **认证方式**: 在请求头中传入 `secretKey`\n- **超时时间**: 建议 120-300 秒\n\n## 认证方式\n所有 AI 工具接口均需在请求头中传入 `secretKey`。该密钥需由用户在 Flyelep 开放平台申请获得：https://www.flyelep.cn/controlboard 。\n\n请求头示例：\n\n```http\nContent-Type: application/json\nsecretKey: 用户提供的API密钥\n```\n\n> **安全说明**：`secretKey` 必须放在请求头中，这是 AI 工具接口的统一鉴权要求。不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\n\n## 请求 Body\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 0\n}\n```\n\n## 响应格式\n统一响应结构：\n\n```json\n{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}\n```\n\n- `code=200` 表示调用成功\n- `msg` 为接口返回说明\n- `data` 为换色后的图片 URL\n\n返回结果应直接展示给用户，不要回读图片内容。\n\n## 参数说明\n### 必传参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| sourceUrl | - | 原图链接 |\n| modelType | - | 模型类型：`0=gemini-2.5`，`1=gemini-3-pro` |\n\n### 推荐传入参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| textPrompt | - | 换色提示词，如“将商品颜色改为深蓝色” |\n\n## 参数映射规则\n### sourceUrl\n- 传入待换色商品的原图公网 URL\n- 必须是图片直链，不要传网页地址\n- 原图应尽量清晰展示商品主体和原始颜色\n\n### modelType\n- `0`：`gemini-2.5`\n- `1`：`gemini-3-pro`\n\n推荐默认规则：\n\n- 用户未指定模型时，默认传 `0`\n\n### textPrompt\n- 文档将其标为必需\n- 直接描述目标颜色及必要约束\n- 应尽量明确“将什么改成什么颜色”\n\n推荐写法示例：\n\n- `将商品颜色改为深蓝色`\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\n\n### 提示词边界\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\n- 如果用户只是想“更换商品”，应改用商品替换 skill\n- 如果用户想“换背景”，应改用场景替换 skill\n\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\n\n## 调用示例\n**基础商品换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 1\n }'\n```\n\n**强调保留材质与光影的换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_watch.jpg\",\n \"textPrompt\": \"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\n \"modelType\": 1\n }'\n```\n\n## 常见错误及解决方案\n| 错误 | 原因与解决 |\n|------|-----------|\n| HTTP 401 / `code` 非 200 | `secretKey` 无效、缺失或已过期，确认请求头是否正确传入 |\n| HTTP 405 Not Allowed | 请求方法错误，必须使用 `POST` |\n| `sourceUrl` 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |\n| `modelType` 非 0/1 | 模型类型只支持 `0` 或 `1` |\n| 换色结果偏差较大 | `textPrompt` 过于模糊，可补充目标颜色、材质观感和保留项 |\n| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |\n| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |\n\n## 提示词处理\n该接口支持 `textPrompt`，商品换色的结果高度依赖提示词描述质量。\n\n执行时应遵循：\n\n1. 明确目标颜色\n2. 明确保留项：材质、品牌标识、背景、光影、构图\n3. 避免把“换色”写成“换商品”或“换背景”\n4. 对多部件商品可明确指定仅修改哪个部位\n\n当用户要求“同款不同色”“把红色改成蓝色”时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1777262298035\n}\n\nFile v1.0.2:skill-card.md\n\n## Description:
\nUses the Flyelep AI Tool API to identify products in images and generate new images with changed product colors while keeping the product otherwise unchanged.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[flyelepai](https://clawhub.ai/user/flyelepai)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill when they need an agent to recolor a product image through Flyelep's HTTP API while preserving product identity, material appearance, logos, background, lighting, and composition.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The Flyelep secretKey could be exposed if hard-coded, logged, or stored in generated files.
\nMitigation: Collect the secretKey at runtime, pass it only in the HTTP request header, and avoid persisting it in skill files, examples, repositories, or durable configuration.
\nRisk: Product images and prompts are sent to Flyelep's service for processing.
\nMitigation: Use only product images and prompts that the user is comfortable sharing with Flyelep.
\nRisk: Color-change results may alter unintended regions or drift from the requested appearance when prompts or source images are unclear.
\nMitigation: Use clear product image URLs and prompts that specify the target color and any elements to preserve, such as logos, background, materials, lighting, and composition.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/flyelepai/flyelep-product-color-change)
\n- [Flyelep Product Color Change API Endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange)
\n- [Flyelep Open Platform](https://www.flyelep.cn/controlboard)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration, Text]
\n**Output Format:** [Markdown with JSON and shell command examples, plus a resulting image URL when the API call succeeds]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a runtime Flyelep secretKey, a public image URL, a color-change prompt, and modelType 0 or 1.]
\n\n## Skill Version(s):
\n1.0.2 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.1: 2 files, 2834 bytes\n\nFiles: SKILL.md (5319b), _meta.json (147b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: product-color-change\ndescription: >-\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n---\n# Flyelep 商品换色\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\n\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\n\n## API 接口信息\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\n- **Content-Type**: `application/json`\n- **认证方式**: 在请求头中传入 `secretKey`\n- **超时时间**: 建议 120-300 秒\n\n## 认证方式\n所有 AI 工具接口均需在请求头中传入 `secretKey`。该密钥需由用户在 Flyelep 开放平台申请获得：https://www.flyelep.cn/controlboard。\n\n请求头示例：\n\n```http\nContent-Type: application/json\nsecretKey: 用户提供的API密钥\n```\n\n> **安全说明**：`secretKey` 必须放在请求头中，这是 AI 工具接口的统一鉴权要求。不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\n\n## 请求 Body\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 0\n}\n```\n\n## 响应格式\n统一响应结构：\n\n```json\n{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}\n```\n\n- `code=200` 表示调用成功\n- `msg` 为接口返回说明\n- `data` 为换色后的图片 URL\n\n返回结果应直接展示给用户，不要回读图片内容。\n\n## 参数说明\n### 必传参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| sourceUrl | - | 原图链接 |\n| modelType | - | 模型类型：`0=gemini-2.5`，`1=gemini-3-pro` |\n\n### 推荐传入参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| textPrompt | - | 换色提示词，如“将商品颜色改为深蓝色” |\n\n## 参数映射规则\n### sourceUrl\n- 传入待换色商品的原图公网 URL\n- 必须是图片直链，不要传网页地址\n- 原图应尽量清晰展示商品主体和原始颜色\n\n### modelType\n- `0`：`gemini-2.5`\n- `1`：`gemini-3-pro`\n\n推荐默认规则：\n\n- 用户未指定模型时，默认传 `0`\n\n### textPrompt\n- 文档将其标为必需\n- 直接描述目标颜色及必要约束\n- 应尽量明确“将什么改成什么颜色”\n\n推荐写法示例：\n\n- `将商品颜色改为深蓝色`\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\n\n### 提示词边界\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\n- 如果用户只是想“更换商品”，应改用商品替换 skill\n- 如果用户想“换背景”，应改用场景替换 skill\n\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\n\n## 调用示例\n**基础商品换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 1\n }'\n```\n\n**强调保留材质与光影的换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_watch.jpg\",\n \"textPrompt\": \"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\n \"modelType\": 1\n }'\n```\n\n## 常见错误及解决方案\n| 错误 | 原因与解决 |\n|------|-----------|\n| HTTP 401 / `code` 非 200 | `secretKey` 无效、缺失或已过期，确认请求头是否正确传入 |\n| HTTP 405 Not Allowed | 请求方法错误，必须使用 `POST` |\n| `sourceUrl` 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |\n| `modelType` 非 0/1 | 模型类型只支持 `0` 或 `1` |\n| 换色结果偏差较大 | `textPrompt` 过于模糊，可补充目标颜色、材质观感和保留项 |\n| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |\n| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |\n\n## 提示词处理\n该接口支持 `textPrompt`，商品换色的结果高度依赖提示词描述质量。\n\n执行时应遵循：\n\n1. 明确目标颜色\n2. 明确保留项：材质、品牌标识、背景、光影、构图\n3. 避免把“换色”写成“换商品”或“换背景”\n4. 对多部件商品可明确指定仅修改哪个部位\n\n当用户要求“同款不同色”“把红色改成蓝色”时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1777252601555\n}\n\nArchive v1.0.0: 2 files, 2820 bytes\n\nFiles: SKILL.md (5281b), _meta.json (147b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: product-color-change\ndescription: >-\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n---\n# Flyelep 商品换色\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\n\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\n\n## API 接口信息\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\n- **Content-Type**: `application/json`\n- **认证方式**: 在请求头中传入 `secretKey`\n- **超时时间**: 建议 120-300 秒\n\n## 认证方式\n所有 AI 工具接口均需在请求头中传入 `secretKey`。该密钥需由用户在 Flyelep 开放平台申请获得。\n\n请求头示例：\n\n```http\nContent-Type: application/json\nsecretKey: 用户提供的API密钥\n```\n\n> **安全说明**：`secretKey` 必须放在请求头中，这是 AI 工具接口的统一鉴权要求。不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\n\n## 请求 Body\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 0\n}\n```\n\n## 响应格式\n统一响应结构：\n\n```json\n{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}\n```\n\n- `code=200` 表示调用成功\n- `msg` 为接口返回说明\n- `data` 为换色后的图片 URL\n\n返回结果应直接展示给用户，不要回读图片内容。\n\n## 参数说明\n### 必传参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| sourceUrl | - | 原图链接 |\n| modelType | - | 模型类型：`0=gemini-2.5`，`1=gemini-3-pro` |\n\n### 推荐传入参数\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| textPrompt | - | 换色提示词，如“将商品颜色改为深蓝色” |\n\n## 参数映射规则\n### sourceUrl\n- 传入待换色商品的原图公网 URL\n- 必须是图片直链，不要传网页地址\n- 原图应尽量清晰展示商品主体和原始颜色\n\n### modelType\n- `0`：`gemini-2.5`\n- `1`：`gemini-3-pro`\n\n推荐默认规则：\n\n- 用户未指定模型时，默认传 `0`\n\n### textPrompt\n- 文档将其标为必需\n- 直接描述目标颜色及必要约束\n- 应尽量明确“将什么改成什么颜色”\n\n推荐写法示例：\n\n- `将商品颜色改为深蓝色`\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\n\n### 提示词边界\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\n- 如果用户只是想“更换商品”，应改用商品替换 skill\n- 如果用户想“换背景”，应改用场景替换 skill\n\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\n\n## 调用示例\n**基础商品换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 1\n }'\n```\n\n**强调保留材质与光影的换色：**\n\n```bash\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange\" \\\n -H \"Content-Type: application/json\" \\\n -H \"secretKey: 你的密钥\" \\\n --max-time 300 \\\n -d '{\n \"sourceUrl\": \"https://example.com/product_watch.jpg\",\n \"textPrompt\": \"将表带改为深棕色皮革观感，保留金属表盘和整体光影不变\",\n \"modelType\": 1\n }'\n```\n\n## 常见错误及解决方案\n| 错误 | 原因与解决 |\n|------|-----------|\n| HTTP 401 / `code` 非 200 | `secretKey` 无效、缺失或已过期，确认请求头是否正确传入 |\n| HTTP 405 Not Allowed | 请求方法错误，必须使用 `POST` |\n| `sourceUrl` 无法访问 | 原图 URL 不是公网直链、已过期，或源站限制访问 |\n| `modelType` 非 0/1 | 模型类型只支持 `0` 或 `1` |\n| 换色结果偏差较大 | `textPrompt` 过于模糊，可补充目标颜色、材质观感和保留项 |\n| 局部也被错误换色 | 原图主体边界不清晰，可换更干净的源图或在提示词里强调保留范围 |\n| 请求超时 | 图片较大或处理复杂时，可适当增大超时时间 |\n\n## 提示词处理\n该接口支持 `textPrompt`，商品换色的结果高度依赖提示词描述质量。\n\n执行时应遵循：\n\n1. 明确目标颜色\n2. 明确保留项：材质、品牌标识、背景、光影、构图\n3. 避免把“换色”写成“换商品”或“换背景”\n4. 对多部件商品可明确指定仅修改哪个部位\n\n当用户要求“同款不同色”“把红色改成蓝色”时，优先使用此技能；如果用户想替换为完全不同的商品，应改用商品替换 skill。\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1776679140519\n}","readmeExcerpt":"Skill: product-color-change Owner: flyelepai Summary: 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-08-28T03:15:35.121Z | user - Updated API parameter modelType to require value 9 (was previously 0); only 9 is now supported. - Added optional parameters: prompt (for supplementary instructions) and replaceImageUrl (for color reference im","codeSnippets":[],"executableExamples":[{"language":"http","snippet":"Content-Type: application/json\nsecretKey: 用户提供的API密钥"},{"language":"json","snippet":"{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 9\n}"},{"language":"json","snippet":"{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}"},{"language":"json","snippet":"{\n \"code\": 200,\n \"msg\": null,\n \"data\": {\n \"relativePath\": \"cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png\",\n \"fullPath\": \"https://agent-1404002717.cos.ap-guangzhou.myqcloud.com/cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png\",\n \"serviceProvider\": null\n }\n}"},{"language":"bash","snippet":"curl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload\" -H \"secretKey: 你的密钥\" --max-time 120 -F \"file=@./product.png\""},{"language":"bash","snippet":"# Windows/PowerShell（用 curl.exe，PowerShell 里的 curl 是 Invoke-WebRequest 的别名）\ncurl.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\"\n\n# macOS/Linux\ncurl -X POST \"https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload\" -H \"secretKey: 你的密钥\" --max-time 120 -F \"file=@./product.png\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: product-color-change\ndescription: >-\n 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。\n 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。\n---\n# Flyelep 商品换色\n通过 Flyelep AI Tool API 对图片中的商品进行换色处理，并返回换色后的新图片 URL。\n\n**重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。**\n\n## API 接口信息\n\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange`\n- **Content-Type**: `application/json`\n- **认证方式**: 在请求头中传入 `secretKey`（密钥需由用户在 Flyelep 开放平台申请：https://www.flyelep.cn/controlboard）\n- **超时时间**: 建议 120-300 秒\n\n请求头示例：\n\n```http\nContent-Type: application/json\nsecretKey: 用户提供的API密钥\n```\n\n> **安全说明**：不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。\n\n## 请求 Body\n\n```json\n{\n \"sourceUrl\": \"https://example.com/product_red.jpg\",\n \"textPrompt\": \"将商品颜色改为深蓝色\",\n \"modelType\": 9\n}\n```\n\n## 响应格式\n\n```json\n{\n \"code\": 200,\n \"msg\": \"操作成功\",\n \"data\": \"https://example.com/product_blue.jpg\"\n}\n```\n\n- `code=200` 表示调用成功\n- `msg` 为接口返回说明\n- `data` 为换色后的图片 URL\n\n返回结果应直接展示给用户，不要回读图片内容。\n\n## 参数说明\n\n### 必传参数\n\n> **重要**：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。\n\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| sourceUrl | - | 原图链接 |\n| textPrompt | - | 换色提示词，如\"将商品颜色改为深蓝色\" |\n| modelType | 9 | 模型类型：当前仅支持传 `9`（Flyelep Image 2） |\n\n### 可选参数\n\n| 字段 | 默认值 | 说明 |\n|------|--------|------|\n| prompt | - | 补充提示词，用于描述换色位置、不换色区域等，会与 `textPrompt` 拼接后一起下发 |\n| replaceImageUrl | - | 颜色参考图，最多 1 张 |\n\n### 参数映射规则\n\n**sourceUrl**：\n- 传入待换色商品的原图公网 URL\n- 必须是图片直链，不要传网页地址\n- 原图应尽量清晰展示商品主体和原始颜色\n- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数\n\n**textPrompt**：\n- 文档将其标为必需\n- 直接描述目标颜色及必要约束\n- 应尽量明确\"将什么改成什么颜色\"\n\n推荐写法示例：\n\n- `将商品颜色改为深蓝色`\n- `把包包主体颜色改为奶油白，保留金属扣件颜色不变`\n- `将耳机外壳换成哑光黑色，保持材质质感与光影不变`\n- `把杯身改为浅绿色，保留品牌标识和背景不变`\n\n**提示词边界**：\n- 优先描述颜色，不要把换色需求扩写成换材质或换商品\n- 如果用户只是想\"更换商品\"，应改用商品替换 skill\n- 如果用户想\"换背景\"，应改用场景替换 skill\n\n**prompt**：\n- 与 `textPrompt` 是两个独立字段，服务端会把两者用中文逗号拼接后再下发\n- 适合承载\"只改哪个部位、哪些区域不要动\"这类补充约束\n- 只传 `prompt` 不传 `textPrompt` 时也能生效\n\n**modelType**：\n- 当前接口仅支持 `9`（Flyelep Image 2），必传\n- 传其他值会报「无效的模型类型」\n\n**replaceImageUrl**：\n- 可选，用于提供颜色参考图\n- 只支持 1 张，传多张会被接口拒绝，报「该操作类型最多只能上传1张图片」\n\n> **说明**：场景替换、商品替换、商品换色三个接口共用同一 DTO，由接口内部自动设置 `type` 字段，调用方无需传入 `type`。\n\n## 本地文件上传\n\n用户提供的是本地文件路径而不是公网直链时，先把文件上传换取直链，再调用本接口。已安装 `file-upload` 技能时以该技能为准；未安装时按下面的说明直接调用上传接口。\n\n- **URL**: `POST https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload`\n- **请求方式**: `multipart/form-data`，文件字段名固定为 `file`，单次只能上传一个文件，多个文件并发调用多次\n- **认证方式**: 请求头传 `secretKey`，与本技能使用同一个密钥\n- **超时时间**: 图片建议 60-120 秒\n- **不要手动设置 `Content-Type` 请求头**，让 HTTP 客户端自动生成带 boundary 的值，手写会导致服务端解析失败\n- 图片仅支持 `bmp`、`gif`、`jpg`、`jpeg`、`png`，`webp` 需先转成 `png` 或 `jpg`；文件名必须带正确后缀，服务端靠它判断格式\n- 原文件名不会出现在 URL 里，中文名、空格、特殊字符都能直接上传，不需要提前改名\n- 上传不消耗算力，但服务端不做去重：同一个文件在一次任务里只上传一次，记下 `fullPath` 复用\n\n成功响应取 `data.fullPath` 作为公网直链，永久有效、不带签名：\n\n```json\n{\n \"code\": 200,\n \"msg\": null,\n \"data\": {\n \"relativePath\": \"cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png\",\n \"fullPath\": \"https://agent-1404002717.cos.ap-guangzhou.myqcloud.com/cos_ai_agent/2026-08-11/3f2a9c1b7d84"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7fp1zsg4nwdq826y0awapkks84fkq1\",\n \"slug\": \"flyelep-product-color-change\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1787886935121\n}"},{"path":"skill-card.md","content":"## Description:\n\nUses the Flyelep AI Tool API to identify products in an image, change their color according to the user's prompt, and return the new image URL.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[flyelepai](https://clawhub.ai/user/flyelepai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agents use this skill when a user wants product images recolored while preserving the product, branding, background, composition, and other requested details.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Product images and the Flyelep API key are sent to a third-party service.\n\nMitigation: Use only with images and credentials that the user is comfortable sharing with Flyelep, and require the API key at runtime instead of storing it in files or examples.\n\nRisk: Local image uploads may create permanent unsigned public URLs without documented deletion or expiry control.\n\nMitigation: Avoid uploading confidential, personal, regulated, unreleased, or metadata-sensitive images unless the user accepts that exposure.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/flyelepai/skills/flyelep-product-color-change)\n- [Flyelep product color change API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productColorChange)\n- [Flyelep open platform control board](https://www.flyelep.cn/controlboard)\n- [Flyelep file upload API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown with JSON payloads and shell command examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a user-provided Flyelep secretKey and an image URL or uploaded image URL; successful calls return a recolored image URL.]\n\n## Skill Version(s):\n\n1.0.4 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Skill: product-color-change Owner: flyelepai Summary: 通过 Flyelep AI 工具接口智能识别图片中的商品并进行换色处理。 当用户要求修改商品颜色、保持商品不变只换配色、生成同款不同颜色展示图时使用此技能。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-08-28T03:15:35.121Z | user - Updated API parameter modelType to require value 9 (was previously 0); only 9 is now supported. - Added optional parameters: prompt (for supplementary instructions) and replaceImageUrl (for color reference im","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1055,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T05:41:53.966Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T07:43:32.442Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}