← 返回 Skills 市场
361
总下载
1
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install linkfoxai
功能描述
调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。
使用说明 (SKILL.md)
\r \r
LinkFoxAI - LinkFox AI 开放平台 Skill\r
\r LinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播等。\r \r
配置\r
\r
- 获取凭证：注册 紫鸟开放平台，认证开发者并创建 LinkFox 卖家应用，然后在 linkfox.com/team/api-guide 将应用绑定到团队，获取 API Key。\r
- 环境变量：
LINKFOXAI_API_KEY（单一 API Key，配置一个 Key 即可调用全部接口）\r - 自定义 Base URL（可选）：默认
https://sbappstoreapi.ziniao.com/openapi-router。若无固定 IP，设置LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com并配置白名单。\r \r
必须使用 sessions_spawn 调度作图任务\r
\r
AI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟）。务必通过 sessions_spawn 将作图任务派发到子会话，让主会话保持响应。脚本的 --wait 参数会自动轮询直到出结果。\r
\r
超时处理策略（AI 自行判断）\r
\r
当作图任务超时（--timeout 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r
\r
- 延长轮询时间：将
--timeout增大到 1800（30 分钟），--interval建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r - 告知用户并继续后台等待：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r
- 任务分拆重试：若任务参数含多图（如
--output-num 4），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r - 放弃并报错：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r \r
默认建议：将
sessions_spawn的runTimeoutSeconds设为 1800，--timeout设为 1700，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r \r
标准调度模板\r
\r
sessions_spawn:\r
task: |\r
Run: \x3Cskill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\r
--image-url "\x3C模特原图>" --head-url "\x3C头部图>" --output-num 4\r
解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r
如果 status=4（失败），报告 errorMsg。\r
如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r
label: "LinkFoxAI: AI 换模特"\r
mode: "run"\r
runTimeoutSeconds: 1800\r
cleanup: "keep"\r
```\r
\r
### 并行调度多个独立任务\r
\r
```\r
# 子任务 1\r
sessions_spawn:\r
task: "Run: \x3Cskill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '\x3Curl>' --sub-type 1 ..."\r
label: "LinkFoxAI: 自动抠图"\r
mode: "run"\r
runTimeoutSeconds: 1800\r
\r
# 子任务 2\r
sessions_spawn:\r
task: "Run: \x3Cskill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '\x3Curl>' ..."\r
label: "LinkFoxAI: 场景裂变"\r
mode: "run"\r
runTimeoutSeconds: 1800\r
```\r
\r
### 通用接口调用（api-call）\r
\r
对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r
\r
```\r
sessions_spawn:\r
task: |\r
Run: \x3Cskill>/scripts/linkfoxai.py api-call \\r
--path /linkfox-ai/image/v2/make/fittingRoom \\r
--body '{"upperOriginUrl":"\x3C上衣图>","modelImageUrl":"\x3C模特图>","outputNum":2}'\r
获取返回的 data.id，然后运行：\r
\x3Cskill>/scripts/linkfoxai.py poll --id \x3Ctask_id> --timeout 1700\r
解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r
label: "LinkFoxAI: AI 穿衣"\r
mode: "run"\r
runTimeoutSeconds: 1800\r
```\r
\r
## 脚本命令一览\r
\r
### 基础命令\r
\r
| 命令 | 说明 |\r
|------|------|\r
| `material-list --type \x3C1-10>` | 作图素材列表（可用于连通性测试） |\r
| `upload-base64 --file \x3C路径>` | base64 上传图片，返回 viewUrl |\r
| `make-info --id \x3C任务ID>` | 查询作图结果（单次） |\r
| `poll --id \x3C任务ID> [--interval 3] [--timeout 300]` | 轮询作图结果直到成功/失败 |\r
| `refresh --id \x3C图片ID> [--format jpg]` | 刷新结果图片地址（注意是图片 ID，非任务 ID） |\r
| `api-call --path \x3C路径> --body '\x3CJSON>'` | 通用 API 调用，可调任意开放平台接口 |\r
\r
### 作图快捷命令（均支持 `--wait`）\r
\r
| 命令 | 说明 |\r
|------|------|\r
| `change-model --image-url \x3Curl> --head-url \x3Curl> [--scene-url \x3Curl>] [--output-num 1-4]` | AI 换模特 |\r
| `cutout --image-url \x3Curl> --sub-type \x3C1/2/3/9/12/13> [--cloth-class tops,coat,...]` | 自动抠图 |\r
| `scene-fission --image-url \x3Curl> [--strength 0.5] [--prompt "描述"] [--provider SCENE_FISSION_REALISTIC]` | 场景裂变 |\r
| `expand-image --image-url \x3Curl> --width 1024 --height 1024 [--prompt "描述"]` | 智能扩图 |\r
| `super-resolution --image-url \x3Curl> --magnification 2 [--enhance]` | 图片高清放大 |\r
| `image-edit --image-url \x3Curl> --prompt "描述" [--provider BANANA_PRO] [--template 白底图]` | 智能修图 |\r
| `erase --image-url \x3Curl> --mask-url \x3Curl>` | 消除笔 |\r
| `sales-video --prompt "口播文案" --video-type WAN [--image-list \x3Curl1> \x3Curl2>] [--video-time 10] [--aspect-ratio 9:16]` | 带货口播（WAN: 10/15秒） |\r
\r
所有作图快捷命令均支持 `--wait [--timeout 300] [--interval 3]`，提交任务后自动轮询直到完成。\r
\r
### 其他能力（通过 api-call 调用）\r
\r
以下能力通过 `api-call --path \x3C路径> --body '\x3CJSON>'` 调用，接口详情见 `references/image-make.md`：\r
\r
| 能力 | 路径 |\r
|------|------|\r
| AI 换模特 2.0 | `/linkfox-ai/image/v2/make/changeModelFixed` |\r
| 模特换场景 | `/linkfox-ai/image/v2/make/modelChangeScene` |\r
| AI 穿衣-上下装 | `/linkfox-ai/image/v2/make/fittingRoom` |\r
| AI 穿衣-连体衣 | `/linkfox-ai/image/v2/make/fittingRoomSuit` |\r
| AI 穿戴 | `/linkfox-ai/image/v2/make/intelligentWear` |\r
| 商品替换 | `/linkfox-ai/image/v2/make/shopReplace` |\r
| 场景图生成 | `/linkfox-ai/image/v2/make/aiDraw` |\r
| 相似图裂变 | `/linkfox-ai/image/v2/make/imageToImage` |\r
| 精细抠图-创建 | `/linkfox-ai/v2/process/result/interactCutout/create` |\r
| 精细抠图-结果 | `/linkfox-ai/v2/process/result/interactCutout/info` |\r
| 图片翻译 | `/linkfox-ai/image/v3/make/imageTransl` |\r
| 手部修复 | `/linkfox-ai/image/v2/make/handRepair` |\r
| 局部重绘 | `/linkfox-ai/image/v2/make/areaRepair` |\r
| 印花提取 | `/linkfox-ai/image/v2/make/printExtract` |\r
| 手持商品 | `/linkfox-ai/image/v2/make/handHeld` |\r
| 饰品文字 | `/linkfox-ai/image/v2/make/linkedWord` |\r
| 商品精修 | `/linkfox-ai/image/v2/make/productRepair` |\r
| 图片获取描述词-创建 | `/linkfox-ai/v2/process/result/imageToPrompt/create` |\r
| 图片获取描述词-结果 | `/linkfox-ai/v2/process/result/imageToPrompt/info` |\r
| 智能修图 | `/linkfox-ai/image/v2/make/imageEditV2` |\r
| 智能修图-多图 | `/linkfox-ai/image/v2/make/multiImageFusionV2` |\r
| 商品套图 | `/linkfox-ai/image/v2/make/productMarketMaterialV3` |\r
| 服装套图 | `/linkfox-ai/image/v2/make/wearCollectionV2` |\r
| 姿势裂变 | `/linkfox-ai/image/v2/make/modelPoseFission` |\r
| 带货口播 | `/linkfox-ai/image/v2/make/salesVideo` |\r
\r
## 连通性测试\r
\r
使用作图素材接口验证凭证和网络是否正常（无需上传图片）：\r
\r
```bash\r
\x3Cskill>/scripts/linkfoxai.py material-list --type 1\r
```\r
\r
或对 OpenClaw 说：「用 LinkFoxAI 拉取作图素材列表」。\r
\r
## 错误处理\r
\r
- 错误码（如 ERR_FORBIDDEN、ERR_NOT_HAVE_TEAM_PRIVILEGE、TEAM_PERMISSION_EXPIRE）见 `references/open-platform.md`。\r
- 需先将应用绑定团队且团队已开通套餐。\r
- 作图任务失败时 `status=4`，检查 `errorCode` 和 `errorMsg`。\r
- 常见问题：参数校验失败（ERR_FILED_VALIDATE）、图片审核不通过（ERR_IMAGE_MAKE_AUDIT）、点数不足（ERR_IMAGE_MAKE_WILL_OUT）。\r
- 若调用新增能力，需使用对应 V2/V3 路径，否则可能出现参数不兼容或能力不可用。\r
\r
## 参考文档\r
\r
- `references/open-platform.md` — 接入流程、API 基础地址、错误码\r
- `references/image-make.md` — 全部作图接口及带货口播接口的完整参数与注意事项\r
\r
## 示例\r
\r
1. **连通性**：「用 LinkFoxAI 拉取作图素材列表」→ 脚本执行 `material-list --type 1`\r
2. **AI 换模特**：「用 LinkFoxAI 做一次 AI 换模特，原图 xxx，头部图 xxx，出 4 张」→ `change-model --wait --output-num 4`\r
3. **自动抠图**：「用 LinkFoxAI 把这张图抠图」→ `cutout --wait --sub-type 1`\r
4. **智能修图**：「用 LinkFoxAI 把这张图改成白底图」→ `image-edit --wait --prompt "白底图" --template 白底图`（高质量：加 `--provider BANANA_PRO`）\r
5. **带货口播**：「用 LinkFoxAI 生成一条 10 秒带货口播视频，竖版」→ `sales-video --wait --video-type WAN --video-time 10 --aspect-ratio 9:16 --prompt "..."`\r
6. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id \x3Cid>`\r
安全使用建议
This skill appears to do exactly what it says: call LinkFox AI image/video APIs. Before installing, consider: (1) Only provide a LinkFox API credential you trust — images you upload are sent to the third-party service and may contain sensitive data; (2) the CLI can read local files for base64 upload (upload-base64), so avoid running that command on sensitive files; (3) the api-call command lets the agent call arbitrary LinkFox endpoints, so limit the credential's permissions if possible; (4) the code also accepts APP_ID/APP_SECRET and optional BASE_URL overrides (these are supported but not emphasized in SKILL.md); and (5) metadata/version fields in the package have minor inconsistencies (cosmetic). If you need stricter guarantees, review the full script and the LinkFox platform privacy/security terms, and consider using a dedicated service account with minimal privileges.
功能分析
Type: OpenClaw Skill
Name: linkfoxai
Version: 1.0.2
The linkfoxai skill bundle is a legitimate integration for the LinkFox AI platform, providing tools for AI image and video processing. The Python script (linkfoxai.py) uses standard libraries to interact with documented API endpoints and handles authentication via environment variables (LINKFOXAI_API_KEY). The instructions in SKILL.md are well-structured, focusing on task scheduling and error handling without any signs of prompt injection or malicious intent.
能力评估
Purpose & Capability
Name/description match the provided code and SKILL.md: the package is a client for LinkFox AI image/video APIs and exposes commands for creating tasks, polling results, uploading images, and issuing arbitrary platform calls. All required network targets and flows relate to the stated purpose.
Instruction Scope
SKILL.md instructs the agent to spawn long-running sessions for asynchronous image generation, to poll results, and to optionally upload local images (base64). Those behaviors are appropriate for this API client, but be aware the skill can read local files when you run the upload-base64 command and can issue arbitrary platform endpoints via api-call.
Install Mechanism
No install spec or external downloads are present; the skill is instruction + included Python script. That minimizes install-time risk (no archive fetches or package installs).
Credentials
SKILL.md declares LINKFOXAI_API_KEY only, which is proportionate. The script also supports alternative credentials (LINKFOXAI_APP_ID and LINKFOXAI_APP_SECRET) and optional overrides (LINKFOXAI_BASE_URL, LINKFOXAI_IMAGE_EDIT_PATH). This is reasonable but the documentation should mention the APP_ID/APP_SECRET options to avoid surprise.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no install-time persistence. It runs as an invoked skill or via sessions_spawn as documented.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install linkfoxai - 安装完成后，直接呼叫该 Skill 的名称或使用
/linkfoxai触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.2
- 新增对 LinkFox AI 带货口播视频能力支持，统一支持作图/视频全接口。
- 作图快捷命令新增 sales-video（带货口播）指令及参数说明。
- SKILL 说明所有适用场景扩展为图像/视频 AI 能力。
- 命令与示例文档均加入带货口播相关内容。
- 通用调用与标准模板等部分未改动，用法保持兼容上一个版本。
v1.0.1
**Changelog for linkfoxai 1.0.1**
- 移除 AI 会话/对话相关功能和文档说明，精简为仅支持 AI 作图相关能力。
- 删除 `references/ai-chat.md` 文件，去除 AI 对话接口参考文档。
- 更新说明文档，突出支持的作图类接口与相关命令，去除非作图类用法示例。
- 对支持 API 路径和描述进行了微调，补充部分接口从 V2/V3 路径等升级说明。
- 增加“若调用新增能力需用新路径，否则可能参数不兼容”等使用须知。
v1.0.0
LinkFoxAI 1.0.0
- 首次发布，覆盖 LinkFox AI 开放平台全部 36 种 AI 作图与 AI 会话接口。
- 支持换模特、抠图、扩图、场景裂变、智能修图等多种图片处理能力。
- 提供作图任务排队、超时自动处理和后台轮询等完整作图调度流程。
- 支持通过 api-call 灵活调用任意平台开放接口。
- 详细命令与标准调度模板，易于快速集成和验证连通性。
- 丰富错误处理说明和实用调用示例。
元数据
常见问题
LinkFoxAI 是什么？
调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 361 次。
如何安装 LinkFoxAI？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install linkfoxai」即可一键安装，无需额外配置。
LinkFoxAI 是免费的吗？
是的，LinkFoxAI 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
LinkFoxAI 支持哪些平台？
LinkFoxAI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 LinkFoxAI？
由 Brave Lin（@xxxx3）开发并维护，当前版本 v1.0.2。
推荐 Skills