← Back to Skills Marketplace
LinkFoxAI
by
linkfox-ai
· GitHub ↗
· v1.3.0
· MIT-0
220
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install linkfox-ai
Description
调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。
README (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/WAN2_7/SEEDREAM5] [--template 白底图]` | 智能修图 |\r
| `erase --image-url \x3Curl> --mask-url \x3Curl>` | 消除笔 |\r
| `sales-video --prompt "口播文案" --video-type WAN\|SEED [--image-list \x3Curl1> \x3Curl2>] [--video-time 10] [--aspect-ratio 9:16] [--is-pro]` | 带货口播（WAN: 10/15秒, SEED: 5/10/15秒） |\r
| `image-to-video --image-url \x3Curl> --video-type SEED [--prompt "描述"] [--video-time 10] [--is-pro] [--aspect-ratio 9:16]` | 图转视频（KLING/V/WAN/SEED/HAILUO） |\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
| 图转视频 | `/linkfox-ai/image/v2/make/imageToVideo` |\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. **带货口播(SEED)**：「用 LinkFoxAI 生成一条 SEED 15 秒口播视频」→ `sales-video --wait --video-type SEED --video-time 15 --prompt "..."`\r
7. **图转视频**：「用 LinkFoxAI 把这张图生成 SEED 视频」→ `image-to-video --wait --image-url \x3Curl> --video-type SEED --video-time 10`\r
8. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id \x3Cid>`\r
Usage Guidance
This skill appears to do exactly what it says: call LinkFox AI image/video APIs, upload images, and poll for results. Before installing: (1) Only provide an API key you trust (LINKFOXAI_API_KEY); the script also supports APP_ID/APP_SECRET if you prefer that auth method. (2) Be aware the tool can read local image files when you run upload-base64 — don’t point it at sensitive files. (3) The skill can be pointed at custom base URLs or a proxy (the docs mention a proxy host and an IP to whitelist); only use those if you trust the proxy. (4) The skill makes outbound network requests to the LinkFox endpoints; verify those endpoints are acceptable for your environment. If you need tighter guarantees, ask the publisher for a signed provenance or run the bundled script in a sandbox first.
Capability Analysis
Type: OpenClaw Skill
Name: linkfox-ai
Version: 1.3.0
The LinkFoxAI skill bundle provides a legitimate interface for interacting with the LinkFox AI platform's image and video generation APIs. The core script, `scripts/linkfoxai.py`, uses standard Python libraries to perform authenticated HTTP requests and includes functionality for file uploads and task polling, all of which are consistent with its stated purpose. No evidence of malicious intent, data exfiltration, or unauthorized execution was found.
Capability Assessment
Purpose & Capability
Name/description match the provided files and the script implements the advertised image/video creation, upload, polling and generic api-call functionality. Required env var LINKFOXAI_API_KEY is appropriate for the described API access.
Instruction Scope
SKILL.md confines runtime actions to calling LinkFox endpoints and optionally reading local image files for base64 upload. It recommends using sessions_spawn for long-running tasks. Note: the script supports reading additional environment variables (LINKFOXAI_APP_ID, LINKFOXAI_APP_SECRET, LINKFOXAI_BASE_URL, LINKFOXAI_IMAGE_EDIT_PATH) that are not listed in the skill metadata; this is a benign capability but worth noting.
Install Mechanism
No install spec; instruction-only plus a bundled Python script. Nothing is downloaded from external URLs during install.
Credentials
Declared required env var is LINKFOXAI_API_KEY which is appropriate. The script also accepts LINKFOXAI_APP_ID and LINKFOXAI_APP_SECRET (alternative auth) and optional LINKFOXAI_BASE_URL / LINKFOXAI_IMAGE_EDIT_PATH overrides; these additional env vars are reasonable but were not declared in the registry metadata.
Persistence & Privilege
Skill is not always-enabled and does not request elevated platform privileges. It does not modify other skills or system-wide configs; it only performs network calls when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install linkfox-ai - After installation, invoke the skill by name or use
/linkfox-ai - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.0
LinkFoxAI 1.3.0
- 新增“图转视频”AI 能力（脚本命令 image-to-video、api 路径 /linkfox-ai/image/v2/make/imageToVideo）
- 带货口播 sales-video 命令支持 SEED 模型与更多时长选项（5/10/15 秒）
- image-edit 智能修图命令支持新 provider（WAN2_7）
- 官方说明文档和口令示例同步更新，覆盖图转视频、SEED 视频生成等新能力
- skill 描述、能力列表等相关内容更新补充
v1.2.3
- 支持 image-edit 命令指定更多 provider（BANANA_PRO/WAN2_6/SEEDREAM5）。
- 文档同步更新，image-edit 增加多模型参数说明。
- 其余功能保持兼容，未引入破坏性变更。
v1.2.1
Initial release of LinkFoxAI for OpenClaw:
- Provides LinkFox AI image/video API integration for tasks like model changing, automatic matting, scene expansion, image super-resolution, smart retouching, batch image generation, pose fission, and e-commerce video.
- Supports AI task creation and polling, universal API calling with custom payloads, and material list retrieval for connectivity tests.
- Includes mandatory sessions_spawn-based queueing to handle async image tasks, with robust timeout/long task handling strategies.
- Offers both shortcut commands (e.g., change-model, cutout, image-edit, sales-video) and general-purpose api-call for full API coverage.
- Detailed usage guidelines, error handling advice, and integration samples provided in documentation.
Metadata
Frequently Asked Questions
What is LinkFoxAI?
调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 It is an AI Agent Skill for Claude Code / OpenClaw, with 220 downloads so far.
How do I install LinkFoxAI?
Run "/install linkfox-ai" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is LinkFoxAI free?
Yes, LinkFoxAI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does LinkFoxAI support?
LinkFoxAI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created LinkFoxAI?
It is built and maintained by linkfox-ai (@linkfox-ai); the current version is v1.3.0.
More Skills