agentCLAWHUBUnverified
scene-replace
通过 Flyelep AI 工具接口将图片中的背景场景替换为指定场景，可结合参考图和文本提示词精准控制效果。 当用户要求更换背景场景、替换商品展示环境、保留主体改场景时使用此技能。 Skill: scene-replace Owner: flyelepai Summary: 通过 Flyelep AI 工具接口将图片中的背景场景替换为指定场景，可结合参考图和文本提示词精准控制效果。 当用户要求更换背景场景、替换商品展示环境、保留主体改场景时使用此技能。 Tags: latest:1.0.4 Version history: v1.0.4 | 2026-08-28T03:14:56.862Z | user - Updated required parameter modelType default value from 0 to 9 (Flyelep Image 2 is now required). - Clarified that only one image is allowed for replaceImageUrl; passing multiple images is now an error.
OpenClaw
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 11, 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.2K downloads reported by the source. Last updated 10/11/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 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.4release · observed Aug 28, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s175rfkzzv81fcfhp65sjggxa984fmry:flyelep-scene-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-scene-replace/snapshot"
Documentation
CLAWHUB
29,512 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: scene-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/sceneReplace`
- **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/product.jpg",
"replaceImageUrl": "https://example.com/scene.jpg",
"modelType": 9,
"textPrompt": "将场景替换成我上传的图片"
}
```
## 响应格式
```json
{
"code": 200,
"msg": "操作成功",
"data": "https://example.com/scene_replaced.jpg"
}
```
- `code=200` 表示调用成功
- `msg` 为接口返回说明
- `data` 为场景替换后的图片 URL
返回结果应直接展示给用户，不要回读图片内容。
## 参数说明
### 必传参数
> **重要**：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。
| 字段 | 类型 | 是否必需 | 默认值 | 说明 |
|------|------|----------|--------|------|
| sourceUrl | String | 是 | - | 原图链接 |
| modelType | Integer | 是 | 9 | 当前仅支持传 `9`：Flyelep Image 2 |
| textPrompt | String | 是 | - | 用户提示词，描述目标场景 |
| replaceImageUrl | String | 否 | - | 场景参考图链接，暂时只支持单图 |
### 参数映射规则
**sourceUrl**：
- 传入待替换场景的原图公网 URL
- 必须是图片直链，不要传网页地址
- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数
**modelType**：
- 当前接口仅支持 `9`（Flyelep Image 2），必传
- 传其他值会报「无效的模型类型」
**textPrompt**：
- 用自然语言描述目标场景，如风格、环境、光线、氛围、陈列方式
- 有参考图时用于补充约束（如「将场景替换成我上传的图片」），无参考图时由文字单独控制目标场景
- 不传时接口会退化为默认提示词「替换场景」，效果不可控，因此实际调用应始终传入
**replaceImageUrl**：
- 可选参数，用于提供目标场景参考图
- 暂时只支持单图，传入多张（逗号分隔）会被接口拒绝，报「该操作类型最多只能上传1张图片」
- 不传时仅靠 `textPrompt` 生成目标场景
- 如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数
> **说明**：场景替换、商品替换、商品换色三个接口共用同一 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，`code` 为 500 或 9999，原因在 `msg` 里。
```bash
# Windows/PowerShell（用 curl.exe，PowerShell 里的_meta.json
{
"ownerId": "kn7fp1zsg4nwdq826y0awapkks84fkq1",
"slug": "flyelep-scene-replace",
"version": "1.0.4",
"publishedAt": 1787886896862
}skill-card.md
## Description: Uses the Flyelep AI Tool API to replace the background scene in an image with a specified scene, optionally guided by a reference image and text prompt. 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 replace product or subject backgrounds while preserving the main subject. It is suited for product display scenes, background replacement workflows, and guided scene changes using public image URLs or uploaded local images. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Local images may be uploaded to a permanent public URL. Mitigation: Use only images approved for external upload, avoid private or regulated content, and confirm the user understands that uploaded image URLs may remain accessible. Risk: Flyelep API keys may be exposed through shell command examples, logs, or command history. Mitigation: Use revocable keys, provide credentials only at runtime, avoid hard-coding keys in files, and rotate any key that may have been logged. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/flyelepai/skills/flyelep-scene-replace) - [Flyelep control board](https://www.flyelep.cn/controlboard) - [Flyelep scene replacement API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/aiTool/sceneReplace) - [Flyelep file upload API endpoint](https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, guidance] **Output Format:** [Markdown with HTTP request examples and returned image URLs] **Output Parameters:** [1D] **Other Properties Related to Output:** [The skill returns or presents a URL for the generated scene-replaced image and may include upload or API-call instructions.] ## Skill Version(s): 1.0.4 (source: server release evidence) ## 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
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/flyelepai/skills/flyelep-scene-replace",
"sourceUrl": "https://clawhub.ai/flyelepai/skills/flyelep-scene-replace",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T01:41:08.302Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-scene-replace/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-scene-replace/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T01:41:08.302Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceUrl": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T01:41:08.302Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.4",
"href": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceUrl": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T03:14:56.862Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-scene-replace/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-flyelepai-flyelep-scene-replace/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.4",
"description": "- Updated required parameter `modelType` default value from `0` to `9` (Flyelep Image 2 is now required). - Clarified that only one image is allowed for `replaceImageUrl`; passing multiple images is now an error. - Added instructions and samples for uploading local files to obtain public links before calling the main API. - Improved error case documentation, especially regarding model type and multi-image issues. - Removed deprecated information and streamlined parameter/usage tables for clarity. - Removed the `skill-card.md` file.",
"href": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceUrl": "https://clawhub.ai/flyelepai/flyelep-scene-replace",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-08-28T03:14:56.862Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.