What makes product-replace notable?

1.4K downloads. Trust evidence available

How should product-replace be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

product-replace

通过 Flyelep AI 工具接口将图片中的商品替换为指定商品图，同时保留原图背景及光影效果。当用户要求替换商品主体、保留原场景换产品、保持背景不变更换展示商品时使用此技能。 Skill: product-replace Owner: flyelepai Summary: 通过 Flyelep AI 工具接口将图片中的商品替换为指定商品图，同时保留原图背景及光影效果。当用户要求替换商品主体、保留原场景换产品、保持背景不变更换展示商品时使用此技能。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-08-28T03:16:06.145Z | user - 支持本地图片文件上传，自动换取公网直链，无需用户自行上传图片。 - 接口参数 modelType 更新为仅支持 9（Flyelep Image 2），不再使用 0。 - replaceImageUrl 现最多支持 3 张图片，多角度图用英文逗号分隔，超过 3 张会报错。 - 新增详细的本地文件上传说明，包括支持的图片格式、上传方法、错误处理等。 - 明确了调用流程和参数收集，更加规范高效。 - 移除

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

1.0.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.4release · observed Aug 28, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s175rfkzzv81fcfhp65sjggxa984fmry:flyelep-product-replace

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: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-product-replace/snapshot"

Documentation

CLAWHUB

32,959 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: product-replace
description: >-
  通过 Flyelep AI 工具接口将图片中的商品替换为指定商品图，同时保留原图背景及光影效果。
  当用户要求替换商品主体、保留原场景换产品、保持背景不变更换展示商品时使用此技能。
---
# Flyelep 商品替换
通过 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/productReplace`
- **Content-Type**: `application/json`
- **认证方式**: 在请求头中传入 `secretKey`（密钥需由用户在 Flyelep 开放平台申请：https://www.flyelep.cn/controlboard）
- **超时时间**: 建议 120-300 秒

请求头示例：

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

> **安全说明**：不要将真实密钥写入技能文件、示例代码仓库或持久化配置中，应在运行时由用户动态提供。

## 请求 Body

```json
{
  "sourceUrl": "https://example.com/scene_with_old_product.jpg",
  "replaceImageUrl": "https://example.com/new_product.jpg",
  "modelType": 9,
  "textPrompt": "保留背景和光影，将主体商品替换为新的白色保温杯"
}
```

## 响应格式

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

- `code=200` 表示调用成功
- `msg` 为接口返回说明
- `data` 为商品替换后的图片 URL

返回结果应直接展示给用户，不要回读图片内容。

## 参数说明

### 必传参数

> **重要**：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。

| 字段 | 默认值 | 说明 |
|------|--------|------|
| sourceUrl | - | 原图链接，包含原始商品的图片 |
| replaceImageUrl | - | 目标商品图链接，最多 3 张，多张用英文逗号分隔 |
| textPrompt | - | 用户提示词 |
| modelType | 9 | 模型类型：当前仅支持传 `9`（Flyelep Image 2） |

### 参数映射规则

**sourceUrl**：
- 传入待替换商品的原图公网 URL
- 必须是图片直链，不要传网页地址
- 原图中应清楚包含待替换商品和原背景环境
- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数

**replaceImageUrl**：
- 用于提供目标商品图
- 最多 3 张，多张用英文逗号 `,` 拼接；超过 3 张接口报「产品替换最多只能上传3张图片」
- 同一商品的多角度图一起传，有助于模型还原商品细节
- 当用户明确说"把原商品换成另一件商品"时，优先传入该字段
- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数

**textPrompt**：
- 用于补充替换要求，例如材质、颜色、角度、尺寸观感、保留方式
- 可用于强调"保留原场景、保留光影、保留构图"
- 不传时接口会退化为默认提示词「替换商品」，实际调用应始终传入

**modelType**：
- 当前接口仅支持 `9`（Flyelep Image 2），必传
- 传其他值会报「无效的模型类型」

推荐写法示例：

- `保留背景和桌面反光，将商品替换为黑色蓝牙耳机`
- `保持原场景与阴影效果，将主体换成白色保温杯`
- `保留背景展台不变，将中间产品替换为新的香水瓶，风格保持高级简洁`

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

## 本地文件上传

用户提供的是本地文件路径而不是公网直链时，先把文件上传换取直链，再调用本接口。已安装 `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` 作为公网直链，永久有效、不带签名：

```json
{
  "code": 200,
  "msg": null,
  "data": {
    "relativePath": "cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png",
    "fullPath": "https://agent-1404002717.cos.ap-guangzhou.myqcloud.com/cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png",
    "serviceProvider": null
  }
}
```

判断成功只看 `code`，业务失败时 HTTP 状态码仍是 200，

_meta.json

{
  "ownerId": "kn7fp1zsg4nwdq826y0awapkks84fkq1",
  "slug": "flyelep-product-replace",
  "version": "1.0.4",
  "publishedAt": 1787886966145
}

skill-card.md

## Description:

Uses the Flyelep AI Tool API to replace the product in an image with target product imagery while preserving the original scene, background, lighting, and composition.

This skill is ready for commercial/non-commercial use.

## Publisher:

[flyelepai](https://clawhub.ai/user/flyelepai)

### License/Terms of Use:

MIT-0

## Use Case:

External users and developers use this skill to collect an original product scene, up to three replacement product image URLs, a text prompt, and a Flyelep secretKey, then call Flyelep's product replacement API. The skill returns the generated product-replaced image URL directly to the user.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The workflow sends user images, prompts, and a Flyelep secretKey to Flyelep, and uploaded local images become permanent public URLs.

Mitigation: Use only images and keys approved for Flyelep processing, and do not upload confidential, personal, regulated, or unreleased product images unless permanent public URLs are acceptable.

Risk: A Flyelep secretKey can be exposed in chat, logs, shell history, temporary payload files, or tool output.

Mitigation: Collect the key at runtime, avoid persisting it in examples or configuration, redact it from outputs, clean temporary files after use, and rotate the key if exposure is suspected.

Risk: The product replacement request can fail or produce poor results when image URLs are not public direct links, replacement images exceed the three-image limit, or source/reference images are unclear.

Mitigation: Confirm public direct image URLs before calling the API, limit replacement references to three images, and ask the user for clearer images or a more specific prompt when the expected product or scene preservation is ambiguous.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/flyelepai/skills/flyelep-product-replace)
- [Flyelep product replacement API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/productReplace)
- [Flyelep file upload API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload)
- [Flyelep controlboard](https://www.flyelep.cn/controlboard)

## Skill Output:

**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]

**Output Format:** [Markdown guidance with JSON request bodies and shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Returns a public URL for the generated product-replaced image; local image uploads may create permanent public image URLs.]

## Skill Version(s):

1.0.4 (source: evidence.release.version)

## Ethical Considerations:

Users 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.

Github ReposUpdated 1d agoRank 70

AionUi

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!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

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

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular