{"id":"4f6f478c-86ae-480f-bb62-30b12d4f1f89","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-ai","name":"LinkFoxAI","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-ai","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-ai","generatedAt":"2026-10-09T19:38:26.312Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T12:02:50.605Z","emptyReason":null},"description":"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Skill: LinkFoxAI Owner: linkfox-ai Summary: 调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Tags: latest:1.5.1 Version history: v1.5.1 | 2026-06-12T06:15:20.181Z | user 新增：视频复刻 video-reclone，支持 SEED、SEED_FAST 两个模型进行视频复刻生成。 调整：商品套图/服装套图支持「无字模式」--no-text，生成纯画面、不带文案排版。 调整：图转视频/带货口播新增支持SEED_FAST模型生成 v1.5.0 | 2026-05-07T12:44:16.506Z | u","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.7K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ai","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-ai","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-ai","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-ai","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-ai","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":43,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Skill: LinkFoxAI Owner: li"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:02:50.605Z","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-09T12:02:50.605Z","emptyReason":null},"stars":null,"forks":null,"downloads":2708,"packageName":null,"latestVersion":"1.5.1","tractionLabel":"2.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:02:50.605Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T12:02:50.605Z","lastCrawledAt":"2026-10-09T12:02:50.605Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T12:02:50.605Z","lastVerifiedAt":null,"highlights":[{"version":"1.5.1","createdAt":"2026-06-12T06:15:20.181Z","changelog":"新增：视频复刻 video-reclone，支持 SEED、SEED_FAST 两个模型进行视频复刻生成。 调整：商品套图/服装套图支持「无字模式」--no-text，生成纯画面、不带文案排版。 调整：图转视频/带货口播新增支持SEED_FAST模型生成","fileCount":6,"zipByteSize":27785},{"version":"1.5.0","createdAt":"2026-05-07T12:44:16.506Z","changelog":"linkfox-ai v1.5.0 - 商品套图/服装套图 — 新增 WAN2_7 和 GPT_2_IMAGE（低/中/高三档品质）模型 - 智能修图（image-edit） — 新增 WAN2_7、SEEDREAM5、GPT_2_IMAGE、AIDRAW_EDIT provider - 图转视频（image-to-video）快捷命令参数补充，支持 `--voice`、`--camera`、`--prompt-optimizer` 等高级选项（具体参数详见 references/image-make.md）。 - 文档中对 image-to-video 的模型参数说明更详细，方便使用不同视频模型能力。 - 其余说明文档保持一致，无功能变动。","fileCount":6,"zipByteSize":24053},{"version":"1.3.0","createdAt":"2026-04-09T13:22:41.544Z","changelog":"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 描述、能力列表等相关内容更新补充","fileCount":5,"zipByteSize":21937},{"version":"1.2.3","createdAt":"2026-04-07T05:44:27.998Z","changelog":"- 支持 image-edit 命令指定更多 provider（BANANA_PRO/WAN2_6/SEEDREAM5）。 - 文档同步更新，image-edit 增加多模型参数说明。 - 其余功能保持兼容，未引入破坏性变更。","fileCount":5,"zipByteSize":21144},{"version":"1.2.1","createdAt":"2026-03-29T03:18:18.824Z","changelog":"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.","fileCount":5,"zipByteSize":20718}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ai","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-linkfox-ai-linkfox-ai/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/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-09T19:38:26.308Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ai/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-09T12:02:50.605Z","emptyReason":null},"readme":"Skill: LinkFoxAI\n\nOwner: linkfox-ai\n\nSummary: 调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\n\nTags: latest:1.5.1\n\nVersion history:\n\nv1.5.1 | 2026-06-12T06:15:20.181Z | user\n\n新增：视频复刻 video-reclone，支持 SEED、SEED_FAST 两个模型进行视频复刻生成。\n调整：商品套图/服装套图支持「无字模式」--no-text，生成纯画面、不带文案排版。\n调整：图转视频/带货口播新增支持SEED_FAST模型生成\n\nv1.5.0 | 2026-05-07T12:44:16.506Z | user\n\nlinkfox-ai v1.5.0\n- 商品套图/服装套图 — 新增 WAN2_7 和 GPT_2_IMAGE（低/中/高三档品质）模型\n- 智能修图（image-edit） — 新增 WAN2_7、SEEDREAM5、GPT_2_IMAGE、AIDRAW_EDIT provider\n- 图转视频（image-to-video）快捷命令参数补充，支持 `--voice`、`--camera`、`--prompt-optimizer` 等高级选项（具体参数详见 references/image-make.md）。\n- 文档中对 image-to-video 的模型参数说明更详细，方便使用不同视频模型能力。\n- 其余说明文档保持一致，无功能变动。\n\nv1.3.0 | 2026-04-09T13:22:41.544Z | user\n\nLinkFoxAI 1.3.0\n\n- 新增“图转视频”AI 能力（脚本命令 image-to-video、api 路径 /linkfox-ai/image/v2/make/imageToVideo）\n- 带货口播 sales-video 命令支持 SEED 模型与更多时长选项（5/10/15 秒）\n- image-edit 智能修图命令支持新 provider（WAN2_7）\n- 官方说明文档和口令示例同步更新，覆盖图转视频、SEED 视频生成等新能力\n- skill 描述、能力列表等相关内容更新补充\n\nv1.2.3 | 2026-04-07T05:44:27.998Z | user\n\n- 支持 image-edit 命令指定更多 provider（BANANA_PRO/WAN2_6/SEEDREAM5）。\n- 文档同步更新，image-edit 增加多模型参数说明。\n- 其余功能保持兼容，未引入破坏性变更。\n\nv1.2.1 | 2026-03-29T03:18:18.824Z | user\n\nInitial release of LinkFoxAI for OpenClaw:\n\n- 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.\n- Supports AI task creation and polling, universal API calling with custom payloads, and material list retrieval for connectivity tests.\n- Includes mandatory sessions_spawn-based queueing to handle async image tasks, with robust timeout/long task handling strategies.\n- Offers both shortcut commands (e.g., change-model, cutout, image-edit, sales-video) and general-purpose api-call for full API coverage.\n- Detailed usage guidelines, error handling advice, and integration samples provided in documentation.\n\nArchive index:\n\nArchive v1.5.1: 6 files, 27785 bytes\n\nFiles: _meta.json (129b), references/image-make.md (40025b), references/open-platform.md (2433b), scripts/linkfoxai.py (38188b), skill-card.md (2867b), SKILL.md (13428b)\n\nFile v1.5.1:SKILL.md\n\n---\r\nname: linkfoxai\r\ndescription: \"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🦊\",\"requires\":{\"env\":[\"LINKFOXAI_API_KEY\"]}}}\r\n---\r\n\r\n# LinkFoxAI - LinkFox AI 开放平台 Skill\r\n\r\nLinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播、图转视频等。\r\n\r\n## 配置\r\n\r\n1. **获取凭证**：注册 [紫鸟开放平台](https://open.ziniao.com)，认证开发者并创建 LinkFox 卖家应用，然后在 [linkfox.com/team/api-guide](https://www.linkfox.com/team/api-guide) 将应用绑定到团队，获取 API Key。\r\n2. **环境变量**：`LINKFOXAI_API_KEY`（单一 API Key，配置一个 Key 即可调用全部接口）\r\n3. **自定义 Base URL**（可选）：默认 `https://sbappstoreapi.ziniao.com/openapi-router`。若无固定 IP，设置 `LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com` 并配置白名单。\r\n\r\n## 必须使用 sessions_spawn 调度作图任务\r\n\r\nAI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，**极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟**）。**务必通过 `sessions_spawn` 将作图任务派发到子会话**，让主会话保持响应。脚本的 `--wait` 参数会自动轮询直到出结果。\r\n\r\n### 超时处理策略（AI 自行判断）\r\n\r\n当作图任务超时（`--timeout` 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r\n\r\n1. **延长轮询时间**：将 `--timeout` 增大到 1800（30 分钟），`--interval` 建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r\n2. **告知用户并继续后台等待**：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r\n3. **任务分拆重试**：若任务参数含多图（如 `--output-num 4`），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r\n4. **放弃并报错**：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r\n\r\n> 默认建议：将 `sessions_spawn` 的 `runTimeoutSeconds` 设为 **1800**，`--timeout` 设为 **1700**，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r\n\r\n### 标准调度模板\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\\r\n         --image-url \"<模特原图>\" --head-url \"<头部图>\" --output-num 4\r\n    解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r\n    如果 status=4（失败），报告 errorMsg。\r\n    如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 换模特\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n  cleanup: \"keep\"\r\n```\r\n\r\n### 并行调度多个独立任务\r\n\r\n```\r\n# 子任务 1\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '<url>' --sub-type 1 ...\"\r\n  label: \"LinkFoxAI: 自动抠图\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n\r\n# 子任务 2\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '<url>' ...\"\r\n  label: \"LinkFoxAI: 场景裂变\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n### 通用接口调用（api-call）\r\n\r\n对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py api-call \\\r\n         --path /linkfox-ai/image/v2/make/fittingRoom \\\r\n         --body '{\"upperOriginUrl\":\"<上衣图>\",\"modelImageUrl\":\"<模特图>\",\"outputNum\":2}'\r\n    获取返回的 data.id，然后运行：\r\n    <skill>/scripts/linkfoxai.py poll --id <task_id> --timeout 1700\r\n    解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 穿衣\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n## 脚本命令一览\r\n\r\n### 基础命令\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `material-list --type <1-10>` | 作图素材列表（可用于连通性测试） |\r\n| `upload-base64 --file <路径>` | base64 上传图片，返回 viewUrl |\r\n| `make-info --id <任务ID>` | 查询作图结果（单次） |\r\n| `poll --id <任务ID> [--interval 3] [--timeout 300]` | 轮询作图结果直到成功/失败 |\r\n| `refresh --id <图片ID> [--format jpg]` | 刷新结果图片地址（注意是图片 ID，非任务 ID） |\r\n| `api-call --path <路径> --body '<JSON>'` | 通用 API 调用，可调任意开放平台接口 |\r\n\r\n### 作图快捷命令（均支持 `--wait`）\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `change-model --image-url <url> --head-url <url> [--scene-url <url>] [--output-num 1-4]` | AI 换模特 |\r\n| `cutout --image-url <url> --sub-type <1/2/3/9/12/13> [--cloth-class tops,coat,...]` | 自动抠图 |\r\n| `scene-fission --image-url <url> [--strength 0.5] [--prompt \"描述\"] [--provider SCENE_FISSION_REALISTIC]` | 场景裂变 |\r\n| `expand-image --image-url <url> --width 1024 --height 1024 [--prompt \"描述\"]` | 智能扩图 |\r\n| `super-resolution --image-url <url> --magnification 2 [--enhance]` | 图片高清放大 |\r\n| `image-edit --image-url <url> --prompt \"描述\" [--provider BANANA_PRO/WAN2_7/SEEDREAM5] [--template 白底图]` | 智能修图 |\r\n| `erase --image-url <url> --mask-url <url>` | 消除笔 |\r\n| `sales-video --prompt \"口播文案\" --video-type SEED [--image-list <url1> <url2>] [--video-time 10] [--aspect-ratio 9:16] [--is-pro] [--resolution 720p]` | 带货口播（SORA/WAN/SEED/SEED_FAST/HAPPY_HORSE）。resolution：SEED 480p/720p/1080p, SEED_FAST 480p/720p, HAPPY_HORSE 720p/1080p |\r\n| `image-to-video --image-url <url> --video-type SEED [--image-list <url1> <url2>] [--prompt \"描述\"] [--video-time 10] [--resolution 720p] [--aspect-ratio 9:16] [--voice] [--camera single] [--prompt-optimizer]` | 图转视频（KLING/V/WAN/SEED/SEED_FAST/HAILUO/HAPPY_HORSE）。支持多图模式（--image-list），各模型参数详见 references/image-make.md |\r\n| `video-reclone --ref-video-url <url> --ref-image-list <url1> <url2> --video-type SEED --duration 10 --resolution 720P --sale-country CN --target-language zh [--ratio 9:16] [--product-info \"商品信息\"]` | 视频复刻（SEED/SEED_FAST）。参考视频+商品图AI复刻生成新视频。resolution/saleCountry/targetLanguage必填 |\r\n| `product-material --image-list <url1> [<url2>...] --seller-point \"卖点\" [--provider BANANA_PRO] [--a-plus-num 2] [--seller-type-num 2] [--scene-type-num 1] [--close-up-type-num 1] [--white-bg-type-num 1] [--resolution 2K] [--no-text]` | 商品套图V3（A+/卖点/场景/特写/白底，各类型最大12）。--no-text 开启无字模式 |\r\n| `wear-collection --image-list <url1> [<url2>...] --seller-point \"卖点\" [--provider BANANA_PRO] [--a-plus-num 2] [--model-type-num 2] [--ins-type-num 1] [--seller-type-num 1] [--size-type-num 1] [--white-type-num 1] [--resolution 2K] [--no-text]` | 服装套图V2（A+/模特/种草/卖点/尺码/白底，各类型最大12）。--no-text 开启无字模式 |\r\n\r\n所有作图快捷命令均支持 `--wait [--timeout 300] [--interval 3]`，提交任务后自动轮询直到完成。\r\n\r\n### 其他能力（通过 api-call 调用）\r\n\r\n以下能力通过 `api-call --path <路径> --body '<JSON>'` 调用，接口详情见 `references/image-make.md`：\r\n\r\n| 能力 | 路径 |\r\n|------|------|\r\n| AI 换模特 2.0 | `/linkfox-ai/image/v2/make/changeModelFixed` |\r\n| 模特换场景 | `/linkfox-ai/image/v2/make/modelChangeScene` |\r\n| AI 穿衣-上下装 | `/linkfox-ai/image/v2/make/fittingRoom` |\r\n| AI 穿衣-连体衣 | `/linkfox-ai/image/v2/make/fittingRoomSuit` |\r\n| AI 穿戴 | `/linkfox-ai/image/v2/make/intelligentWear` |\r\n| 商品替换 | `/linkfox-ai/image/v2/make/shopReplace` |\r\n| 场景图生成 | `/linkfox-ai/image/v2/make/aiDraw` |\r\n| 相似图裂变 | `/linkfox-ai/image/v2/make/imageToImage` |\r\n| 精细抠图-创建 | `/linkfox-ai/v2/process/result/interactCutout/create` |\r\n| 精细抠图-结果 | `/linkfox-ai/v2/process/result/interactCutout/info` |\r\n| 图片翻译 | `/linkfox-ai/image/v3/make/imageTransl` |\r\n| 手部修复 | `/linkfox-ai/image/v2/make/handRepair` |\r\n| 局部重绘 | `/linkfox-ai/image/v2/make/areaRepair` |\r\n| 印花提取 | `/linkfox-ai/image/v2/make/printExtract` |\r\n| 手持商品 | `/linkfox-ai/image/v2/make/handHeld` |\r\n| 饰品文字 | `/linkfox-ai/image/v2/make/linkedWord` |\r\n| 商品精修 | `/linkfox-ai/image/v2/make/productRepair` |\r\n| 图片获取描述词-创建 | `/linkfox-ai/v2/process/result/imageToPrompt/create` |\r\n| 图片获取描述词-结果 | `/linkfox-ai/v2/process/result/imageToPrompt/info` |\r\n| 智能修图 | `/linkfox-ai/image/v2/make/imageEditV2` |\r\n| 智能修图-多图 | `/linkfox-ai/image/v2/make/multiImageFusionV2` |\r\n| 商品套图 | 已有快捷命令 `product-material`（也可用 api-call） |\r\n| 服装套图 | 已有快捷命令 `wear-collection`（也可用 api-call） |\r\n| 姿势裂变 | `/linkfox-ai/image/v2/make/modelPoseFission` |\r\n| 带货口播 | `/linkfox-ai/image/v2/make/salesVideo` |\r\n| 图转视频 | `/linkfox-ai/image/v2/make/imageToVideo` |\r\n\r\n## 连通性测试\r\n\r\n使用作图素材接口验证凭证和网络是否正常（无需上传图片）：\r\n\r\n```bash\r\n<skill>/scripts/linkfoxai.py material-list --type 1\r\n```\r\n\r\n或对 OpenClaw 说：「用 LinkFoxAI 拉取作图素材列表」。\r\n\r\n## 错误处理\r\n\r\n- 错误码（如 ERR_FORBIDDEN、ERR_NOT_HAVE_TEAM_PRIVILEGE、TEAM_PERMISSION_EXPIRE）见 `references/open-platform.md`。\r\n- 需先将应用绑定团队且团队已开通套餐。\r\n- 作图任务失败时 `status=4`，检查 `errorCode` 和 `errorMsg`。\r\n- 常见问题：参数校验失败（ERR_FILED_VALIDATE）、图片审核不通过（ERR_IMAGE_MAKE_AUDIT）、点数不足（ERR_IMAGE_MAKE_WILL_OUT）。\r\n- 若调用新增能力，需使用对应 V2/V3 路径，否则可能出现参数不兼容或能力不可用。\r\n\r\n## 参考文档\r\n\r\n- `references/open-platform.md` — 接入流程、API 基础地址、错误码\r\n- `references/image-make.md` — 全部作图接口及带货口播接口的完整参数与注意事项\r\n\r\n## 示例\r\n\r\n1. **连通性**：「用 LinkFoxAI 拉取作图素材列表」→ 脚本执行 `material-list --type 1`\r\n2. **AI 换模特**：「用 LinkFoxAI 做一次 AI 换模特，原图 xxx，头部图 xxx，出 4 张」→ `change-model --wait --output-num 4`\r\n3. **自动抠图**：「用 LinkFoxAI 把这张图抠图」→ `cutout --wait --sub-type 1`\r\n4. **智能修图**：「用 LinkFoxAI 把这张图改成白底图」→ `image-edit --wait --prompt \"白底图\" --template 白底图`（高质量：加 `--provider BANANA_PRO`）\r\n5. **带货口播**：「用 LinkFoxAI 生成一条 10 秒带货口播视频，竖版」→ `sales-video --wait --video-type WAN --video-time 10 --aspect-ratio 9:16 --prompt \"...\"`\r\n6. **带货口播(SEED)**：「用 LinkFoxAI 生成一条 SEED 15 秒口播视频」→ `sales-video --wait --video-type SEED --video-time 15 --prompt \"...\"`\r\n7. **图转视频**：「用 LinkFoxAI 把这张图生成 SEED 视频」→ `image-to-video --wait --image-url <url> --video-type SEED --video-time 10`\r\n8. **商品套图**：「用 LinkFoxAI 生成商品套图，2张A+、2张卖点图、1张场景图」→ `product-material --wait --image-list <url> --seller-point \"轻量透气运动鞋\" --provider BANANA_PRO --a-plus-num 2 --seller-type-num 2 --scene-type-num 1`\r\n9. **服装套图**：「用 LinkFoxAI 生成服装套图，含模特图和种草图」→ `wear-collection --wait --image-list <url> --seller-point \"时尚连衣裙\" --provider BANANA_PRO --model-type-num 2 --ins-type-num 1 --seller-type-num 1`\r\n10. **视频复刻**：「用 LinkFoxAI 复刻这个视频，换成我的商品图」→ `video-reclone --wait --ref-video-url <video_url> --ref-image-list <img1> <img2> --video-type SEED --duration 10 --resolution 720P --sale-country CN --target-language zh --ratio 9:16`\r\n11. **视频复刻(SEED_FAST)**：「用SEED_FAST快速复刻视频」→ `video-reclone --wait --ref-video-url <video_url> --ref-image-list <img1> --video-type SEED_FAST --duration 10 --resolution 720P --sale-country US --target-language en`\r\n12. **套图无字模式**：「用 LinkFoxAI 生成商品套图，不要文字」→ `product-material --wait --image-list <url> --seller-point \"...\" --no-text --a-plus-num 2`\r\n13. **图转视频(多图)**：「用 KLING 多图模式生成15秒视频」→ `image-to-video --wait --image-list <url1> <url2> --video-type KLING --video-time 15 --resolution 720p --aspect-ratio 16:9`\r\n14. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id <id>`\n\nFile v1.5.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ai\",\n  \"version\": \"1.5.1\",\n  \"publishedAt\": 1781244920181\n}\n\nFile v1.5.1:references/image-make.md\n\n# AI 作图 / 视频 - 全部接口完整说明\r\n\r\n本文档为 LinkFoxAI Skill 内置参考，涵盖开放平台 AI 作图/视频能力、完整参数与注意事项。\r\n\r\n所有接口均为 **POST**，请求体 **Content-Type: application/json**，响应体 application/json。\r\n\r\n---\r\n\r\n## 一、通用作图流程\r\n\r\n1. **可选**：调用「作图素材」获取预设素材地址（模特、场景等）。\r\n2. **可选**：本地图片需先调用「图片上传」得到可访问 URL。\r\n3. 调用具体作图接口，得到 **任务 ID**（`data.id`）。\r\n4. 轮询「获取作图结果」直到 `data.status` 为 3(成功) 或 4(失败)，取 `data.resultList[].url` 得到结果图。\r\n5. 结果图为**临时地址，有效期约 8 小时**；过期后调用「刷新结果图片地址」传入**图片 ID**（`resultList[].id`，非任务 ID）获取新 URL。\r\n\r\n**注意事项：**\r\n- 用户图片需外网可访问、链接稳定，建议使用国内图床（阿里云 OSS、腾讯云 COS 等）。\r\n- 作图素材地址通过「作图素材」接口获得，用作预设资源。\r\n- 本地图片上传支持 base64 编码，无需单独传 OSS。\r\n\r\n---\r\n\r\n## 二、通用响应结构\r\n\r\n所有作图创建任务接口的响应结构一致：\r\n\r\n| 参数 | 说明 | 类型 |\r\n|------|------|------|\r\n| traceId | 链路 ID | string |\r\n| code | 状态码，200 为成功 | string |\r\n| msg | 成功/错误描述 | string |\r\n| msgKey | 错误码，code 非 200 时存在 | string |\r\n| data.id | 任务 ID（用于轮询结果） | number |\r\n\r\n响应示例：\r\n```json\r\n{\"traceId\":\"f6e0fe4f360f78445c2c5d52f2414dea\",\"code\":\"200\",\"msg\":\"成功\",\"data\":{\"id\":123456}}\r\n```\r\n\r\n---\r\n\r\n## 三、作图素材\r\n\r\n**路径**：`/linkfox-ai/image/v2/material/list`\r\n\r\n**注意**：此接口可用于连通性测试，无需上传图片。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 类型：1=AI换模特-预设模特，2=模特图通用-预设场景，3=AI换模特固定脸-预设模特，4=模特图通用-场景素材，5=AI穿衣姿势-上下装素材，6=AI穿衣姿势-连体衣素材，7=AI穿戴-模特素材，8=手持商品-姿势素材，9=姿势裂变素材，10=套图-排版素材 | 是 | string |\r\n| pageNum | 页数，默认 1 | 否 | number |\r\n| pageSize | 单页条数，默认 10 | 否 | number |\r\n\r\n响应 data 含 list（url/name/tagList）、total、hasMore。\r\n\r\n```json\r\n{\"type\":\"1\"}\r\n```\r\n\r\n---\r\n\r\n## 四、图片上传\r\n\r\n### 4.1 base64 上传\r\n\r\n**路径**：`/linkfox-ai/image/v2/uploadByBase64`\r\n\r\n**注意**：全局 QPS 100（不分 IP 不分用户）。适用于没有图片存储服务或无法外网访问的场景。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（带扩展名），支持 jpeg/jpg/png/webp | 是 | string |\r\n| base64 | 图片 base64 编码，文件不超过 10MB，最长边不超过 4096 | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传后图片访问地址）。\r\n\r\n### 4.2 生成上传地址（OSS 直传）\r\n\r\n**路径**：`/linkfox-ai/image/v1/generateUploadUrl`\r\n\r\n**注意**：QPS 由阿里控制，并发能力高于 base64 方式。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（主要取后缀） | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传成功后可用地址）、policy（url/signature/policy/key/OSSAccessKeyId，用于客户端直传 OSS）。\r\n\r\n---\r\n\r\n## 五、获取作图结果\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/info`\r\n\r\n**注意**：需轮询此接口直到 status 变为 3（成功）或 4（失败）。建议轮询间隔 3-5 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 作图任务 ID | 是 | number |\r\n| format | 结果格式，目前仅支持 jpg | 否 | string |\r\n\r\n响应 data：\r\n\r\n| 字段 | 说明 | 类型 |\r\n|------|------|------|\r\n| id | 作图任务 ID | number |\r\n| status | 1=排队中 2=生成中 3=成功 4=失败 | integer |\r\n| errorCode | 错误码 | string |\r\n| errorMsg | 错误描述 | string |\r\n| resultList | 结果图片数组 | array |\r\n| resultList[].id | **图片 ID**（用于刷新地址） | number |\r\n| resultList[].status | 0=生成中 1=成功 2=失败 | integer |\r\n| resultList[].url | 高清图临时地址（有效期 8 小时） | string |\r\n| resultList[].width | 宽 | integer |\r\n| resultList[].height | 高 | integer |\r\n| resultList[].format | 格式 | string |\r\n| resultList[].size | 大小（字节） | integer |\r\n| resultList[].extendField | 扩展参数（如 maskUrl、requestId 等） | object |\r\n\r\n---\r\n\r\n## 六、刷新结果图片地址\r\n\r\n**路径**：`/linkfox-ai/image/v2/info`\r\n\r\n**注意**：ID 是**图片 ID**（resultList[].id），不是作图任务 ID。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 图片 ID | 是 | number |\r\n| downloadFormat | 下载格式，如 jpg、png | 否 | string |\r\n\r\n响应 data 含 url（新的图片访问地址）。\r\n\r\n---\r\n\r\n## 七、AI 换模特\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModel`\r\n\r\n**注意**：与 AI 换模特 2.0 的差异——生成的模特脸部更随机，使用同一个头部图，生成的模特脸部有细微变化。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelHeadImageUrl | 模特头部图。格式：jpg/jpeg/png/webp，5M 以内，最小 512x512，最大 2048x2048。或调用作图素材(type=1) | 是 | string |\r\n| sceneImgUrl | 场景参考图。格式：jpg/jpeg/png/webp，10M 以内，最小 768x768，最大 4096x4096。或调用作图素材(type=2 预设场景/type=4 场景素材)。建议使用场景素材，效果稳定 | 否 | string |\r\n| sceneStrength | 场景相似度，值越大越相似，[0,1]，默认 0.7 | 否 | string |\r\n| modelPrompt | 模特特征参数，多选用逗号拼接 | 否 | string |\r\n| customPrompt | 自定义描述，最多 600 字符 | 否 | string |\r\n| customNegPrompt | 画面中不需要的元素 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特（false 为人台），默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\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## 八、AI 换模特-2.0\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModelFixed`\r\n\r\n**注意**：与 AI 换模特的差异——生成的模特脸部更固定，使用同一个头部图，脸部变化很小。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelImageUrl | 模特头部图。或调用作图素材(type=3) | 是 | string |\r\n| sceneImgUrl | 场景图。或调用作图素材(type=4) | 否 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 九、模特换场景\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelChangeScene`\r\n\r\n**注意**：sceneImgUrl 与 scenePrompt 二选一必填。建议使用场景素材（type=4），效果稳定。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特抠图结果 | 否 | string |\r\n| sceneImgUrl | 场景图。或作图素材(type=2/4)。与 scenePrompt 二选一 | 条件 | string |\r\n| scenePrompt | 场景描述。与 sceneImgUrl 二选一 | 条件 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十、AI 穿衣-上下装\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoom`\r\n\r\n**注意**：upperOriginUrl 与 downOriginUrl 至少填一项。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| upperOriginUrl | 上衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 与下衣二选一 | string |\r\n| upperImageUrl | 上衣抠图结果 | 否 | string |\r\n| downOriginUrl | 下装原图。同上衣格式要求 | 与上衣二选一 | string |\r\n| downImageUrl | 下装抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=5) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十一、AI 穿衣-连体衣\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoomSuit`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| suitOriginUrl | 连体衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| suitImageUrl | 连体衣抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=6) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十二、AI 穿戴\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/intelligentWear`\r\n\r\n**注意**：穿戴模特原图为自定义图片时，targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 穿戴商品图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| targetOriginUrl | 穿戴模特原图。自定义地址或作图素材(type=7) | 是 | string |\r\n| targetMaskUrl | 穿戴区域图（黑白图，黑色为穿戴区域）。自定义模特图时必填 | 条件 | string |\r\n| productCategory | 商品品类，见下表 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n**商品品类字典：**\r\n\r\n| 值 | 说明 |\r\n|------|------|\r\n| footwear | 鞋靴 |\r\n| luggage | 箱包 |\r\n| eyewear | 眼镜 |\r\n| necklace | 项链 |\r\n| hat | 帽子 |\r\n| earring | 耳环 |\r\n| ring | 戒指 |\r\n| wristband | 手环手链 |\r\n| watch | 手表 |\r\n| headwear | 头饰 |\r\n| belt | 皮带 |\r\n| other | 其他 |\r\n\r\n---\r\n\r\n## 十三、商品替换\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/shopReplace`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 384x384，最大 8192x8192 | 是 | string |\r\n| sourceImageUrl | 原图的抠图结果 | 否 | string |\r\n| targetOriginUrl | 替换的目标原图 | 是 | string |\r\n| targetImageUrl | 目标原图抠图结果 | 否 | string |\r\n| denoiseStrength | 生成图变化程度，[0,1]，默认 0.5，越大变化越高 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长边不超过 4096，最短边不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传或只传一个时与原图尺寸一致 | 否 | number |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十四、场景裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/sceneFission`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| segImageUrl | 保留区域图 | 否 | string |\r\n| strength | 相似度 [0.1,1]，默认 0.5，越大越相似，浮点数小数点后一位 | 否 | string |\r\n| prompt | 强化内容描述，不传则自动提取，最长 600 字符 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长不超过 2048，最短不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传时最长边固定 1024，最短边按原图比例调整 | 否 | number |\r\n| provider | 模式：SCENE_FISSION_REALISTIC=写实（默认），SCENE_FISSION_SIMPLE=简约，SCENE_FISSION_INTELLIGENT=智能 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十五、场景图生成（AI 绘图）\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/aiDraw`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 生图描述 | 是 | string |\r\n| imageUrl | 参考图 | 否 | string |\r\n| style | 生图风格，可选：场景素材/人物素材/古韵国风/传神素描/赛博朋克/像素插画/静谧水墨/动漫线稿/新海诚/宫崎骏/CG/黑白插画/复古日漫/Q版人物/写实油画/C4D剪纸/灵韵水彩/清新日漫 | 否 | string |\r\n| scale | 宽高比，默认 1:1，可选 1:1/16:9/9:16 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十六、相似图裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToImage`\r\n\r\n**注意**：自定义尺寸（width+height）与 scale 二选一。宽高只传一个时取原图对应值。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 参考图。格式：jpg/png/webp，10M 以内，最大 4096x4096 | 是 | string |\r\n| prompt | 生图描述，不填则自动提取，最多 600 字符 | 否 | string |\r\n| weight | 相似度 [0,2]，默认 2 | 否 | integer |\r\n| width | 自定义宽度，最小 384，最大 4096 | 否 | integer |\r\n| height | 自定义高度，最小 384，最大 4096 | 否 | integer |\r\n| scale | 宽高比字符串（如 16:9），与自定义尺寸二选一 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十七、自动抠图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/cutout`\r\n\r\n**注意**：clothClass 仅在 subType=9（服饰）时生效，可多选以逗号分割，多选会合并抠图结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| subType | 抠图类型：1=通用，2=人像，3=商品，9=服饰，12=头发，13=人脸 | 是 | integer |\r\n| clothClass | 服饰抠图分类（subType=9 时生效），可多选逗号分割：tops/coat/skirt/pants/bag/shoes/hat | 否 | string |\r\n\r\n---\r\n\r\n## 十八、精细抠图-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/create`\r\n\r\n**注意**：pointList 中 x/y 为归一化坐标（0~1），isSelect 1=选中 0=不选中。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图 | 是 | string |\r\n| scoreUrl | 概率图（迭代时传入上一次返回的 scoreUrl） | 否 | string |\r\n| featureUrl | 全局分割图（同上） | 否 | string |\r\n| pointList | 点位操作列表 | 是 | array |\r\n| pointList[].x | 与左边缘距离 / 图片宽度，0~1 | 是 | number |\r\n| pointList[].y | 与上边缘距离 / 图片高度，0~1 | 是 | number |\r\n| pointList[].isSelect | 0=不选中，1=选中 | 是 | integer |\r\n\r\n---\r\n\r\n## 十九、精细抠图-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 精细抠图任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result（maskUrl/scoreUrl/imageUrl/featureUrl）。\r\n\r\n---\r\n\r\n## 二十、图片高清放大\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/superResolution`\r\n\r\n**注意**：放大后结果图最长边最大 8192。例如 3000x3000 放大 4 倍 → 8192x8192。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，最大 4096x4096 | 是 | string |\r\n| magnification | 放大倍数 [1,4]（浮点数），只高清不放大传 1 | 是 | float |\r\n| enhanceQuality | 是否高清化 | 否 | boolean |\r\n\r\n---\r\n\r\n## 二十一、智能扩图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/expandImage`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| width | 期望扩图后宽度 | 是 | number |\r\n| height | 期望扩图后高度 | 是 | number |\r\n| prompt | 提示词，最多 600 字符 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十二、图片翻译\r\n\r\n**路径**：`/linkfox-ai/image/v3/make/imageTransl`\r\n\r\n**注意**：原图最大 3000x3000，4M 以内。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，4M 以内，最小 385x385，最大 3000x3000 | 是 | string |\r\n| translationPlatform | 翻译源：deepl / chatgpt | 是 | string |\r\n| sourceLanguage | 源语种代码 | 是 | string |\r\n| targetLanguage | 目标语种代码 | 是 | string |\r\n\r\n**源语种代码：** CHS(中文)、ENG(英文)、CHT(繁体中文)、ESP(西班牙语)、JPN(日语)、KOR(韩语)、PT(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、VIN(越南语)、DEU(德语)\r\n\r\n**目标语种代码：** AR(阿拉伯语)、BG(保加利亚语)、BN(孟加拉语)、CHS(中文)、CHT(繁体中文)、CKB(中库尔德语)、CSY(捷克语)、DA(丹麦语)、DEU(德语)、EL(希腊语)、ENG(英语)、ESP(西班牙语)、ET(爱沙尼亚语)、FA(波斯语)、FI(芬兰语)、FIL(菲律宾语)、FRA(法语)、GU(古吉拉特语)、HE(希伯来语)、HI(印地语)、HR(克罗地亚语)、HUN(匈牙利语)、ID(印尼语)、ITA(意大利语)、JPN(日语)、JW(爪哇语)、KOR(韩语)、LO(老挝语)、LT(立陶宛语)、LV(拉脱维亚语)、MR(马拉地语)、MS(马来语)、MY(缅甸语)、NLD(荷兰语)、NO(挪威语)、PLK(波兰语)、PT(葡萄牙语)、PTB(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、SK(斯洛伐克语)、SL(斯洛文尼亚语)、SV(瑞典语)、SW(斯瓦希里语)、TA(泰米尔语)、TE(泰卢固语)、TG(塔吉克语)、TH(泰语)、TL(他加禄语)、TRK(土耳其语)、UK(乌克兰语)、UR(乌尔都语)、VIN(越南语)\r\n\r\n---\r\n\r\n## 二十三、手部修复\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| personType | 人物类型：0=女孩，1=男孩，2=成年女性，3=成年男性 | 是 | number |\r\n| maskUrl | 修复区域（黑白图，白色为修复区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十四、局部重绘\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/areaRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| prompt | 提示词，最多 600 字符 | 是 | string |\r\n| maskUrl | 重绘区域图（黑白图，白色为重绘区域） | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十五、印花提取\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/printExtract`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 二十六、消除笔\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/interactErase`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| maskImageUrl | 消除区域图（黑白图，白色为消除区域） | 是 | string |\r\n\r\n---\r\n\r\n## 二十七、手持商品\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handHeld`\r\n\r\n**注意**：手持姿势图为自定义图片时 targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 手持商品图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| targetOriginUrl | 手持姿势图。自定义地址或作图素材(type=8) | 是 | string |\r\n| targetMaskUrl | 手持区域图（黑白图，尺寸与姿势图一致）。自定义姿势图时必填 | 条件 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十八、饰品文字\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/linkedWord`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fontname | 字体名称（见下方列表） | 是 | string |\r\n| fontSize | 输出字体大小 | 是 | integer |\r\n| left | 左边加环，默认 false | 否 | boolean |\r\n| right | 右边加环，默认 false | 否 | boolean |\r\n| prompt | 饰品文字内容 | 是 | string |\r\n\r\n**可选字体：** Caitlyn、ItaliannoRob、Alison、ALSScript、WhiteAngelica、Milkshake、ScriptMTBold、PassionsConflictROB、Sacramento、Cervanttis、Notera 2 PERSONAL USE ONLY、UyghurMerdane、OldEnglishText、Halimun、AlexBrush、Scriptina、CounselorScript、EliannaBoldItalic、AutumnChant、MagnoliaScript\r\n\r\n---\r\n\r\n## 二十九、商品精修\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/productRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 三十、图片获取描述词-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/create`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 应用类型：5=相似图裂变，13=场景裂变，69=穿衣套图卖点分析，71=商品套图卖点分析 | 是 | string |\r\n| imageUrlList | 图片地址列表（只有套图卖点分析支持多张） | 是 | List\\<string\\> |\r\n| keyword | 关键字。场景裂变时有效；套图卖点分析时可传入商品信息 | 否 | string |\r\n| provider | 套图模式提取类型：API_PRE_POINT=卖点分析（默认），API_LAYOUT_DESC=排版描述 | 否 | string |\r\n\r\n---\r\n\r\n## 三十一、图片获取描述词-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result.content（描述词文本）。\r\n\r\n---\r\n\r\n## 三十二、智能修图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/imageEditV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `imageEditV2`。\r\n- 旧版 `imageEdit` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。支持 jpg/jpeg/png/webp；尺寸 300x300 ~ 4096x4096；宽高比 0.4 ~ 2.5 | 是 | string |\r\n| prompt | 提示词 | 是 | string |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 / GPT_2_IMAGE / AIDRAW_EDIT | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO / GPT_2_IMAGE 默认 2K，其余默认 1K。WAN2_7 / AIDRAW_EDIT 不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false | 否 | boolean |\r\n| template | 提示词模板名称（单图模板，见下方可选值说明。模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n**template 可选值（单图）：**\r\n\r\n`白底图`、`商品主图精修`、`生成场景`、`海报制作`、`加人或物`、`换动物`、`服装平铺`、`3D服装`、`人台换模特`、`卡通插画`、`改身材`、`更换风格`、`移除元素`、`文字消除`、`去除水印`、`添加水印`\r\n\r\n---\r\n\r\n## 三十三、智能修图-多图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/multiImageFusionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `multiImageFusionV2`。\r\n- 旧版 `multiImageFusion` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 图片列表。支持 jpg/jpeg/png/webp（10M 以内），最小 800x800，最大 4096x4096。最多12张 | 是 | array[string] |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 / GPT_2_IMAGE / AIDRAW_EDIT | 是 | string |\r\n| prompt | 强化内容描述（100 字以内） | 否 | string |\r\n| outputNum | 输出张数，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO / GPT_2_IMAGE 默认 2K，其余默认 1K。WAN2_7 / AIDRAW_EDIT 不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false。仅 BANANA_PRO 支持 | 否 | boolean |\r\n| template | 提示词模板名称（多图模板，见下方可选值说明。模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n**template 可选值（多图）：**\r\n\r\n`搭配融图`、`搭配上身`\r\n\r\n---\r\n\r\n## 三十四、商品套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/productMarketMaterialV3`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `productMarketMaterialV3`。\r\n- 旧版 `productMarketMaterialV2` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 800x800，最大 4096x4096，10M 以内。\r\n- 各类型数量（aPlusNum/aPlusProNum/sellerTypeNum/sceneTypeNum/closeUpTypeNum/closeUpWhiteTypeNum/whiteBgTypeNum）单项最大 **12**。\r\n- aPlusStyles/pointStyles 传入时，数量需与目标生成数量一致。\r\n- brandKey 为 JSON 对象，总长度不超过 1000 字符。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| sellerTypeNum | 卖点图 | sellPoint |\r\n| sceneTypeNum | 场景图 | scene |\r\n| closeUpTypeNum | 特写图 | closeUp |\r\n| closeUpWhiteTypeNum | 白底特写图 | closeUpWhite |\r\n| whiteBgTypeNum | 白底图 | whiteBg |\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符（未开启自动提取卖点描述时校验必填） | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代）/ WAN2_7（万相2.7）/ GPT_2_IMAGE（GPT图片2）/ AIDRAW_EDIT（自研修图） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 12 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量（Pro），默认 0，最大 12 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+（基于高级 A+ 结果，数量与高级 A+ 一致），默认 false | 否 | boolean |\r\n| aPlusAspectRatio | 自定义 A+ 宽高比（仅高级 A+ 场景使用），如 16:9/9:16/1:1 | 否 | string |\r\n| aPlusStyles | A+ 排版列表，id（风格 id，通过作图素材接口获取）或 prompt（排版词，通过排版描述接口获取） | 否 | List |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 12 | 否 | integer |\r\n| isExtractPrePoint | 是否自动提取卖点：true 开启 false 关闭，默认 false | 否 | boolean |\r\n| sceneTypeNum | 场景图数量，默认 0，最大 12 | 否 | integer |\r\n| closeUpTypeNum | 特写图数量，默认 0，最大 12 | 否 | integer |\r\n| closeUpWhiteTypeNum | 白底特写图数量，默认 0，最大 12 | 否 | integer |\r\n| whiteBgTypeNum | 白底图数量，默认 0，最大 12 | 否 | integer |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON：brandColor(#RRGGBB)/fontStyle/salesRegion/language/platform/customSettings | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K；AIDRAW_EDIT 支持 1K / 2K | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十五、服装套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/wearCollectionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `wearCollectionV2`。\r\n- 旧版 `wearCollection` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 384x384，最大 4096x4096，10M 以内。\r\n- 各类型数量（aPlusNum/aPlusProNum/modelTypeNum/insTypeNum/sellerTypeNum/sizeTypeNum/whiteTypeNum）单项最大 **12**。\r\n- sellerPoint 建议包含面料、卖点、目标人群、使用场景、尺码等信息，有助于提升结果质量。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| modelTypeNum | **模特+场景合成图**（非纯模特图） | **scene** |\r\n| insTypeNum | 种草图 | ins |\r\n| sellerTypeNum | 卖点图 | point |\r\n| sizeTypeNum | 尺码图 | size |\r\n| whiteTypeNum | 白底图 | white |\r\n\r\n> **⚠️ 特别说明**：`modelTypeNum` 生成的是**模特穿上服装并置于场景中的合成图**，输出 type 为 `scene`，而非 `model`。命名虽含 \"model\"，但产出是模特+场景的完整合成结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符（未开启自动提取卖点描述时校验必填） | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代）/ WAN2_7（万相2.7）/ GPT_2_IMAGE（GPT图片2） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 12 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量，默认 0，最大 12 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+（基于高级 A+ 结果，数量与高级 A+ 一致），默认 false | 否 | boolean |\r\n| aPlusAspectRatio | A+ 宽高比，不填则自动选择；支持 16:9/9:16/1:1 | 否 | string |\r\n| aPlusStyles | A+ 排版列表（id 或 prompt） | 否 | List |\r\n| modelTypeNum | **模特+场景合成图**数量（输出 type=`scene`），默认 0，最大 12 | 否 | integer |\r\n| ↳ modelImageUrl | 模特参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ sceneImageUrl | 场景参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ isExactScene | 场景裂变模式：true=遵循背景（默认），false=相似裂变。**仅 modelTypeNum > 0 时生效** | 否 | boolean |\r\n| ↳ modelAndSceneInfo | 描述想要的场景内容和模特特征。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| insTypeNum | 种草图数量，默认 0，最大 12 | 否 | integer |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 12 | 否 | integer |\r\n| isExtractPrePoint | 是否自动提取卖点：true 开启 false 关闭，默认 false | 否 | boolean |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| sizeTypeNum | 尺码图数量，默认 0，最大 12 | 否 | integer |\r\n| whiteTypeNum | 白底图数量，默认 0，最大 12 | 否 | integer |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON（同商品套图） | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十六、姿势裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelPoseFission`\r\n\r\n**注意**：postureUrl（素材 type=9）与 prompt 二选一。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 图片地址。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| prompt | 自定义姿势描述。与 postureUrl 二选一 | 否 | string |\r\n| postureUrl | 姿势图片 URL。作图素材(type=9)或自定义。与 prompt 二选一 | 否 | string |\r\n| outputNum | 输出数量 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 三十七、带货口播\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/salesVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID（`taskId`），需继续轮询「获取作图结果」接口查询最终资源。\r\n- `prompt` 建议包含商品卖点、目标人群、使用场景和行动指令，以提升口播质量。\r\n- `imageList` 传入商品主图/细节图通常能提升视频一致性和转化表达。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 口播脚本/提示词 | 是 | string |\r\n| imageList | 参考图 URL 列表（建议 1~6 张） | 否 | array[string] |\r\n| videoType | 模型类型：WAN / SEED（seed = seedance） | 是 | string |\r\n| videoTime | 视频时长（秒）。WAN: 10/15秒；SEED: 5/10/15秒 | 否 | number |\r\n| isPro | 是否开启高质量模式（SEED 专用，等同 resolution=720p） | 否 | boolean |\r\n| aspectRatio | 视频比例：16:9 / 9:16 | 否 | string |\r\n| resolution | 视频分辨率。仅SEED类型支持，可选值：480p/720p/1080p（默认480p）。传入时优先于 isPro | 否 | string |\r\n\r\n---\r\n\r\n## 三十八、图转视频\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID，需继续轮询「获取作图结果」接口查询最终视频地址。\r\n- 不同模型支持的参数和时长不同，详见下方「各模型参数支持情况」。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图地址。格式：jpg/jpeg/png/webp | 是 | string |\r\n| videoType | 模型类型：KLING（可灵）/ V（电影/Veo）/ WAN（万相）/ SEED（Seedance/豆包）/ HAILUO（海螺） | 是 | string |\r\n| videoTime | 视频时长（秒），不同类型支持的时长不同，见下方对照 | 是 | number |\r\n| prompt | 视频提示词（2000 字以内） | 否 | string |\r\n| promptOptimizer | 是否开启提示词优化：true/false，默认 false | 否 | boolean |\r\n| isPro | 是否开启高质量/Pro 模式，默认 false（SEED 专用，等同 resolution=720p） | 否 | boolean |\r\n| voice | 是否生成声音：true/false，默认 false | 否 | boolean |\r\n| lastFrameImageUrl | 尾帧图地址（用于控制视频结束帧画面） | 否 | string |\r\n| aspectRatio | 视频比例：16:9 / 9:16 | 否 | string |\r\n| camera | 运镜参数：single（单镜头）/ multi（多镜头），仅WAN类型支持 | 否 | string |\r\n| resolution | 视频分辨率。仅SEED类型支持，可选值：480p/720p/1080p（默认480p）。传入时优先于 isPro | 否 | string |\r\n\r\n**各模型参数支持情况：**\r\n\r\n| 参数 | KLING（可灵） | V（电影/Veo） | WAN（万相） | SEED（Seedance/豆包） | HAILUO（海螺） |\r\n|------|:---:|:---:|:---:|:---:|:---:|\r\n| videoTime（时长） | 5 / 10 秒 | 4 / 8 秒 | 10 / 15 秒 | 5 / 10 / 15 秒 | 6 / 10 秒 |\r\n| prompt（提示词） | 支持 | 支持 | 支持 | 支持 | 支持 |\r\n| promptOptimizer（提示词优化） | 支持 | 支持 | 支持 | 支持 | 支持 |\r\n| isPro（Pro 模式） | 支持 | 支持 | - | 支持 | 支持 |\r\n| voice（生成声音） | - | - | 支持 | 支持 | - |\r\n| camera（运镜） | - | - | single / multi | - | - |\r\n| lastFrameImageUrl（尾帧图） | 支持 | 支持 | 支持 | 不支持 | 不支持 |\r\n| aspectRatio（视频比例） | 传入不生效 | 16:9 / 9:16，未传默认 9:16 | - | 16:9 / 9:16 | 传入不生效 |\r\n| resolution（分辨率） | - | - | - | 480p / 720p / 1080p，默认 480p | - |\r\n\r\n---\r\n\r\n## 三十九、视频复刻\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/videoReclone`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID，需继续轮询「获取作图结果」接口查询最终视频地址。\r\n- `refVideoUrl` 必须为稳定可访问的公网 URL，异步分析阶段才访问，短期签名 URL 可能已过期。\r\n- `refImageList` 中的图片在提交任务时**同步**下载，若图片无法访问，任务创建立即报错。\r\n- `SEED_FAST` 不支持 `1080P` 分辨率，传入会报错。\r\n- 视频复刻涉及多步 AI 分析，通常比图片任务耗时更长，建议轮询间隔 5~10 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| refVideoUrl | 参考视频的公网 URL（需长期有效，避免使用短期签名 URL） | 是 | string |\r\n| refImageList | 参考商品图 URL 列表，1~6 张可访问外网的图片 URL | 是 | array[string] |\r\n| videoType | 模型类型：SEED / SEED_FAST | 是 | string |\r\n| duration | 目标视频时长（秒），范围 5~15 的整数 | 是 | number |\r\n| resolution | 视频分辨率，见下方对照表 | 是 | string |\r\n| saleCountry | 销售国家（如 CN、US） | 是 | string |\r\n| targetLanguage | 目标语言（如 zh、en） | 是 | string |\r\n| ratio | 视频比例：16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 | 否 | string |\r\n| productInfo | 补充商品文字信息，用于辅助 AI 分析，最多 2500 字符 | 否 | string |\r\n\r\n**各模型参数支持情况：**\r\n\r\n| 参数 | SEED（Seedance/豆包） | SEED_FAST（Seedance 2.0 Fast） |\r\n|------|:---:|:---:|\r\n| duration（时长） | 5~15 秒整数 | 5~15 秒整数 |\r\n| resolution（分辨率） | 480P / 720P / 1080P | 480P / 720P（不支持 1080P） |\r\n| ratio（视频比例） | 16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 | 16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 |\r\n| refImageList 上限 | 6 张 | 6 张 |\n\nFile v1.5.1:references/open-platform.md\n\n# LinkFox AI 开放平台 - 接入与错误码\r\n\r\n## 接入流程\r\n\r\n1. 注册紫鸟开放平台：https://open.ziniao.com  \r\n2. 认证开发者，创建 LinkFox 卖家应用：https://open.ziniao.com/docSupport?docId=116  \r\n3. 将应用绑定到团队：https://www.linkfox.com/team/api-guide  \r\n4. 鉴权方式以官方文档为准：[API 调用指南 - 简单通用模式（推荐）](https://open.ziniao.com/docSupport?docId=233)\r\n\r\n## API 基础地址\r\n\r\n- 默认：`https://sbappstoreapi.ziniao.com/openapi-router`  \r\n- 路径前缀：`/linkfox-ai`  \r\n- 无固定 IP 时可使用代理：`https://sbappstoreapi-proxy.linkfox.com`（需配置白名单 IP：120.79.189.15）\r\n\r\n## 响应外层结构\r\n\r\n所有接口的响应均由开放平台包装了一层外层结构，实际业务数据在 `data` 字段中。\r\n\r\n```json\r\n{\r\n  \"request_id\": \"abc123\",\r\n  \"code\": 0,\r\n  \"msg\": \"success\",\r\n  \"data\": {\r\n    // 此处为业务接口的实际响应体\r\n    \"traceId\": \"...\",\r\n    \"code\": \"200\",\r\n    \"msg\": \"成功\",\r\n    \"data\": { /* 业务数据 */ }\r\n  }\r\n}\r\n```\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| request_id | 开放平台请求 ID |\r\n| code | 开放平台状态码，0 为成功 |\r\n| msg | 开放平台消息 |\r\n| data | 业务接口实际响应（内部有自己的 traceId/code/msg/data） |\r\n\r\n即实际数据嵌套路径为：`响应.data.data`（外层 data 是开放平台包装，内层 data 是业务数据）。\r\n\r\n## QPS / 限流说明\r\n\r\n- **base64 上传接口** (`/linkfox-ai/image/v2/uploadByBase64`)：全局限流 100 QPS。\r\n- **其他接口**：默认无严格 QPS 限制，但建议单应用并发不超过 50 QPS。\r\n- 触发限流时返回 HTTP 429 或开放平台错误码。\r\n- 作图任务提交后需轮询 `make-info` 获取结果，建议轮询间隔 ≥ 3 秒。\r\n\r\n## 错误码\r\n\r\n| 错误码 | 描述 |\r\n| --- | --- |\r\n| ERR_FILED_VALIDATE | 参数校验异常 |\r\n| ERR_VALIDATE_FAIL | 参数校验异常 |\r\n| ERR_IMAGE_MAKE_AUDIT | 图片审核不通过 |\r\n| ERR_IMAGE_MAKE_WILL_OUT | 作图点数不足 |\r\n| ERR_FORBIDDEN | 没有ID权限，ID取错也有可能 |\r\n| ERR_NOT_HAVE_TEAM_PRIVILEGE | 未绑定团队 |\r\n| TEAM_PERMISSION_DISABLE_USER | 被禁用 |\r\n| ERR_IMAGE_MAKE_COUNT_MAX | 生成中创建上限 |\r\n| TEAM_PERMISSION_EXPIRE | 套餐已过期或者未购买套餐 |\r\n\r\n更多说明见开放平台 https://open.ziniao.com 或本 skill 内 `references/image-make.md`。\n\nFile v1.5.1:skill-card.md\n\n## Description:\n\nLinkFoxAI lets an agent call the LinkFox AI open platform for image and video generation workflows, including model swaps, cutouts, image expansion, scene variation, product image sets, talking sales videos, image-to-video, task polling, generic API calls, and connectivity checks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external teams use this skill to connect an agent to LinkFox AI media-generation APIs, submit authenticated image or video jobs, poll for results, and return generated media URLs or API responses.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill gives an agent broad authenticated access to LinkFox AI APIs and media upload workflows.\n\nMitigation: Use a scoped API key if available, protect LINKFOXAI_API_KEY, and review proposed api-call and upload-base64 commands before execution.\n\nRisk: Media, prompts, product data, and account credentials are sent to LinkFoxAI/Ziniao services.\n\nMitigation: Install only when that data sharing is acceptable, and avoid uploading sensitive local files or private/person media without consent.\n\nRisk: Changing LINKFOXAI_BASE_URL can route authenticated requests away from the documented official hosts.\n\nMitigation: Keep LINKFOXAI_BASE_URL on the documented official hosts unless the deployment has separately verified the endpoint and allowlist requirements.\n\nRisk: Generated media jobs can take a long time, fail audit checks, or return temporary result URLs.\n\nMitigation: Run long jobs in background sessions, poll status, surface task IDs and error messages, and refresh expired result URLs when needed.\n\n## Reference(s):\n\n- [LinkFox AI Open Platform](https://open.ziniao.com)\n- [LinkFox API Guide](https://www.linkfox.com/team/api-guide)\n- [AI Image and Video API Reference](references/image-make.md)\n- [Open Platform Access and Error Codes](references/open-platform.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-ai)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON]\n\n**Output Format:** [Markdown guidance with shell commands and JSON API responses or generated media URLs]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Outputs may include temporary generated media URLs, task IDs for polling, API error messages, and configuration requirements for LinkFoxAI credentials.]\n\n## Skill Version(s):\n\n1.5.1 (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.5.0: 6 files, 24053 bytes\n\nFiles: _meta.json (129b), references/image-make.md (36697b), references/open-platform.md (2433b), scripts/linkfoxai.py (23783b), skill-card.md (3017b), SKILL.md (10745b)\n\nFile v1.5.0:SKILL.md\n\n---\r\nname: linkfoxai\r\ndescription: \"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🦊\",\"requires\":{\"env\":[\"LINKFOXAI_API_KEY\"]}}}\r\n---\r\n\r\n# LinkFoxAI - LinkFox AI 开放平台 Skill\r\n\r\nLinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播、图转视频等。\r\n\r\n## 配置\r\n\r\n1. **获取凭证**：注册 [紫鸟开放平台](https://open.ziniao.com)，认证开发者并创建 LinkFox 卖家应用，然后在 [linkfox.com/team/api-guide](https://www.linkfox.com/team/api-guide) 将应用绑定到团队，获取 API Key。\r\n2. **环境变量**：`LINKFOXAI_API_KEY`（单一 API Key，配置一个 Key 即可调用全部接口）\r\n3. **自定义 Base URL**（可选）：默认 `https://sbappstoreapi.ziniao.com/openapi-router`。若无固定 IP，设置 `LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com` 并配置白名单。\r\n\r\n## 必须使用 sessions_spawn 调度作图任务\r\n\r\nAI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，**极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟**）。**务必通过 `sessions_spawn` 将作图任务派发到子会话**，让主会话保持响应。脚本的 `--wait` 参数会自动轮询直到出结果。\r\n\r\n### 超时处理策略（AI 自行判断）\r\n\r\n当作图任务超时（`--timeout` 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r\n\r\n1. **延长轮询时间**：将 `--timeout` 增大到 1800（30 分钟），`--interval` 建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r\n2. **告知用户并继续后台等待**：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r\n3. **任务分拆重试**：若任务参数含多图（如 `--output-num 4`），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r\n4. **放弃并报错**：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r\n\r\n> 默认建议：将 `sessions_spawn` 的 `runTimeoutSeconds` 设为 **1800**，`--timeout` 设为 **1700**，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r\n\r\n### 标准调度模板\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\\r\n         --image-url \"<模特原图>\" --head-url \"<头部图>\" --output-num 4\r\n    解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r\n    如果 status=4（失败），报告 errorMsg。\r\n    如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 换模特\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n  cleanup: \"keep\"\r\n```\r\n\r\n### 并行调度多个独立任务\r\n\r\n```\r\n# 子任务 1\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '<url>' --sub-type 1 ...\"\r\n  label: \"LinkFoxAI: 自动抠图\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n\r\n# 子任务 2\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '<url>' ...\"\r\n  label: \"LinkFoxAI: 场景裂变\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n### 通用接口调用（api-call）\r\n\r\n对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py api-call \\\r\n         --path /linkfox-ai/image/v2/make/fittingRoom \\\r\n         --body '{\"upperOriginUrl\":\"<上衣图>\",\"modelImageUrl\":\"<模特图>\",\"outputNum\":2}'\r\n    获取返回的 data.id，然后运行：\r\n    <skill>/scripts/linkfoxai.py poll --id <task_id> --timeout 1700\r\n    解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 穿衣\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n## 脚本命令一览\r\n\r\n### 基础命令\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `material-list --type <1-10>` | 作图素材列表（可用于连通性测试） |\r\n| `upload-base64 --file <路径>` | base64 上传图片，返回 viewUrl |\r\n| `make-info --id <任务ID>` | 查询作图结果（单次） |\r\n| `poll --id <任务ID> [--interval 3] [--timeout 300]` | 轮询作图结果直到成功/失败 |\r\n| `refresh --id <图片ID> [--format jpg]` | 刷新结果图片地址（注意是图片 ID，非任务 ID） |\r\n| `api-call --path <路径> --body '<JSON>'` | 通用 API 调用，可调任意开放平台接口 |\r\n\r\n### 作图快捷命令（均支持 `--wait`）\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `change-model --image-url <url> --head-url <url> [--scene-url <url>] [--output-num 1-4]` | AI 换模特 |\r\n| `cutout --image-url <url> --sub-type <1/2/3/9/12/13> [--cloth-class tops,coat,...]` | 自动抠图 |\r\n| `scene-fission --image-url <url> [--strength 0.5] [--prompt \"描述\"] [--provider SCENE_FISSION_REALISTIC]` | 场景裂变 |\r\n| `expand-image --image-url <url> --width 1024 --height 1024 [--prompt \"描述\"]` | 智能扩图 |\r\n| `super-resolution --image-url <url> --magnification 2 [--enhance]` | 图片高清放大 |\r\n| `image-edit --image-url <url> --prompt \"描述\" [--provider BANANA_PRO/WAN2_7/SEEDREAM5] [--template 白底图]` | 智能修图 |\r\n| `erase --image-url <url> --mask-url <url>` | 消除笔 |\r\n| `sales-video --prompt \"口播文案\" --video-type WAN\\|SEED [--image-list <url1> <url2>] [--video-time 10] [--aspect-ratio 9:16] [--is-pro]` | 带货口播（WAN: 10/15秒, SEED: 5/10/15秒） |\r\n| `image-to-video --image-url <url> --video-type SEED [--prompt \"描述\"] [--video-time 10] [--is-pro] [--aspect-ratio 9:16] [--voice] [--camera single] [--prompt-optimizer]` | 图转视频（KLING/V/WAN/SEED/HAILUO），各模型参数支持详见 references/image-make.md |\r\n\r\n所有作图快捷命令均支持 `--wait [--timeout 300] [--interval 3]`，提交任务后自动轮询直到完成。\r\n\r\n### 其他能力（通过 api-call 调用）\r\n\r\n以下能力通过 `api-call --path <路径> --body '<JSON>'` 调用，接口详情见 `references/image-make.md`：\r\n\r\n| 能力 | 路径 |\r\n|------|------|\r\n| AI 换模特 2.0 | `/linkfox-ai/image/v2/make/changeModelFixed` |\r\n| 模特换场景 | `/linkfox-ai/image/v2/make/modelChangeScene` |\r\n| AI 穿衣-上下装 | `/linkfox-ai/image/v2/make/fittingRoom` |\r\n| AI 穿衣-连体衣 | `/linkfox-ai/image/v2/make/fittingRoomSuit` |\r\n| AI 穿戴 | `/linkfox-ai/image/v2/make/intelligentWear` |\r\n| 商品替换 | `/linkfox-ai/image/v2/make/shopReplace` |\r\n| 场景图生成 | `/linkfox-ai/image/v2/make/aiDraw` |\r\n| 相似图裂变 | `/linkfox-ai/image/v2/make/imageToImage` |\r\n| 精细抠图-创建 | `/linkfox-ai/v2/process/result/interactCutout/create` |\r\n| 精细抠图-结果 | `/linkfox-ai/v2/process/result/interactCutout/info` |\r\n| 图片翻译 | `/linkfox-ai/image/v3/make/imageTransl` |\r\n| 手部修复 | `/linkfox-ai/image/v2/make/handRepair` |\r\n| 局部重绘 | `/linkfox-ai/image/v2/make/areaRepair` |\r\n| 印花提取 | `/linkfox-ai/image/v2/make/printExtract` |\r\n| 手持商品 | `/linkfox-ai/image/v2/make/handHeld` |\r\n| 饰品文字 | `/linkfox-ai/image/v2/make/linkedWord` |\r\n| 商品精修 | `/linkfox-ai/image/v2/make/productRepair` |\r\n| 图片获取描述词-创建 | `/linkfox-ai/v2/process/result/imageToPrompt/create` |\r\n| 图片获取描述词-结果 | `/linkfox-ai/v2/process/result/imageToPrompt/info` |\r\n| 智能修图 | `/linkfox-ai/image/v2/make/imageEditV2` |\r\n| 智能修图-多图 | `/linkfox-ai/image/v2/make/multiImageFusionV2` |\r\n| 商品套图 | `/linkfox-ai/image/v2/make/productMarketMaterialV3` |\r\n| 服装套图 | `/linkfox-ai/image/v2/make/wearCollectionV2` |\r\n| 姿势裂变 | `/linkfox-ai/image/v2/make/modelPoseFission` |\r\n| 带货口播 | `/linkfox-ai/image/v2/make/salesVideo` |\r\n| 图转视频 | `/linkfox-ai/image/v2/make/imageToVideo` |\r\n\r\n## 连通性测试\r\n\r\n使用作图素材接口验证凭证和网络是否正常（无需上传图片）：\r\n\r\n```bash\r\n<skill>/scripts/linkfoxai.py material-list --type 1\r\n```\r\n\r\n或对 OpenClaw 说：「用 LinkFoxAI 拉取作图素材列表」。\r\n\r\n## 错误处理\r\n\r\n- 错误码（如 ERR_FORBIDDEN、ERR_NOT_HAVE_TEAM_PRIVILEGE、TEAM_PERMISSION_EXPIRE）见 `references/open-platform.md`。\r\n- 需先将应用绑定团队且团队已开通套餐。\r\n- 作图任务失败时 `status=4`，检查 `errorCode` 和 `errorMsg`。\r\n- 常见问题：参数校验失败（ERR_FILED_VALIDATE）、图片审核不通过（ERR_IMAGE_MAKE_AUDIT）、点数不足（ERR_IMAGE_MAKE_WILL_OUT）。\r\n- 若调用新增能力，需使用对应 V2/V3 路径，否则可能出现参数不兼容或能力不可用。\r\n\r\n## 参考文档\r\n\r\n- `references/open-platform.md` — 接入流程、API 基础地址、错误码\r\n- `references/image-make.md` — 全部作图接口及带货口播接口的完整参数与注意事项\r\n\r\n## 示例\r\n\r\n1. **连通性**：「用 LinkFoxAI 拉取作图素材列表」→ 脚本执行 `material-list --type 1`\r\n2. **AI 换模特**：「用 LinkFoxAI 做一次 AI 换模特，原图 xxx，头部图 xxx，出 4 张」→ `change-model --wait --output-num 4`\r\n3. **自动抠图**：「用 LinkFoxAI 把这张图抠图」→ `cutout --wait --sub-type 1`\r\n4. **智能修图**：「用 LinkFoxAI 把这张图改成白底图」→ `image-edit --wait --prompt \"白底图\" --template 白底图`（高质量：加 `--provider BANANA_PRO`）\r\n5. **带货口播**：「用 LinkFoxAI 生成一条 10 秒带货口播视频，竖版」→ `sales-video --wait --video-type WAN --video-time 10 --aspect-ratio 9:16 --prompt \"...\"`\r\n6. **带货口播(SEED)**：「用 LinkFoxAI 生成一条 SEED 15 秒口播视频」→ `sales-video --wait --video-type SEED --video-time 15 --prompt \"...\"`\r\n7. **图转视频**：「用 LinkFoxAI 把这张图生成 SEED 视频」→ `image-to-video --wait --image-url <url> --video-type SEED --video-time 10`\r\n8. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id <id>`\n\nFile v1.5.0:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ai\",\n  \"version\": \"1.5.0\",\n  \"publishedAt\": 1778157856506\n}\n\nFile v1.5.0:references/image-make.md\n\n# AI 作图 / 视频 - 全部接口完整说明\r\n\r\n本文档为 LinkFoxAI Skill 内置参考，涵盖开放平台 AI 作图/视频能力、完整参数与注意事项。\r\n\r\n所有接口均为 **POST**，请求体 **Content-Type: application/json**，响应体 application/json。\r\n\r\n---\r\n\r\n## 一、通用作图流程\r\n\r\n1. **可选**：调用「作图素材」获取预设素材地址（模特、场景等）。\r\n2. **可选**：本地图片需先调用「图片上传」得到可访问 URL。\r\n3. 调用具体作图接口，得到 **任务 ID**（`data.id`）。\r\n4. 轮询「获取作图结果」直到 `data.status` 为 3(成功) 或 4(失败)，取 `data.resultList[].url` 得到结果图。\r\n5. 结果图为**临时地址，有效期约 8 小时**；过期后调用「刷新结果图片地址」传入**图片 ID**（`resultList[].id`，非任务 ID）获取新 URL。\r\n\r\n**注意事项：**\r\n- 用户图片需外网可访问、链接稳定，建议使用国内图床（阿里云 OSS、腾讯云 COS 等）。\r\n- 作图素材地址通过「作图素材」接口获得，用作预设资源。\r\n- 本地图片上传支持 base64 编码，无需单独传 OSS。\r\n\r\n---\r\n\r\n## 二、通用响应结构\r\n\r\n所有作图创建任务接口的响应结构一致：\r\n\r\n| 参数 | 说明 | 类型 |\r\n|------|------|------|\r\n| traceId | 链路 ID | string |\r\n| code | 状态码，200 为成功 | string |\r\n| msg | 成功/错误描述 | string |\r\n| msgKey | 错误码，code 非 200 时存在 | string |\r\n| data.id | 任务 ID（用于轮询结果） | number |\r\n\r\n响应示例：\r\n```json\r\n{\"traceId\":\"f6e0fe4f360f78445c2c5d52f2414dea\",\"code\":\"200\",\"msg\":\"成功\",\"data\":{\"id\":123456}}\r\n```\r\n\r\n---\r\n\r\n## 三、作图素材\r\n\r\n**路径**：`/linkfox-ai/image/v2/material/list`\r\n\r\n**注意**：此接口可用于连通性测试，无需上传图片。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 类型：1=AI换模特-预设模特，2=模特图通用-预设场景，3=AI换模特固定脸-预设模特，4=模特图通用-场景素材，5=AI穿衣姿势-上下装素材，6=AI穿衣姿势-连体衣素材，7=AI穿戴-模特素材，8=手持商品-姿势素材，9=姿势裂变素材，10=套图-排版素材 | 是 | string |\r\n| pageNum | 页数，默认 1 | 否 | number |\r\n| pageSize | 单页条数，默认 10 | 否 | number |\r\n\r\n响应 data 含 list（url/name/tagList）、total、hasMore。\r\n\r\n```json\r\n{\"type\":\"1\"}\r\n```\r\n\r\n---\r\n\r\n## 四、图片上传\r\n\r\n### 4.1 base64 上传\r\n\r\n**路径**：`/linkfox-ai/image/v2/uploadByBase64`\r\n\r\n**注意**：全局 QPS 100（不分 IP 不分用户）。适用于没有图片存储服务或无法外网访问的场景。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（带扩展名），支持 jpeg/jpg/png/webp | 是 | string |\r\n| base64 | 图片 base64 编码，文件不超过 10MB，最长边不超过 4096 | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传后图片访问地址）。\r\n\r\n### 4.2 生成上传地址（OSS 直传）\r\n\r\n**路径**：`/linkfox-ai/image/v1/generateUploadUrl`\r\n\r\n**注意**：QPS 由阿里控制，并发能力高于 base64 方式。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（主要取后缀） | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传成功后可用地址）、policy（url/signature/policy/key/OSSAccessKeyId，用于客户端直传 OSS）。\r\n\r\n---\r\n\r\n## 五、获取作图结果\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/info`\r\n\r\n**注意**：需轮询此接口直到 status 变为 3（成功）或 4（失败）。建议轮询间隔 3-5 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 作图任务 ID | 是 | number |\r\n| format | 结果格式，目前仅支持 jpg | 否 | string |\r\n\r\n响应 data：\r\n\r\n| 字段 | 说明 | 类型 |\r\n|------|------|------|\r\n| id | 作图任务 ID | number |\r\n| status | 1=排队中 2=生成中 3=成功 4=失败 | integer |\r\n| errorCode | 错误码 | string |\r\n| errorMsg | 错误描述 | string |\r\n| resultList | 结果图片数组 | array |\r\n| resultList[].id | **图片 ID**（用于刷新地址） | number |\r\n| resultList[].status | 0=生成中 1=成功 2=失败 | integer |\r\n| resultList[].url | 高清图临时地址（有效期 8 小时） | string |\r\n| resultList[].width | 宽 | integer |\r\n| resultList[].height | 高 | integer |\r\n| resultList[].format | 格式 | string |\r\n| resultList[].size | 大小（字节） | integer |\r\n| resultList[].extendField | 扩展参数（如 maskUrl、requestId 等） | object |\r\n\r\n---\r\n\r\n## 六、刷新结果图片地址\r\n\r\n**路径**：`/linkfox-ai/image/v2/info`\r\n\r\n**注意**：ID 是**图片 ID**（resultList[].id），不是作图任务 ID。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 图片 ID | 是 | number |\r\n| downloadFormat | 下载格式，如 jpg、png | 否 | string |\r\n\r\n响应 data 含 url（新的图片访问地址）。\r\n\r\n---\r\n\r\n## 七、AI 换模特\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModel`\r\n\r\n**注意**：与 AI 换模特 2.0 的差异——生成的模特脸部更随机，使用同一个头部图，生成的模特脸部有细微变化。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelHeadImageUrl | 模特头部图。格式：jpg/jpeg/png/webp，5M 以内，最小 512x512，最大 2048x2048。或调用作图素材(type=1) | 是 | string |\r\n| sceneImgUrl | 场景参考图。格式：jpg/jpeg/png/webp，10M 以内，最小 768x768，最大 4096x4096。或调用作图素材(type=2 预设场景/type=4 场景素材)。建议使用场景素材，效果稳定 | 否 | string |\r\n| sceneStrength | 场景相似度，值越大越相似，[0,1]，默认 0.7 | 否 | string |\r\n| modelPrompt | 模特特征参数，多选用逗号拼接 | 否 | string |\r\n| customPrompt | 自定义描述，最多 600 字符 | 否 | string |\r\n| customNegPrompt | 画面中不需要的元素 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特（false 为人台），默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\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## 八、AI 换模特-2.0\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModelFixed`\r\n\r\n**注意**：与 AI 换模特的差异——生成的模特脸部更固定，使用同一个头部图，脸部变化很小。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelImageUrl | 模特头部图。或调用作图素材(type=3) | 是 | string |\r\n| sceneImgUrl | 场景图。或调用作图素材(type=4) | 否 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 九、模特换场景\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelChangeScene`\r\n\r\n**注意**：sceneImgUrl 与 scenePrompt 二选一必填。建议使用场景素材（type=4），效果稳定。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特抠图结果 | 否 | string |\r\n| sceneImgUrl | 场景图。或作图素材(type=2/4)。与 scenePrompt 二选一 | 条件 | string |\r\n| scenePrompt | 场景描述。与 sceneImgUrl 二选一 | 条件 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十、AI 穿衣-上下装\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoom`\r\n\r\n**注意**：upperOriginUrl 与 downOriginUrl 至少填一项。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| upperOriginUrl | 上衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 与下衣二选一 | string |\r\n| upperImageUrl | 上衣抠图结果 | 否 | string |\r\n| downOriginUrl | 下装原图。同上衣格式要求 | 与上衣二选一 | string |\r\n| downImageUrl | 下装抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=5) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十一、AI 穿衣-连体衣\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoomSuit`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| suitOriginUrl | 连体衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| suitImageUrl | 连体衣抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=6) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十二、AI 穿戴\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/intelligentWear`\r\n\r\n**注意**：穿戴模特原图为自定义图片时，targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 穿戴商品图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| targetOriginUrl | 穿戴模特原图。自定义地址或作图素材(type=7) | 是 | string |\r\n| targetMaskUrl | 穿戴区域图（黑白图，黑色为穿戴区域）。自定义模特图时必填 | 条件 | string |\r\n| productCategory | 商品品类，见下表 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n**商品品类字典：**\r\n\r\n| 值 | 说明 |\r\n|------|------|\r\n| footwear | 鞋靴 |\r\n| luggage | 箱包 |\r\n| eyewear | 眼镜 |\r\n| necklace | 项链 |\r\n| hat | 帽子 |\r\n| earring | 耳环 |\r\n| ring | 戒指 |\r\n| wristband | 手环手链 |\r\n| watch | 手表 |\r\n| headwear | 头饰 |\r\n| belt | 皮带 |\r\n| other | 其他 |\r\n\r\n---\r\n\r\n## 十三、商品替换\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/shopReplace`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 384x384，最大 8192x8192 | 是 | string |\r\n| sourceImageUrl | 原图的抠图结果 | 否 | string |\r\n| targetOriginUrl | 替换的目标原图 | 是 | string |\r\n| targetImageUrl | 目标原图抠图结果 | 否 | string |\r\n| denoiseStrength | 生成图变化程度，[0,1]，默认 0.5，越大变化越高 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长边不超过 4096，最短边不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传或只传一个时与原图尺寸一致 | 否 | number |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十四、场景裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/sceneFission`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| segImageUrl | 保留区域图 | 否 | string |\r\n| strength | 相似度 [0.1,1]，默认 0.5，越大越相似，浮点数小数点后一位 | 否 | string |\r\n| prompt | 强化内容描述，不传则自动提取，最长 600 字符 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长不超过 2048，最短不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传时最长边固定 1024，最短边按原图比例调整 | 否 | number |\r\n| provider | 模式：SCENE_FISSION_REALISTIC=写实（默认），SCENE_FISSION_SIMPLE=简约，SCENE_FISSION_INTELLIGENT=智能 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十五、场景图生成（AI 绘图）\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/aiDraw`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 生图描述 | 是 | string |\r\n| imageUrl | 参考图 | 否 | string |\r\n| style | 生图风格，可选：场景素材/人物素材/古韵国风/传神素描/赛博朋克/像素插画/静谧水墨/动漫线稿/新海诚/宫崎骏/CG/黑白插画/复古日漫/Q版人物/写实油画/C4D剪纸/灵韵水彩/清新日漫 | 否 | string |\r\n| scale | 宽高比，默认 1:1，可选 1:1/16:9/9:16 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十六、相似图裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToImage`\r\n\r\n**注意**：自定义尺寸（width+height）与 scale 二选一。宽高只传一个时取原图对应值。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 参考图。格式：jpg/png/webp，10M 以内，最大 4096x4096 | 是 | string |\r\n| prompt | 生图描述，不填则自动提取，最多 600 字符 | 否 | string |\r\n| weight | 相似度 [0,2]，默认 2 | 否 | integer |\r\n| width | 自定义宽度，最小 384，最大 4096 | 否 | integer |\r\n| height | 自定义高度，最小 384，最大 4096 | 否 | integer |\r\n| scale | 宽高比字符串（如 16:9），与自定义尺寸二选一 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十七、自动抠图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/cutout`\r\n\r\n**注意**：clothClass 仅在 subType=9（服饰）时生效，可多选以逗号分割，多选会合并抠图结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| subType | 抠图类型：1=通用，2=人像，3=商品，9=服饰，12=头发，13=人脸 | 是 | integer |\r\n| clothClass | 服饰抠图分类（subType=9 时生效），可多选逗号分割：tops/coat/skirt/pants/bag/shoes/hat | 否 | string |\r\n\r\n---\r\n\r\n## 十八、精细抠图-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/create`\r\n\r\n**注意**：pointList 中 x/y 为归一化坐标（0~1），isSelect 1=选中 0=不选中。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图 | 是 | string |\r\n| scoreUrl | 概率图（迭代时传入上一次返回的 scoreUrl） | 否 | string |\r\n| featureUrl | 全局分割图（同上） | 否 | string |\r\n| pointList | 点位操作列表 | 是 | array |\r\n| pointList[].x | 与左边缘距离 / 图片宽度，0~1 | 是 | number |\r\n| pointList[].y | 与上边缘距离 / 图片高度，0~1 | 是 | number |\r\n| pointList[].isSelect | 0=不选中，1=选中 | 是 | integer |\r\n\r\n---\r\n\r\n## 十九、精细抠图-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 精细抠图任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result（maskUrl/scoreUrl/imageUrl/featureUrl）。\r\n\r\n---\r\n\r\n## 二十、图片高清放大\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/superResolution`\r\n\r\n**注意**：放大后结果图最长边最大 8192。例如 3000x3000 放大 4 倍 → 8192x8192。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，最大 4096x4096 | 是 | string |\r\n| magnification | 放大倍数 [1,4]（浮点数），只高清不放大传 1 | 是 | float |\r\n| enhanceQuality | 是否高清化 | 否 | boolean |\r\n\r\n---\r\n\r\n## 二十一、智能扩图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/expandImage`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| width | 期望扩图后宽度 | 是 | number |\r\n| height | 期望扩图后高度 | 是 | number |\r\n| prompt | 提示词，最多 600 字符 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十二、图片翻译\r\n\r\n**路径**：`/linkfox-ai/image/v3/make/imageTransl`\r\n\r\n**注意**：原图最大 3000x3000，4M 以内。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，4M 以内，最小 385x385，最大 3000x3000 | 是 | string |\r\n| translationPlatform | 翻译源：deepl / chatgpt | 是 | string |\r\n| sourceLanguage | 源语种代码 | 是 | string |\r\n| targetLanguage | 目标语种代码 | 是 | string |\r\n\r\n**源语种代码：** CHS(中文)、ENG(英文)、CHT(繁体中文)、ESP(西班牙语)、JPN(日语)、KOR(韩语)、PT(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、VIN(越南语)、DEU(德语)\r\n\r\n**目标语种代码：** AR(阿拉伯语)、BG(保加利亚语)、BN(孟加拉语)、CHS(中文)、CHT(繁体中文)、CKB(中库尔德语)、CSY(捷克语)、DA(丹麦语)、DEU(德语)、EL(希腊语)、ENG(英语)、ESP(西班牙语)、ET(爱沙尼亚语)、FA(波斯语)、FI(芬兰语)、FIL(菲律宾语)、FRA(法语)、GU(古吉拉特语)、HE(希伯来语)、HI(印地语)、HR(克罗地亚语)、HUN(匈牙利语)、ID(印尼语)、ITA(意大利语)、JPN(日语)、JW(爪哇语)、KOR(韩语)、LO(老挝语)、LT(立陶宛语)、LV(拉脱维亚语)、MR(马拉地语)、MS(马来语)、MY(缅甸语)、NLD(荷兰语)、NO(挪威语)、PLK(波兰语)、PT(葡萄牙语)、PTB(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、SK(斯洛伐克语)、SL(斯洛文尼亚语)、SV(瑞典语)、SW(斯瓦希里语)、TA(泰米尔语)、TE(泰卢固语)、TG(塔吉克语)、TH(泰语)、TL(他加禄语)、TRK(土耳其语)、UK(乌克兰语)、UR(乌尔都语)、VIN(越南语)\r\n\r\n---\r\n\r\n## 二十三、手部修复\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| personType | 人物类型：0=女孩，1=男孩，2=成年女性，3=成年男性 | 是 | number |\r\n| maskUrl | 修复区域（黑白图，白色为修复区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十四、局部重绘\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/areaRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| prompt | 提示词，最多 600 字符 | 是 | string |\r\n| maskUrl | 重绘区域图（黑白图，白色为重绘区域） | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十五、印花提取\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/printExtract`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 二十六、消除笔\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/interactErase`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| maskImageUrl | 消除区域图（黑白图，白色为消除区域） | 是 | string |\r\n\r\n---\r\n\r\n## 二十七、手持商品\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handHeld`\r\n\r\n**注意**：手持姿势图为自定义图片时 targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 手持商品图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| targetOriginUrl | 手持姿势图。自定义地址或作图素材(type=8) | 是 | string |\r\n| targetMaskUrl | 手持区域图（黑白图，尺寸与姿势图一致）。自定义姿势图时必填 | 条件 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十八、饰品文字\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/linkedWord`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fontname | 字体名称（见下方列表） | 是 | string |\r\n| fontSize | 输出字体大小 | 是 | integer |\r\n| left | 左边加环，默认 false | 否 | boolean |\r\n| right | 右边加环，默认 false | 否 | boolean |\r\n| prompt | 饰品文字内容 | 是 | string |\r\n\r\n**可选字体：** Caitlyn、ItaliannoRob、Alison、ALSScript、WhiteAngelica、Milkshake、ScriptMTBold、PassionsConflictROB、Sacramento、Cervanttis、Notera 2 PERSONAL USE ONLY、UyghurMerdane、OldEnglishText、Halimun、AlexBrush、Scriptina、CounselorScript、EliannaBoldItalic、AutumnChant、MagnoliaScript\r\n\r\n---\r\n\r\n## 二十九、商品精修\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/productRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 三十、图片获取描述词-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/create`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 应用类型：5=相似图裂变，13=场景裂变，69=穿衣套图卖点分析，71=商品套图卖点分析 | 是 | string |\r\n| imageUrlList | 图片地址列表（只有套图卖点分析支持多张） | 是 | List\\<string\\> |\r\n| keyword | 关键字。场景裂变时有效；套图卖点分析时可传入商品信息 | 否 | string |\r\n| provider | 套图模式提取类型：API_PRE_POINT=卖点分析（默认），API_LAYOUT_DESC=排版描述 | 否 | string |\r\n\r\n---\r\n\r\n## 三十一、图片获取描述词-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result.content（描述词文本）。\r\n\r\n---\r\n\r\n## 三十二、智能修图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/imageEditV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `imageEditV2`。\r\n- 旧版 `imageEdit` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。支持 jpg/jpeg/png/webp；尺寸 300x300 ~ 4096x4096；宽高比 0.4 ~ 2.5 | 是 | string |\r\n| prompt | 提示词 | 是 | string |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 / GPT_2_IMAGE / AIDRAW_EDIT | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO / GPT_2_IMAGE 默认 2K，其余默认 1K。WAN2_7 / AIDRAW_EDIT 不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十三、智能修图-多图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/multiImageFusionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `multiImageFusionV2`。\r\n- 旧版 `multiImageFusion` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 图片列表。支持 jpg/jpeg/png/webp（10M 以内），最小 800x800，最大 4096x4096。限制:BANANA<=3张、WAN2_7 / AIDRAW_EDIT <=4张、其余<=6张 | 是 | array[string] |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 / GPT_2_IMAGE / AIDRAW_EDIT | 是 | string |\r\n| prompt | 强化内容描述（100 字以内） | 否 | string |\r\n| outputNum | 输出张数，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO / GPT_2_IMAGE 默认 2K，其余默认 1K。WAN2_7 / AIDRAW_EDIT 不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false。仅 BANANA_PRO 支持 | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十四、商品套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/productMarketMaterialV3`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `productMarketMaterialV3`。\r\n- 旧版 `productMarketMaterialV2` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 800x800，最大 4096x4096，10M 以内。\r\n- 各类型数量（aPlusNum/sellerTypeNum/sceneTypeNum 等）单项最大 8。\r\n- aPlusStyles/pointStyles 传入时，数量需与目标生成数量一致。\r\n- brandKey 为 JSON 对象，总长度不超过 1000 字符。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| sellerTypeNum | 卖点图 | sellPoint |\r\n| sceneTypeNum | 场景图 | scene |\r\n| closeUpTypeNum | 特写图 | closeUp |\r\n| closeUpWhiteTypeNum | 白底特写图 | closeUpWhite |\r\n| whiteBgTypeNum | 白底图 | whiteBg |\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代）/ WAN2_7（万相2.7）/ GPT_2_IMAGE（GPT图片2） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量（Pro），默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+（基于高级 A+ 结果），默认 false | 否 | boolean |\r\n| aPlusAspectRatio | 自定义 A+ 宽高比（仅高级 A+ 场景使用），如 16:9/9:16/1:1 | 否 | string |\r\n| aPlusStyles | A+ 排版列表，id（风格 id，通过作图素材接口获取）或 prompt（排版词，通过排版描述接口获取） | 否 | List |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| sceneTypeNum | 场景图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpTypeNum | 特写图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpWhiteTypeNum | 白底特写图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteBgTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON：brandColor(#RRGGBB)/fontStyle/salesRegion/language/platform/customSettings | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十五、服装套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/wearCollectionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `wearCollectionV2`。\r\n- 旧版 `wearCollection` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 384x384，最大 4096x4096，10M 以内。\r\n- sellerPoint 建议包含面料、卖点、目标人群、使用场景、尺码等信息，有助于提升结果质量。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| modelTypeNum | **模特+场景合成图**（非纯模特图） | **scene** |\r\n| insTypeNum | 种草图 | ins |\r\n| sellerTypeNum | 卖点图 | point |\r\n| sizeTypeNum | 尺码图 | size |\r\n| whiteTypeNum | 白底图 | white |\r\n\r\n> **⚠️ 特别说明**：`modelTypeNum` 生成的是**模特穿上服装并置于场景中的合成图**，输出 type 为 `scene`，而非 `model`。命名虽含 \"model\"，但产出是模特+场景的完整合成结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代）/ WAN2_7（万相2.7）/ GPT_2_IMAGE（GPT图片2） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+，默认 false | 否 | boolean |\r\n| aPlusAspectRatio | A+ 宽高比 | 否 | string |\r\n| aPlusStyles | A+ 排版列表（id 或 prompt） | 否 | List |\r\n| modelTypeNum | **模特+场景合成图**数量（输出 type=`scene`），默认 0，最大 8 | 否 | integer |\r\n| ↳ modelImageUrl | 模特参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ sceneImageUrl | 场景参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ isExactScene | 场景裂变模式：true=遵循背景（默认），false=相似裂变。**仅 modelTypeNum > 0 时生效** | 否 | boolean |\r\n| ↳ modelAndSceneInfo | 描述想要的场景内容和模特特征。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| insTypeNum | 种草图数量，默认 0，最大 8 | 否 | integer |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| sizeTypeNum | 尺码图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON（同商品套图） | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n| quality | 输出品质：low / medium / high，仅 GPT_2_IMAGE 生效，默认 medium | 否 | string |\r\n\r\n---\r\n\r\n## 三十六、姿势裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelPoseFission`\r\n\r\n**注意**：postureUrl（素材 type=9）与 prompt 二选一。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 图片地址。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| prompt | 自定义姿势描述。与 postureUrl 二选一 | 否 | string |\r\n| postureUrl | 姿势图片 URL。作图素材(type=9)或自定义。与 prompt 二选一 | 否 | string |\r\n| outputNum | 输出数量 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 三十七、带货口播\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/salesVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID（`taskId`），需继续轮询「获取作图结果」接口查询最终资源。\r\n- `prompt` 建议包含商品卖点、目标人群、使用场景和行动指令，以提升口播质量。\r\n- `imageList` 传入商品主图/细节图通常能提升视频一致性和转化表达。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 口播脚本/提示词 | 是 | string |\r\n| imageList | 参考图 URL 列表（建议 1~6 张） | 否 | array[string] |\r\n| videoType | 模型类型：WAN / SEED（seed = seedance） | 是 | string |\r\n| videoTime | 视频时长（秒）。WAN: 10/15秒；SEED: 5/10/15秒 | 否 | number |\r\n| isPro | 是否开启高质量模式 | 否 | boolean |\r\n| aspectRatio | 视频比例：16:9 / 9:16 / 1:1 | 否 | string |\r\n\r\n---\r\n\r\n## 三十八、图转视频\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID，需继续轮询「获取作图结果」接口查询最终视频地址。\r\n- 不同模型支持的参数和时长不同，详见下方「各模型参数支持情况」。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图地址。格式：jpg/jpeg/png/webp | 是 | string |\r\n| videoType | 模型类型：KLING（可灵）/ V（电影/Veo）/ WAN（万相）/ SEED（Seedance/豆包）/ HAILUO（海螺） | 是 | string |\r\n| videoTime | 视频时长（秒），不同类型支持的时长不同，见下方对照 | 是 | number |\r\n| prompt | 视频提示词（2000 字以内） | 否 | string |\r\n| promptOptimizer | 是否开启提示词优化：true/false，默认 false | 否 | boolean |\r\n| isPro | 是否开启高质量/Pro 模式，默认 false | 否 | boolean |\r\n| voice | 是否生成声音：true/false，默认 false | 否 | boolean |\r\n| lastFrameImageUrl | 尾帧图地址（用于控制视频结束帧画面） | 否 | string |\r\n| aspectRatio | 视频比例：16:9 / 9:16 | 否 | string |\r\n| camera | 运镜参数：single（单镜头）/ multi（多镜头） | 否 | string |\r\n\r\n**各模型参数支持情况：**\r\n\r\n| 参数 | KLING（可灵） | V（电影/Veo） | WAN（万相） | SEED（Seedance/豆包） | HAILUO（海螺） |\r\n|------|:---:|:---:|:---:|:---:|:---:|\r\n| videoTime（时长） | 5 / 10 秒 | 4 / 8 秒 | 10 / 15 秒 | 5 / 10 / 15 秒 | 6 / 10 秒 |\r\n| prompt（提示词） | 支持 | 支持 | 支持 | 支持 | 支持 |\r\n| promptOptimizer（提示词优化） | 支持 | 支持 | 支持 | 支持 | 支持 |\r\n| isPro（Pro 模式） | 支持 | 支持 | - | 支持 | 支持 |\r\n| voice（生成声音） | - | - | 支持 | 支持 | - |\r\n| lastFrameImageUrl（尾帧图） | 支持 | 支持 | 支持 | 支持 | 支持 |\r\n| aspectRatio（视频比例） | 传入不生效 | 16:9 / 9:16，未传默认 9:16 | 16:9 / 9:16 | 16:9 / 9:16 | 传入不生效 |\r\n| camera（运镜） | - | - | single / multi | - | - |\n\nFile v1.5.0:references/open-platform.md\n\n# LinkFox AI 开放平台 - 接入与错误码\r\n\r\n## 接入流程\r\n\r\n1. 注册紫鸟开放平台：https://open.ziniao.com  \r\n2. 认证开发者，创建 LinkFox 卖家应用：https://open.ziniao.com/docSupport?docId=116  \r\n3. 将应用绑定到团队：https://www.linkfox.com/team/api-guide  \r\n4. 鉴权方式以官方文档为准：[API 调用指南 - 简单通用模式（推荐）](https://open.ziniao.com/docSupport?docId=233)\r\n\r\n## API 基础地址\r\n\r\n- 默认：`https://sbappstoreapi.ziniao.com/openapi-router`  \r\n- 路径前缀：`/linkfox-ai`  \r\n- 无固定 IP 时可使用代理：`https://sbappstoreapi-proxy.linkfox.com`（需配置白名单 IP：120.79.189.15）\r\n\r\n## 响应外层结构\r\n\r\n所有接口的响应均由开放平台包装了一层外层结构，实际业务数据在 `data` 字段中。\r\n\r\n```json\r\n{\r\n  \"request_id\": \"abc123\",\r\n  \"code\": 0,\r\n  \"msg\": \"success\",\r\n  \"data\": {\r\n    // 此处为业务接口的实际响应体\r\n    \"traceId\": \"...\",\r\n    \"code\": \"200\",\r\n    \"msg\": \"成功\",\r\n    \"data\": { /* 业务数据 */ }\r\n  }\r\n}\r\n```\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| request_id | 开放平台请求 ID |\r\n| code | 开放平台状态码，0 为成功 |\r\n| msg | 开放平台消息 |\r\n| data | 业务接口实际响应（内部有自己的 traceId/code/msg/data） |\r\n\r\n即实际数据嵌套路径为：`响应.data.data`（外层 data 是开放平台包装，内层 data 是业务数据）。\r\n\r\n## QPS / 限流说明\r\n\r\n- **base64 上传接口** (`/linkfox-ai/image/v2/uploadByBase64`)：全局限流 100 QPS。\r\n- **其他接口**：默认无严格 QPS 限制，但建议单应用并发不超过 50 QPS。\r\n- 触发限流时返回 HTTP 429 或开放平台错误码。\r\n- 作图任务提交后需轮询 `make-info` 获取结果，建议轮询间隔 ≥ 3 秒。\r\n\r\n## 错误码\r\n\r\n| 错误码 | 描述 |\r\n| --- | --- |\r\n| ERR_FILED_VALIDATE | 参数校验异常 |\r\n| ERR_VALIDATE_FAIL | 参数校验异常 |\r\n| ERR_IMAGE_MAKE_AUDIT | 图片审核不通过 |\r\n| ERR_IMAGE_MAKE_WILL_OUT | 作图点数不足 |\r\n| ERR_FORBIDDEN | 没有ID权限，ID取错也有可能 |\r\n| ERR_NOT_HAVE_TEAM_PRIVILEGE | 未绑定团队 |\r\n| TEAM_PERMISSION_DISABLE_USER | 被禁用 |\r\n| ERR_IMAGE_MAKE_COUNT_MAX | 生成中创建上限 |\r\n| TEAM_PERMISSION_EXPIRE | 套餐已过期或者未购买套餐 |\r\n\r\n更多说明见开放平台 https://open.ziniao.com 或本 skill 内 `references/image-make.md`。\n\nFile v1.5.0:skill-card.md\n\n## Description: <br>\nLinkFoxAI lets agents call LinkFox AI Open Platform image and video APIs for model replacement, cutouts, image expansion, scene variation, image editing, product image sets, sales videos, image-to-video generation, task polling, and connectivity checks. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and agent users use this skill to create, poll, and retrieve LinkFox AI media-generation tasks from an agent workflow. It is suited for authenticated image and video production workflows that need scripted API calls, upload support, and result handling. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uses sensitive LinkFox credentials and can make authenticated API calls. <br>\nMitigation: Install only for trusted workflows, provide the minimum required API key, and review generated commands before execution. <br>\nRisk: The generic api-call command can invoke broad LinkFox Open Platform endpoints beyond the shortcut commands. <br>\nMitigation: Prefer dedicated media commands when possible and review api-call paths and JSON bodies before running them. <br>\nRisk: Prompts, images, uploaded files, and generated media URLs may be sent to or exposed through external LinkFox services. <br>\nMitigation: Do not submit sensitive or regulated media unless authorized, and treat uploaded or generated URLs as externally accessible. <br>\nRisk: Media-generation jobs may run for an extended time or time out while queued. <br>\nMitigation: Run long generation tasks in background sessions, use bounded polling timeouts, and preserve task IDs for later status checks. <br>\n\n\n## Reference(s): <br>\n- [AI Image and Video API Reference](references/image-make.md) <br>\n- [LinkFox AI Open Platform Access and Error Codes](references/open-platform.md) <br>\n- [LinkFox Team API Guide](https://www.linkfox.com/team/api-guide) <br>\n- [Ziniao Open Platform](https://open.ziniao.com) <br>\n- [API Call Guide - Simple Common Mode](https://open.ziniao.com/docSupport?docId=233) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Shell commands, API Calls, JSON, Markdown, Configuration instructions, Guidance] <br>\n**Output Format:** [Markdown guidance with shell commands and JSON API responses] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include task IDs, polling status, generated media URLs, refreshed result URLs, and error messages returned by the LinkFox API.] <br>\n\n## Skill Version(s): <br>\n1.5.0 (source: server release metadata and artifact _meta.json) <br>\n\n## Ethical Considerations: <br>\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. <br>\n\nArchive v1.3.0: 5 files, 21937 bytes\n\nFiles: _meta.json (129b), references/image-make.md (34907b), references/open-platform.md (2433b), scripts/linkfoxai.py (23454b), SKILL.md (10641b)\n\nFile v1.3.0:SKILL.md\n\n---\r\nname: linkfoxai\r\ndescription: \"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🦊\",\"requires\":{\"env\":[\"LINKFOXAI_API_KEY\"]}}}\r\n---\r\n\r\n# LinkFoxAI - LinkFox AI 开放平台 Skill\r\n\r\nLinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播、图转视频等。\r\n\r\n## 配置\r\n\r\n1. **获取凭证**：注册 [紫鸟开放平台](https://open.ziniao.com)，认证开发者并创建 LinkFox 卖家应用，然后在 [linkfox.com/team/api-guide](https://www.linkfox.com/team/api-guide) 将应用绑定到团队，获取 API Key。\r\n2. **环境变量**：`LINKFOXAI_API_KEY`（单一 API Key，配置一个 Key 即可调用全部接口）\r\n3. **自定义 Base URL**（可选）：默认 `https://sbappstoreapi.ziniao.com/openapi-router`。若无固定 IP，设置 `LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com` 并配置白名单。\r\n\r\n## 必须使用 sessions_spawn 调度作图任务\r\n\r\nAI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，**极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟**）。**务必通过 `sessions_spawn` 将作图任务派发到子会话**，让主会话保持响应。脚本的 `--wait` 参数会自动轮询直到出结果。\r\n\r\n### 超时处理策略（AI 自行判断）\r\n\r\n当作图任务超时（`--timeout` 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r\n\r\n1. **延长轮询时间**：将 `--timeout` 增大到 1800（30 分钟），`--interval` 建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r\n2. **告知用户并继续后台等待**：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r\n3. **任务分拆重试**：若任务参数含多图（如 `--output-num 4`），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r\n4. **放弃并报错**：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r\n\r\n> 默认建议：将 `sessions_spawn` 的 `runTimeoutSeconds` 设为 **1800**，`--timeout` 设为 **1700**，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r\n\r\n### 标准调度模板\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\\r\n         --image-url \"<模特原图>\" --head-url \"<头部图>\" --output-num 4\r\n    解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r\n    如果 status=4（失败），报告 errorMsg。\r\n    如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 换模特\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n  cleanup: \"keep\"\r\n```\r\n\r\n### 并行调度多个独立任务\r\n\r\n```\r\n# 子任务 1\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '<url>' --sub-type 1 ...\"\r\n  label: \"LinkFoxAI: 自动抠图\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n\r\n# 子任务 2\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '<url>' ...\"\r\n  label: \"LinkFoxAI: 场景裂变\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n### 通用接口调用（api-call）\r\n\r\n对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py api-call \\\r\n         --path /linkfox-ai/image/v2/make/fittingRoom \\\r\n         --body '{\"upperOriginUrl\":\"<上衣图>\",\"modelImageUrl\":\"<模特图>\",\"outputNum\":2}'\r\n    获取返回的 data.id，然后运行：\r\n    <skill>/scripts/linkfoxai.py poll --id <task_id> --timeout 1700\r\n    解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 穿衣\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n## 脚本命令一览\r\n\r\n### 基础命令\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `material-list --type <1-10>` | 作图素材列表（可用于连通性测试） |\r\n| `upload-base64 --file <路径>` | base64 上传图片，返回 viewUrl |\r\n| `make-info --id <任务ID>` | 查询作图结果（单次） |\r\n| `poll --id <任务ID> [--interval 3] [--timeout 300]` | 轮询作图结果直到成功/失败 |\r\n| `refresh --id <图片ID> [--format jpg]` | 刷新结果图片地址（注意是图片 ID，非任务 ID） |\r\n| `api-call --path <路径> --body '<JSON>'` | 通用 API 调用，可调任意开放平台接口 |\r\n\r\n### 作图快捷命令（均支持 `--wait`）\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `change-model --image-url <url> --head-url <url> [--scene-url <url>] [--output-num 1-4]` | AI 换模特 |\r\n| `cutout --image-url <url> --sub-type <1/2/3/9/12/13> [--cloth-class tops,coat,...]` | 自动抠图 |\r\n| `scene-fission --image-url <url> [--strength 0.5] [--prompt \"描述\"] [--provider SCENE_FISSION_REALISTIC]` | 场景裂变 |\r\n| `expand-image --image-url <url> --width 1024 --height 1024 [--prompt \"描述\"]` | 智能扩图 |\r\n| `super-resolution --image-url <url> --magnification 2 [--enhance]` | 图片高清放大 |\r\n| `image-edit --image-url <url> --prompt \"描述\" [--provider BANANA_PRO/WAN2_7/SEEDREAM5] [--template 白底图]` | 智能修图 |\r\n| `erase --image-url <url> --mask-url <url>` | 消除笔 |\r\n| `sales-video --prompt \"口播文案\" --video-type WAN\\|SEED [--image-list <url1> <url2>] [--video-time 10] [--aspect-ratio 9:16] [--is-pro]` | 带货口播（WAN: 10/15秒, SEED: 5/10/15秒） |\r\n| `image-to-video --image-url <url> --video-type SEED [--prompt \"描述\"] [--video-time 10] [--is-pro] [--aspect-ratio 9:16]` | 图转视频（KLING/V/WAN/SEED/HAILUO） |\r\n\r\n所有作图快捷命令均支持 `--wait [--timeout 300] [--interval 3]`，提交任务后自动轮询直到完成。\r\n\r\n### 其他能力（通过 api-call 调用）\r\n\r\n以下能力通过 `api-call --path <路径> --body '<JSON>'` 调用，接口详情见 `references/image-make.md`：\r\n\r\n| 能力 | 路径 |\r\n|------|------|\r\n| AI 换模特 2.0 | `/linkfox-ai/image/v2/make/changeModelFixed` |\r\n| 模特换场景 | `/linkfox-ai/image/v2/make/modelChangeScene` |\r\n| AI 穿衣-上下装 | `/linkfox-ai/image/v2/make/fittingRoom` |\r\n| AI 穿衣-连体衣 | `/linkfox-ai/image/v2/make/fittingRoomSuit` |\r\n| AI 穿戴 | `/linkfox-ai/image/v2/make/intelligentWear` |\r\n| 商品替换 | `/linkfox-ai/image/v2/make/shopReplace` |\r\n| 场景图生成 | `/linkfox-ai/image/v2/make/aiDraw` |\r\n| 相似图裂变 | `/linkfox-ai/image/v2/make/imageToImage` |\r\n| 精细抠图-创建 | `/linkfox-ai/v2/process/result/interactCutout/create` |\r\n| 精细抠图-结果 | `/linkfox-ai/v2/process/result/interactCutout/info` |\r\n| 图片翻译 | `/linkfox-ai/image/v3/make/imageTransl` |\r\n| 手部修复 | `/linkfox-ai/image/v2/make/handRepair` |\r\n| 局部重绘 | `/linkfox-ai/image/v2/make/areaRepair` |\r\n| 印花提取 | `/linkfox-ai/image/v2/make/printExtract` |\r\n| 手持商品 | `/linkfox-ai/image/v2/make/handHeld` |\r\n| 饰品文字 | `/linkfox-ai/image/v2/make/linkedWord` |\r\n| 商品精修 | `/linkfox-ai/image/v2/make/productRepair` |\r\n| 图片获取描述词-创建 | `/linkfox-ai/v2/process/result/imageToPrompt/create` |\r\n| 图片获取描述词-结果 | `/linkfox-ai/v2/process/result/imageToPrompt/info` |\r\n| 智能修图 | `/linkfox-ai/image/v2/make/imageEditV2` |\r\n| 智能修图-多图 | `/linkfox-ai/image/v2/make/multiImageFusionV2` |\r\n| 商品套图 | `/linkfox-ai/image/v2/make/productMarketMaterialV3` |\r\n| 服装套图 | `/linkfox-ai/image/v2/make/wearCollectionV2` |\r\n| 姿势裂变 | `/linkfox-ai/image/v2/make/modelPoseFission` |\r\n| 带货口播 | `/linkfox-ai/image/v2/make/salesVideo` |\r\n| 图转视频 | `/linkfox-ai/image/v2/make/imageToVideo` |\r\n\r\n## 连通性测试\r\n\r\n使用作图素材接口验证凭证和网络是否正常（无需上传图片）：\r\n\r\n```bash\r\n<skill>/scripts/linkfoxai.py material-list --type 1\r\n```\r\n\r\n或对 OpenClaw 说：「用 LinkFoxAI 拉取作图素材列表」。\r\n\r\n## 错误处理\r\n\r\n- 错误码（如 ERR_FORBIDDEN、ERR_NOT_HAVE_TEAM_PRIVILEGE、TEAM_PERMISSION_EXPIRE）见 `references/open-platform.md`。\r\n- 需先将应用绑定团队且团队已开通套餐。\r\n- 作图任务失败时 `status=4`，检查 `errorCode` 和 `errorMsg`。\r\n- 常见问题：参数校验失败（ERR_FILED_VALIDATE）、图片审核不通过（ERR_IMAGE_MAKE_AUDIT）、点数不足（ERR_IMAGE_MAKE_WILL_OUT）。\r\n- 若调用新增能力，需使用对应 V2/V3 路径，否则可能出现参数不兼容或能力不可用。\r\n\r\n## 参考文档\r\n\r\n- `references/open-platform.md` — 接入流程、API 基础地址、错误码\r\n- `references/image-make.md` — 全部作图接口及带货口播接口的完整参数与注意事项\r\n\r\n## 示例\r\n\r\n1. **连通性**：「用 LinkFoxAI 拉取作图素材列表」→ 脚本执行 `material-list --type 1`\r\n2. **AI 换模特**：「用 LinkFoxAI 做一次 AI 换模特，原图 xxx，头部图 xxx，出 4 张」→ `change-model --wait --output-num 4`\r\n3. **自动抠图**：「用 LinkFoxAI 把这张图抠图」→ `cutout --wait --sub-type 1`\r\n4. **智能修图**：「用 LinkFoxAI 把这张图改成白底图」→ `image-edit --wait --prompt \"白底图\" --template 白底图`（高质量：加 `--provider BANANA_PRO`）\r\n5. **带货口播**：「用 LinkFoxAI 生成一条 10 秒带货口播视频，竖版」→ `sales-video --wait --video-type WAN --video-time 10 --aspect-ratio 9:16 --prompt \"...\"`\r\n6. **带货口播(SEED)**：「用 LinkFoxAI 生成一条 SEED 15 秒口播视频」→ `sales-video --wait --video-type SEED --video-time 15 --prompt \"...\"`\r\n7. **图转视频**：「用 LinkFoxAI 把这张图生成 SEED 视频」→ `image-to-video --wait --image-url <url> --video-type SEED --video-time 10`\r\n8. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id <id>`\n\nFile v1.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ai\",\n  \"version\": \"1.3.0\",\n  \"publishedAt\": 1775740961544\n}\n\nFile v1.3.0:references/image-make.md\n\n# AI 作图 / 视频 - 全部接口完整说明\r\n\r\n本文档为 LinkFoxAI Skill 内置参考，涵盖开放平台 AI 作图/视频能力、完整参数与注意事项。\r\n\r\n所有接口均为 **POST**，请求体 **Content-Type: application/json**，响应体 application/json。\r\n\r\n---\r\n\r\n## 一、通用作图流程\r\n\r\n1. **可选**：调用「作图素材」获取预设素材地址（模特、场景等）。\r\n2. **可选**：本地图片需先调用「图片上传」得到可访问 URL。\r\n3. 调用具体作图接口，得到 **任务 ID**（`data.id`）。\r\n4. 轮询「获取作图结果」直到 `data.status` 为 3(成功) 或 4(失败)，取 `data.resultList[].url` 得到结果图。\r\n5. 结果图为**临时地址，有效期约 8 小时**；过期后调用「刷新结果图片地址」传入**图片 ID**（`resultList[].id`，非任务 ID）获取新 URL。\r\n\r\n**注意事项：**\r\n- 用户图片需外网可访问、链接稳定，建议使用国内图床（阿里云 OSS、腾讯云 COS 等）。\r\n- 作图素材地址通过「作图素材」接口获得，用作预设资源。\r\n- 本地图片上传支持 base64 编码，无需单独传 OSS。\r\n\r\n---\r\n\r\n## 二、通用响应结构\r\n\r\n所有作图创建任务接口的响应结构一致：\r\n\r\n| 参数 | 说明 | 类型 |\r\n|------|------|------|\r\n| traceId | 链路 ID | string |\r\n| code | 状态码，200 为成功 | string |\r\n| msg | 成功/错误描述 | string |\r\n| msgKey | 错误码，code 非 200 时存在 | string |\r\n| data.id | 任务 ID（用于轮询结果） | number |\r\n\r\n响应示例：\r\n```json\r\n{\"traceId\":\"f6e0fe4f360f78445c2c5d52f2414dea\",\"code\":\"200\",\"msg\":\"成功\",\"data\":{\"id\":123456}}\r\n```\r\n\r\n---\r\n\r\n## 三、作图素材\r\n\r\n**路径**：`/linkfox-ai/image/v2/material/list`\r\n\r\n**注意**：此接口可用于连通性测试，无需上传图片。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 类型：1=AI换模特-预设模特，2=模特图通用-预设场景，3=AI换模特固定脸-预设模特，4=模特图通用-场景素材，5=AI穿衣姿势-上下装素材，6=AI穿衣姿势-连体衣素材，7=AI穿戴-模特素材，8=手持商品-姿势素材，9=姿势裂变素材，10=套图-排版素材 | 是 | string |\r\n| pageNum | 页数，默认 1 | 否 | number |\r\n| pageSize | 单页条数，默认 10 | 否 | number |\r\n\r\n响应 data 含 list（url/name/tagList）、total、hasMore。\r\n\r\n```json\r\n{\"type\":\"1\"}\r\n```\r\n\r\n---\r\n\r\n## 四、图片上传\r\n\r\n### 4.1 base64 上传\r\n\r\n**路径**：`/linkfox-ai/image/v2/uploadByBase64`\r\n\r\n**注意**：全局 QPS 100（不分 IP 不分用户）。适用于没有图片存储服务或无法外网访问的场景。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（带扩展名），支持 jpeg/jpg/png/webp | 是 | string |\r\n| base64 | 图片 base64 编码，文件不超过 10MB，最长边不超过 4096 | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传后图片访问地址）。\r\n\r\n### 4.2 生成上传地址（OSS 直传）\r\n\r\n**路径**：`/linkfox-ai/image/v1/generateUploadUrl`\r\n\r\n**注意**：QPS 由阿里控制，并发能力高于 base64 方式。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（主要取后缀） | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传成功后可用地址）、policy（url/signature/policy/key/OSSAccessKeyId，用于客户端直传 OSS）。\r\n\r\n---\r\n\r\n## 五、获取作图结果\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/info`\r\n\r\n**注意**：需轮询此接口直到 status 变为 3（成功）或 4（失败）。建议轮询间隔 3-5 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 作图任务 ID | 是 | number |\r\n| format | 结果格式，目前仅支持 jpg | 否 | string |\r\n\r\n响应 data：\r\n\r\n| 字段 | 说明 | 类型 |\r\n|------|------|------|\r\n| id | 作图任务 ID | number |\r\n| status | 1=排队中 2=生成中 3=成功 4=失败 | integer |\r\n| errorCode | 错误码 | string |\r\n| errorMsg | 错误描述 | string |\r\n| resultList | 结果图片数组 | array |\r\n| resultList[].id | **图片 ID**（用于刷新地址） | number |\r\n| resultList[].status | 0=生成中 1=成功 2=失败 | integer |\r\n| resultList[].url | 高清图临时地址（有效期 8 小时） | string |\r\n| resultList[].width | 宽 | integer |\r\n| resultList[].height | 高 | integer |\r\n| resultList[].format | 格式 | string |\r\n| resultList[].size | 大小（字节） | integer |\r\n| resultList[].extendField | 扩展参数（如 maskUrl、requestId 等） | object |\r\n\r\n---\r\n\r\n## 六、刷新结果图片地址\r\n\r\n**路径**：`/linkfox-ai/image/v2/info`\r\n\r\n**注意**：ID 是**图片 ID**（resultList[].id），不是作图任务 ID。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 图片 ID | 是 | number |\r\n| downloadFormat | 下载格式，如 jpg、png | 否 | string |\r\n\r\n响应 data 含 url（新的图片访问地址）。\r\n\r\n---\r\n\r\n## 七、AI 换模特\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModel`\r\n\r\n**注意**：与 AI 换模特 2.0 的差异——生成的模特脸部更随机，使用同一个头部图，生成的模特脸部有细微变化。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelHeadImageUrl | 模特头部图。格式：jpg/jpeg/png/webp，5M 以内，最小 512x512，最大 2048x2048。或调用作图素材(type=1) | 是 | string |\r\n| sceneImgUrl | 场景参考图。格式：jpg/jpeg/png/webp，10M 以内，最小 768x768，最大 4096x4096。或调用作图素材(type=2 预设场景/type=4 场景素材)。建议使用场景素材，效果稳定 | 否 | string |\r\n| sceneStrength | 场景相似度，值越大越相似，[0,1]，默认 0.7 | 否 | string |\r\n| modelPrompt | 模特特征参数，多选用逗号拼接 | 否 | string |\r\n| customPrompt | 自定义描述，最多 600 字符 | 否 | string |\r\n| customNegPrompt | 画面中不需要的元素 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特（false 为人台），默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\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## 八、AI 换模特-2.0\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModelFixed`\r\n\r\n**注意**：与 AI 换模特的差异——生成的模特脸部更固定，使用同一个头部图，脸部变化很小。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelImageUrl | 模特头部图。或调用作图素材(type=3) | 是 | string |\r\n| sceneImgUrl | 场景图。或调用作图素材(type=4) | 否 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 九、模特换场景\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelChangeScene`\r\n\r\n**注意**：sceneImgUrl 与 scenePrompt 二选一必填。建议使用场景素材（type=4），效果稳定。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特抠图结果 | 否 | string |\r\n| sceneImgUrl | 场景图。或作图素材(type=2/4)。与 scenePrompt 二选一 | 条件 | string |\r\n| scenePrompt | 场景描述。与 sceneImgUrl 二选一 | 条件 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十、AI 穿衣-上下装\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoom`\r\n\r\n**注意**：upperOriginUrl 与 downOriginUrl 至少填一项。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| upperOriginUrl | 上衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 与下衣二选一 | string |\r\n| upperImageUrl | 上衣抠图结果 | 否 | string |\r\n| downOriginUrl | 下装原图。同上衣格式要求 | 与上衣二选一 | string |\r\n| downImageUrl | 下装抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=5) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十一、AI 穿衣-连体衣\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoomSuit`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| suitOriginUrl | 连体衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| suitImageUrl | 连体衣抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=6) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十二、AI 穿戴\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/intelligentWear`\r\n\r\n**注意**：穿戴模特原图为自定义图片时，targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 穿戴商品图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| targetOriginUrl | 穿戴模特原图。自定义地址或作图素材(type=7) | 是 | string |\r\n| targetMaskUrl | 穿戴区域图（黑白图，黑色为穿戴区域）。自定义模特图时必填 | 条件 | string |\r\n| productCategory | 商品品类，见下表 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n**商品品类字典：**\r\n\r\n| 值 | 说明 |\r\n|------|------|\r\n| footwear | 鞋靴 |\r\n| luggage | 箱包 |\r\n| eyewear | 眼镜 |\r\n| necklace | 项链 |\r\n| hat | 帽子 |\r\n| earring | 耳环 |\r\n| ring | 戒指 |\r\n| wristband | 手环手链 |\r\n| watch | 手表 |\r\n| headwear | 头饰 |\r\n| belt | 皮带 |\r\n| other | 其他 |\r\n\r\n---\r\n\r\n## 十三、商品替换\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/shopReplace`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 384x384，最大 8192x8192 | 是 | string |\r\n| sourceImageUrl | 原图的抠图结果 | 否 | string |\r\n| targetOriginUrl | 替换的目标原图 | 是 | string |\r\n| targetImageUrl | 目标原图抠图结果 | 否 | string |\r\n| denoiseStrength | 生成图变化程度，[0,1]，默认 0.5，越大变化越高 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长边不超过 4096，最短边不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传或只传一个时与原图尺寸一致 | 否 | number |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十四、场景裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/sceneFission`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| segImageUrl | 保留区域图 | 否 | string |\r\n| strength | 相似度 [0.1,1]，默认 0.5，越大越相似，浮点数小数点后一位 | 否 | string |\r\n| prompt | 强化内容描述，不传则自动提取，最长 600 字符 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长不超过 2048，最短不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传时最长边固定 1024，最短边按原图比例调整 | 否 | number |\r\n| provider | 模式：SCENE_FISSION_REALISTIC=写实（默认），SCENE_FISSION_SIMPLE=简约，SCENE_FISSION_INTELLIGENT=智能 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十五、场景图生成（AI 绘图）\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/aiDraw`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 生图描述 | 是 | string |\r\n| imageUrl | 参考图 | 否 | string |\r\n| style | 生图风格，可选：场景素材/人物素材/古韵国风/传神素描/赛博朋克/像素插画/静谧水墨/动漫线稿/新海诚/宫崎骏/CG/黑白插画/复古日漫/Q版人物/写实油画/C4D剪纸/灵韵水彩/清新日漫 | 否 | string |\r\n| scale | 宽高比，默认 1:1，可选 1:1/16:9/9:16 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十六、相似图裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToImage`\r\n\r\n**注意**：自定义尺寸（width+height）与 scale 二选一。宽高只传一个时取原图对应值。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 参考图。格式：jpg/png/webp，10M 以内，最大 4096x4096 | 是 | string |\r\n| prompt | 生图描述，不填则自动提取，最多 600 字符 | 否 | string |\r\n| weight | 相似度 [0,2]，默认 2 | 否 | integer |\r\n| width | 自定义宽度，最小 384，最大 4096 | 否 | integer |\r\n| height | 自定义高度，最小 384，最大 4096 | 否 | integer |\r\n| scale | 宽高比字符串（如 16:9），与自定义尺寸二选一 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十七、自动抠图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/cutout`\r\n\r\n**注意**：clothClass 仅在 subType=9（服饰）时生效，可多选以逗号分割，多选会合并抠图结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| subType | 抠图类型：1=通用，2=人像，3=商品，9=服饰，12=头发，13=人脸 | 是 | integer |\r\n| clothClass | 服饰抠图分类（subType=9 时生效），可多选逗号分割：tops/coat/skirt/pants/bag/shoes/hat | 否 | string |\r\n\r\n---\r\n\r\n## 十八、精细抠图-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/create`\r\n\r\n**注意**：pointList 中 x/y 为归一化坐标（0~1），isSelect 1=选中 0=不选中。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图 | 是 | string |\r\n| scoreUrl | 概率图（迭代时传入上一次返回的 scoreUrl） | 否 | string |\r\n| featureUrl | 全局分割图（同上） | 否 | string |\r\n| pointList | 点位操作列表 | 是 | array |\r\n| pointList[].x | 与左边缘距离 / 图片宽度，0~1 | 是 | number |\r\n| pointList[].y | 与上边缘距离 / 图片高度，0~1 | 是 | number |\r\n| pointList[].isSelect | 0=不选中，1=选中 | 是 | integer |\r\n\r\n---\r\n\r\n## 十九、精细抠图-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 精细抠图任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result（maskUrl/scoreUrl/imageUrl/featureUrl）。\r\n\r\n---\r\n\r\n## 二十、图片高清放大\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/superResolution`\r\n\r\n**注意**：放大后结果图最长边最大 8192。例如 3000x3000 放大 4 倍 → 8192x8192。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，最大 4096x4096 | 是 | string |\r\n| magnification | 放大倍数 [1,4]（浮点数），只高清不放大传 1 | 是 | float |\r\n| enhanceQuality | 是否高清化 | 否 | boolean |\r\n\r\n---\r\n\r\n## 二十一、智能扩图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/expandImage`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| width | 期望扩图后宽度 | 是 | number |\r\n| height | 期望扩图后高度 | 是 | number |\r\n| prompt | 提示词，最多 600 字符 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十二、图片翻译\r\n\r\n**路径**：`/linkfox-ai/image/v3/make/imageTransl`\r\n\r\n**注意**：原图最大 3000x3000，4M 以内。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，4M 以内，最小 385x385，最大 3000x3000 | 是 | string |\r\n| translationPlatform | 翻译源：deepl / chatgpt | 是 | string |\r\n| sourceLanguage | 源语种代码 | 是 | string |\r\n| targetLanguage | 目标语种代码 | 是 | string |\r\n\r\n**源语种代码：** CHS(中文)、ENG(英文)、CHT(繁体中文)、ESP(西班牙语)、JPN(日语)、KOR(韩语)、PT(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、VIN(越南语)、DEU(德语)\r\n\r\n**目标语种代码：** AR(阿拉伯语)、BG(保加利亚语)、BN(孟加拉语)、CHS(中文)、CHT(繁体中文)、CKB(中库尔德语)、CSY(捷克语)、DA(丹麦语)、DEU(德语)、EL(希腊语)、ENG(英语)、ESP(西班牙语)、ET(爱沙尼亚语)、FA(波斯语)、FI(芬兰语)、FIL(菲律宾语)、FRA(法语)、GU(古吉拉特语)、HE(希伯来语)、HI(印地语)、HR(克罗地亚语)、HUN(匈牙利语)、ID(印尼语)、ITA(意大利语)、JPN(日语)、JW(爪哇语)、KOR(韩语)、LO(老挝语)、LT(立陶宛语)、LV(拉脱维亚语)、MR(马拉地语)、MS(马来语)、MY(缅甸语)、NLD(荷兰语)、NO(挪威语)、PLK(波兰语)、PT(葡萄牙语)、PTB(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、SK(斯洛伐克语)、SL(斯洛文尼亚语)、SV(瑞典语)、SW(斯瓦希里语)、TA(泰米尔语)、TE(泰卢固语)、TG(塔吉克语)、TH(泰语)、TL(他加禄语)、TRK(土耳其语)、UK(乌克兰语)、UR(乌尔都语)、VIN(越南语)\r\n\r\n---\r\n\r\n## 二十三、手部修复\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| personType | 人物类型：0=女孩，1=男孩，2=成年女性，3=成年男性 | 是 | number |\r\n| maskUrl | 修复区域（黑白图，白色为修复区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十四、局部重绘\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/areaRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| prompt | 提示词，最多 600 字符 | 是 | string |\r\n| maskUrl | 重绘区域图（黑白图，白色为重绘区域） | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十五、印花提取\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/printExtract`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 二十六、消除笔\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/interactErase`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| maskImageUrl | 消除区域图（黑白图，白色为消除区域） | 是 | string |\r\n\r\n---\r\n\r\n## 二十七、手持商品\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handHeld`\r\n\r\n**注意**：手持姿势图为自定义图片时 targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 手持商品图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| targetOriginUrl | 手持姿势图。自定义地址或作图素材(type=8) | 是 | string |\r\n| targetMaskUrl | 手持区域图（黑白图，尺寸与姿势图一致）。自定义姿势图时必填 | 条件 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十八、饰品文字\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/linkedWord`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fontname | 字体名称（见下方列表） | 是 | string |\r\n| fontSize | 输出字体大小 | 是 | integer |\r\n| left | 左边加环，默认 false | 否 | boolean |\r\n| right | 右边加环，默认 false | 否 | boolean |\r\n| prompt | 饰品文字内容 | 是 | string |\r\n\r\n**可选字体：** Caitlyn、ItaliannoRob、Alison、ALSScript、WhiteAngelica、Milkshake、ScriptMTBold、PassionsConflictROB、Sacramento、Cervanttis、Notera 2 PERSONAL USE ONLY、UyghurMerdane、OldEnglishText、Halimun、AlexBrush、Scriptina、CounselorScript、EliannaBoldItalic、AutumnChant、MagnoliaScript\r\n\r\n---\r\n\r\n## 二十九、商品精修\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/productRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 三十、图片获取描述词-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/create`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 应用类型：5=相似图裂变，13=场景裂变，69=穿衣套图卖点分析，71=商品套图卖点分析 | 是 | string |\r\n| imageUrlList | 图片地址列表（只有套图卖点分析支持多张） | 是 | List\\<string\\> |\r\n| keyword | 关键字。场景裂变时有效；套图卖点分析时可传入商品信息 | 否 | string |\r\n| provider | 套图模式提取类型：API_PRE_POINT=卖点分析（默认），API_LAYOUT_DESC=排版描述 | 否 | string |\r\n\r\n---\r\n\r\n## 三十一、图片获取描述词-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result.content（描述词文本）。\r\n\r\n---\r\n\r\n## 三十二、智能修图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/imageEditV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `imageEditV2`。\r\n- 旧版 `imageEdit` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。支持 jpg/jpeg/png/webp；尺寸 300x300 ~ 4096x4096；宽高比 0.4 ~ 2.5 | 是 | string |\r\n| prompt | 提示词 | 是 | string |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO 默认 2K，其余默认 1K。WAN2_7不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n\r\n---\r\n\r\n## 三十三、智能修图-多图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/multiImageFusionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `multiImageFusionV2`。\r\n- 旧版 `multiImageFusion` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 图片列表。支持 jpg/jpeg/png/webp（10M 以内），最小 800x800，最大 4096x4096。限制:BANANA<=3张、WAN2_7 <=4张、其余<=6张 | 是 | array[string] |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_7 / SEEDREAM5 | 是 | string |\r\n| prompt | 强化内容描述（100 字以内） | 否 | string |\r\n| outputNum | 输出张数，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO 默认 2K，其余默认 1K。WAN2_7不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 可选：1:1、3:4、4:3、4:5、5:4、16:9、9:16、2:3、3:2、21:9（SEEDREAM5 不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false。仅 BANANA_PRO 支持 | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n\r\n---\r\n\r\n## 三十四、商品套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/productMarketMaterialV3`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `productMarketMaterialV3`。\r\n- 旧版 `productMarketMaterialV2` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 800x800，最大 4096x4096，10M 以内。\r\n- 各类型数量（aPlusNum/sellerTypeNum/sceneTypeNum 等）单项最大 8。\r\n- aPlusStyles/pointStyles 传入时，数量需与目标生成数量一致。\r\n- brandKey 为 JSON 对象，总长度不超过 1000 字符。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| sellerTypeNum | 卖点图 | sellPoint |\r\n| sceneTypeNum | 场景图 | scene |\r\n| closeUpTypeNum | 特写图 | closeUp |\r\n| closeUpWhiteTypeNum | 白底特写图 | closeUpWhite |\r\n| whiteBgTypeNum | 白底图 | whiteBg |\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量（Pro），默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+（基于高级 A+ 结果），默认 false | 否 | boolean |\r\n| aPlusAspectRatio | 自定义 A+ 宽高比（仅高级 A+ 场景使用），如 16:9/9:16/1:1 | 否 | string |\r\n| aPlusStyles | A+ 排版列表，id（风格 id，通过作图素材接口获取）或 prompt（排版词，通过排版描述接口获取） | 否 | List |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| sceneTypeNum | 场景图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpTypeNum | 特写图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpWhiteTypeNum | 白底特写图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteBgTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON：brandColor(#RRGGBB)/fontStyle/salesRegion/language/platform/customSettings | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n\r\n---\r\n\r\n## 三十五、服装套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/wearCollectionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `wearCollectionV2`。\r\n- 旧版 `wearCollection` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 384x384，最大 4096x4096，10M 以内。\r\n- sellerPoint 建议包含面料、卖点、目标人群、使用场景、尺码等信息，有助于提升结果质量。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| modelTypeNum | **模特+场景合成图**（非纯模特图） | **scene** |\r\n| insTypeNum | 种草图 | ins |\r\n| sellerTypeNum | 卖点图 | point |\r\n| sizeTypeNum | 尺码图 | size |\r\n| whiteTypeNum | 白底图 | white |\r\n\r\n> **⚠️ 特别说明**：`modelTypeNum` 生成的是**模特穿上服装并置于场景中的合成图**，输出 type 为 `scene`，而非 `model`。命名虽含 \"model\"，但产出是模特+场景的完整合成结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+，默认 false | 否 | boolean |\r\n| aPlusAspectRatio | A+ 宽高比 | 否 | string |\r\n| aPlusStyles | A+ 排版列表（id 或 prompt） | 否 | List |\r\n| modelTypeNum | **模特+场景合成图**数量（输出 type=`scene`），默认 0，最大 8 | 否 | integer |\r\n| ↳ modelImageUrl | 模特参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ sceneImageUrl | 场景参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ isExactScene | 场景裂变模式：true=遵循背景（默认），false=相似裂变。**仅 modelTypeNum > 0 时生效** | 否 | boolean |\r\n| ↳ modelAndSceneInfo | 描述想要的场景内容和模特特征。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| insTypeNum | 种草图数量，默认 0，最大 8 | 否 | integer |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| sizeTypeNum | 尺码图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON（同商品套图） | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n\r\n---\r\n\r\n## 三十六、姿势裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelPoseFission`\r\n\r\n**注意**：postureUrl（素材 type=9）与 prompt 二选一。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 图片地址。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| prompt | 自定义姿势描述。与 postureUrl 二选一 | 否 | string |\r\n| postureUrl | 姿势图片 URL。作图素材(type=9)或自定义。与 prompt 二选一 | 否 | string |\r\n| outputNum | 输出数量 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 三十七、带货口播\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/salesVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID（`taskId`），需继续轮询「获取作图结果」接口查询最终资源。\r\n- `prompt` 建议包含商品卖点、目标人群、使用场景和行动指令，以提升口播质量。\r\n- `imageList` 传入商品主图/细节图通常能提升视频一致性和转化表达。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 口播脚本/提示词 | 是 | string |\r\n| imageList | 参考图 URL 列表（建议 1~6 张） | 否 | array[string] |\r\n| videoType | 模型类型：WAN / SEED（seed = seedance） | 是 | string |\r\n| videoTime | 视频时长（秒）。WAN: 10/15秒；SEED: 5/10/15秒 | 否 | number |\r\n| isPro | 是否开启高质量模式 | 否 | boolean |\r\n| aspectRatio | 视频比例：16:9 / 9:16 / 1:1 | 否 | string |\r\n\r\n---\r\n\r\n## 三十八、图转视频\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToVideo`\r\n\r\n**注意**：\r\n- 该接口返回任务 ID（`taskId`），需继续轮询「获取作图结果」接口查询最终视频地址。\r\n- 不同模型支持的时长不同，SEED 支持 5/10/15 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图地址。格式：jpg/jpeg/png/webp | 是 | string |\r\n| prompt | 视频提示词 | 否 | string |\r\n| promptOptimizer | 是否开启提示词优化：0=否，1=是，默认 0 | 否 | number |\r\n| videoType | 模型类型：KLING（可灵）/ V（VIGGLE）/ HAILUO（海螺）/ WAN / SEED | 是 | string |\r\n| videoTime | 视频时长（秒）。SEED: 5/10/15秒 | 否 | number |\r\n| isPro | 是否开启高质量/Pro 模式 | 否 | boolean |\r\n| lastFrameImageUrl | 尾帧图地址 | 否 | string |\r\n| aspectRatio | 视频比例：16:9 / 9:16 / 1:1 | 否 | string |\r\n| camera | 运镜参数 | 否 | string |\n\nFile v1.3.0:references/open-platform.md\n\n# LinkFox AI 开放平台 - 接入与错误码\r\n\r\n## 接入流程\r\n\r\n1. 注册紫鸟开放平台：https://open.ziniao.com  \r\n2. 认证开发者，创建 LinkFox 卖家应用：https://open.ziniao.com/docSupport?docId=116  \r\n3. 将应用绑定到团队：https://www.linkfox.com/team/api-guide  \r\n4. 鉴权方式以官方文档为准：[API 调用指南 - 简单通用模式（推荐）](https://open.ziniao.com/docSupport?docId=233)\r\n\r\n## API 基础地址\r\n\r\n- 默认：`https://sbappstoreapi.ziniao.com/openapi-router`  \r\n- 路径前缀：`/linkfox-ai`  \r\n- 无固定 IP 时可使用代理：`https://sbappstoreapi-proxy.linkfox.com`（需配置白名单 IP：120.79.189.15）\r\n\r\n## 响应外层结构\r\n\r\n所有接口的响应均由开放平台包装了一层外层结构，实际业务数据在 `data` 字段中。\r\n\r\n```json\r\n{\r\n  \"request_id\": \"abc123\",\r\n  \"code\": 0,\r\n  \"msg\": \"success\",\r\n  \"data\": {\r\n    // 此处为业务接口的实际响应体\r\n    \"traceId\": \"...\",\r\n    \"code\": \"200\",\r\n    \"msg\": \"成功\",\r\n    \"data\": { /* 业务数据 */ }\r\n  }\r\n}\r\n```\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| request_id | 开放平台请求 ID |\r\n| code | 开放平台状态码，0 为成功 |\r\n| msg | 开放平台消息 |\r\n| data | 业务接口实际响应（内部有自己的 traceId/code/msg/data） |\r\n\r\n即实际数据嵌套路径为：`响应.data.data`（外层 data 是开放平台包装，内层 data 是业务数据）。\r\n\r\n## QPS / 限流说明\r\n\r\n- **base64 上传接口** (`/linkfox-ai/image/v2/uploadByBase64`)：全局限流 100 QPS。\r\n- **其他接口**：默认无严格 QPS 限制，但建议单应用并发不超过 50 QPS。\r\n- 触发限流时返回 HTTP 429 或开放平台错误码。\r\n- 作图任务提交后需轮询 `make-info` 获取结果，建议轮询间隔 ≥ 3 秒。\r\n\r\n## 错误码\r\n\r\n| 错误码 | 描述 |\r\n| --- | --- |\r\n| ERR_FILED_VALIDATE | 参数校验异常 |\r\n| ERR_VALIDATE_FAIL | 参数校验异常 |\r\n| ERR_IMAGE_MAKE_AUDIT | 图片审核不通过 |\r\n| ERR_IMAGE_MAKE_WILL_OUT | 作图点数不足 |\r\n| ERR_FORBIDDEN | 没有ID权限，ID取错也有可能 |\r\n| ERR_NOT_HAVE_TEAM_PRIVILEGE | 未绑定团队 |\r\n| TEAM_PERMISSION_DISABLE_USER | 被禁用 |\r\n| ERR_IMAGE_MAKE_COUNT_MAX | 生成中创建上限 |\r\n| TEAM_PERMISSION_EXPIRE | 套餐已过期或者未购买套餐 |\r\n\r\n更多说明见开放平台 https://open.ziniao.com 或本 skill 内 `references/image-make.md`。\n\nArchive v1.2.3: 5 files, 21144 bytes\n\nFiles: _meta.json (129b), references/image-make.md (33857b), references/open-platform.md (2433b), scripts/linkfoxai.py (20754b), SKILL.md (10030b)\n\nFile v1.2.3:SKILL.md\n\n---\r\nname: linkfoxai\r\ndescription: \"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🦊\",\"requires\":{\"env\":[\"LINKFOXAI_API_KEY\"]}}}\r\n---\r\n\r\n# LinkFoxAI - LinkFox AI 开放平台 Skill\r\n\r\nLinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播等。\r\n\r\n## 配置\r\n\r\n1. **获取凭证**：注册 [紫鸟开放平台](https://open.ziniao.com)，认证开发者并创建 LinkFox 卖家应用，然后在 [linkfox.com/team/api-guide](https://www.linkfox.com/team/api-guide) 将应用绑定到团队，获取 API Key。\r\n2. **环境变量**：`LINKFOXAI_API_KEY`（单一 API Key，配置一个 Key 即可调用全部接口）\r\n3. **自定义 Base URL**（可选）：默认 `https://sbappstoreapi.ziniao.com/openapi-router`。若无固定 IP，设置 `LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com` 并配置白名单。\r\n\r\n## 必须使用 sessions_spawn 调度作图任务\r\n\r\nAI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，**极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟**）。**务必通过 `sessions_spawn` 将作图任务派发到子会话**，让主会话保持响应。脚本的 `--wait` 参数会自动轮询直到出结果。\r\n\r\n### 超时处理策略（AI 自行判断）\r\n\r\n当作图任务超时（`--timeout` 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r\n\r\n1. **延长轮询时间**：将 `--timeout` 增大到 1800（30 分钟），`--interval` 建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r\n2. **告知用户并继续后台等待**：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r\n3. **任务分拆重试**：若任务参数含多图（如 `--output-num 4`），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r\n4. **放弃并报错**：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r\n\r\n> 默认建议：将 `sessions_spawn` 的 `runTimeoutSeconds` 设为 **1800**，`--timeout` 设为 **1700**，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r\n\r\n### 标准调度模板\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\\r\n         --image-url \"<模特原图>\" --head-url \"<头部图>\" --output-num 4\r\n    解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r\n    如果 status=4（失败），报告 errorMsg。\r\n    如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 换模特\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n  cleanup: \"keep\"\r\n```\r\n\r\n### 并行调度多个独立任务\r\n\r\n```\r\n# 子任务 1\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '<url>' --sub-type 1 ...\"\r\n  label: \"LinkFoxAI: 自动抠图\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n\r\n# 子任务 2\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '<url>' ...\"\r\n  label: \"LinkFoxAI: 场景裂变\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n### 通用接口调用（api-call）\r\n\r\n对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py api-call \\\r\n         --path /linkfox-ai/image/v2/make/fittingRoom \\\r\n         --body '{\"upperOriginUrl\":\"<上衣图>\",\"modelImageUrl\":\"<模特图>\",\"outputNum\":2}'\r\n    获取返回的 data.id，然后运行：\r\n    <skill>/scripts/linkfoxai.py poll --id <task_id> --timeout 1700\r\n    解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 穿衣\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n## 脚本命令一览\r\n\r\n### 基础命令\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `material-list --type <1-10>` | 作图素材列表（可用于连通性测试） |\r\n| `upload-base64 --file <路径>` | base64 上传图片，返回 viewUrl |\r\n| `make-info --id <任务ID>` | 查询作图结果（单次） |\r\n| `poll --id <任务ID> [--interval 3] [--timeout 300]` | 轮询作图结果直到成功/失败 |\r\n| `refresh --id <图片ID> [--format jpg]` | 刷新结果图片地址（注意是图片 ID，非任务 ID） |\r\n| `api-call --path <路径> --body '<JSON>'` | 通用 API 调用，可调任意开放平台接口 |\r\n\r\n### 作图快捷命令（均支持 `--wait`）\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `change-model --image-url <url> --head-url <url> [--scene-url <url>] [--output-num 1-4]` | AI 换模特 |\r\n| `cutout --image-url <url> --sub-type <1/2/3/9/12/13> [--cloth-class tops,coat,...]` | 自动抠图 |\r\n| `scene-fission --image-url <url> [--strength 0.5] [--prompt \"描述\"] [--provider SCENE_FISSION_REALISTIC]` | 场景裂变 |\r\n| `expand-image --image-url <url> --width 1024 --height 1024 [--prompt \"描述\"]` | 智能扩图 |\r\n| `super-resolution --image-url <url> --magnification 2 [--enhance]` | 图片高清放大 |\r\n| `image-edit --image-url <url> --prompt \"描述\" [--provider BANANA_PRO/WAN2_6/SEEDREAM5] [--template 白底图]` | 智能修图 |\r\n| `erase --image-url <url> --mask-url <url>` | 消除笔 |\r\n| `sales-video --prompt \"口播文案\" --video-type WAN [--image-list <url1> <url2>] [--video-time 10] [--aspect-ratio 9:16]` | 带货口播（WAN: 10/15秒） |\r\n\r\n所有作图快捷命令均支持 `--wait [--timeout 300] [--interval 3]`，提交任务后自动轮询直到完成。\r\n\r\n### 其他能力（通过 api-call 调用）\r\n\r\n以下能力通过 `api-call --path <路径> --body '<JSON>'` 调用，接口详情见 `references/image-make.md`：\r\n\r\n| 能力 | 路径 |\r\n|------|------|\r\n| AI 换模特 2.0 | `/linkfox-ai/image/v2/make/changeModelFixed` |\r\n| 模特换场景 | `/linkfox-ai/image/v2/make/modelChangeScene` |\r\n| AI 穿衣-上下装 | `/linkfox-ai/image/v2/make/fittingRoom` |\r\n| AI 穿衣-连体衣 | `/linkfox-ai/image/v2/make/fittingRoomSuit` |\r\n| AI 穿戴 | `/linkfox-ai/image/v2/make/intelligentWear` |\r\n| 商品替换 | `/linkfox-ai/image/v2/make/shopReplace` |\r\n| 场景图生成 | `/linkfox-ai/image/v2/make/aiDraw` |\r\n| 相似图裂变 | `/linkfox-ai/image/v2/make/imageToImage` |\r\n| 精细抠图-创建 | `/linkfox-ai/v2/process/result/interactCutout/create` |\r\n| 精细抠图-结果 | `/linkfox-ai/v2/process/result/interactCutout/info` |\r\n| 图片翻译 | `/linkfox-ai/image/v3/make/imageTransl` |\r\n| 手部修复 | `/linkfox-ai/image/v2/make/handRepair` |\r\n| 局部重绘 | `/linkfox-ai/image/v2/make/areaRepair` |\r\n| 印花提取 | `/linkfox-ai/image/v2/make/printExtract` |\r\n| 手持商品 | `/linkfox-ai/image/v2/make/handHeld` |\r\n| 饰品文字 | `/linkfox-ai/image/v2/make/linkedWord` |\r\n| 商品精修 | `/linkfox-ai/image/v2/make/productRepair` |\r\n| 图片获取描述词-创建 | `/linkfox-ai/v2/process/result/imageToPrompt/create` |\r\n| 图片获取描述词-结果 | `/linkfox-ai/v2/process/result/imageToPrompt/info` |\r\n| 智能修图 | `/linkfox-ai/image/v2/make/imageEditV2` |\r\n| 智能修图-多图 | `/linkfox-ai/image/v2/make/multiImageFusionV2` |\r\n| 商品套图 | `/linkfox-ai/image/v2/make/productMarketMaterialV3` |\r\n| 服装套图 | `/linkfox-ai/image/v2/make/wearCollectionV2` |\r\n| 姿势裂变 | `/linkfox-ai/image/v2/make/modelPoseFission` |\r\n| 带货口播 | `/linkfox-ai/image/v2/make/salesVideo` |\r\n\r\n## 连通性测试\r\n\r\n使用作图素材接口验证凭证和网络是否正常（无需上传图片）：\r\n\r\n```bash\r\n<skill>/scripts/linkfoxai.py material-list --type 1\r\n```\r\n\r\n或对 OpenClaw 说：「用 LinkFoxAI 拉取作图素材列表」。\r\n\r\n## 错误处理\r\n\r\n- 错误码（如 ERR_FORBIDDEN、ERR_NOT_HAVE_TEAM_PRIVILEGE、TEAM_PERMISSION_EXPIRE）见 `references/open-platform.md`。\r\n- 需先将应用绑定团队且团队已开通套餐。\r\n- 作图任务失败时 `status=4`，检查 `errorCode` 和 `errorMsg`。\r\n- 常见问题：参数校验失败（ERR_FILED_VALIDATE）、图片审核不通过（ERR_IMAGE_MAKE_AUDIT）、点数不足（ERR_IMAGE_MAKE_WILL_OUT）。\r\n- 若调用新增能力，需使用对应 V2/V3 路径，否则可能出现参数不兼容或能力不可用。\r\n\r\n## 参考文档\r\n\r\n- `references/open-platform.md` — 接入流程、API 基础地址、错误码\r\n- `references/image-make.md` — 全部作图接口及带货口播接口的完整参数与注意事项\r\n\r\n## 示例\r\n\r\n1. **连通性**：「用 LinkFoxAI 拉取作图素材列表」→ 脚本执行 `material-list --type 1`\r\n2. **AI 换模特**：「用 LinkFoxAI 做一次 AI 换模特，原图 xxx，头部图 xxx，出 4 张」→ `change-model --wait --output-num 4`\r\n3. **自动抠图**：「用 LinkFoxAI 把这张图抠图」→ `cutout --wait --sub-type 1`\r\n4. **智能修图**：「用 LinkFoxAI 把这张图改成白底图」→ `image-edit --wait --prompt \"白底图\" --template 白底图`（高质量：加 `--provider BANANA_PRO`）\r\n5. **带货口播**：「用 LinkFoxAI 生成一条 10 秒带货口播视频，竖版」→ `sales-video --wait --video-type WAN --video-time 10 --aspect-ratio 9:16 --prompt \"...\"`\r\n6. **通用调用**：「用 LinkFoxAI 做 AI 穿衣」→ `api-call --path /linkfox-ai/image/v2/make/fittingRoom --body '{...}'` + `poll --id <id>`\n\nFile v1.2.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ai\",\n  \"version\": \"1.2.3\",\n  \"publishedAt\": 1775540667998\n}\n\nFile v1.2.3:references/image-make.md\n\n# AI 作图 / 视频 - 全部接口完整说明\r\n\r\n本文档为 LinkFoxAI Skill 内置参考，涵盖开放平台 AI 作图/视频能力、完整参数与注意事项。\r\n\r\n所有接口均为 **POST**，请求体 **Content-Type: application/json**，响应体 application/json。\r\n\r\n---\r\n\r\n## 一、通用作图流程\r\n\r\n1. **可选**：调用「作图素材」获取预设素材地址（模特、场景等）。\r\n2. **可选**：本地图片需先调用「图片上传」得到可访问 URL。\r\n3. 调用具体作图接口，得到 **任务 ID**（`data.id`）。\r\n4. 轮询「获取作图结果」直到 `data.status` 为 3(成功) 或 4(失败)，取 `data.resultList[].url` 得到结果图。\r\n5. 结果图为**临时地址，有效期约 8 小时**；过期后调用「刷新结果图片地址」传入**图片 ID**（`resultList[].id`，非任务 ID）获取新 URL。\r\n\r\n**注意事项：**\r\n- 用户图片需外网可访问、链接稳定，建议使用国内图床（阿里云 OSS、腾讯云 COS 等）。\r\n- 作图素材地址通过「作图素材」接口获得，用作预设资源。\r\n- 本地图片上传支持 base64 编码，无需单独传 OSS。\r\n\r\n---\r\n\r\n## 二、通用响应结构\r\n\r\n所有作图创建任务接口的响应结构一致：\r\n\r\n| 参数 | 说明 | 类型 |\r\n|------|------|------|\r\n| traceId | 链路 ID | string |\r\n| code | 状态码，200 为成功 | string |\r\n| msg | 成功/错误描述 | string |\r\n| msgKey | 错误码，code 非 200 时存在 | string |\r\n| data.id | 任务 ID（用于轮询结果） | number |\r\n\r\n响应示例：\r\n```json\r\n{\"traceId\":\"f6e0fe4f360f78445c2c5d52f2414dea\",\"code\":\"200\",\"msg\":\"成功\",\"data\":{\"id\":123456}}\r\n```\r\n\r\n---\r\n\r\n## 三、作图素材\r\n\r\n**路径**：`/linkfox-ai/image/v2/material/list`\r\n\r\n**注意**：此接口可用于连通性测试，无需上传图片。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 类型：1=AI换模特-预设模特，2=模特图通用-预设场景，3=AI换模特固定脸-预设模特，4=模特图通用-场景素材，5=AI穿衣姿势-上下装素材，6=AI穿衣姿势-连体衣素材，7=AI穿戴-模特素材，8=手持商品-姿势素材，9=姿势裂变素材，10=套图-排版素材 | 是 | string |\r\n| pageNum | 页数，默认 1 | 否 | number |\r\n| pageSize | 单页条数，默认 10 | 否 | number |\r\n\r\n响应 data 含 list（url/name/tagList）、total、hasMore。\r\n\r\n```json\r\n{\"type\":\"1\"}\r\n```\r\n\r\n---\r\n\r\n## 四、图片上传\r\n\r\n### 4.1 base64 上传\r\n\r\n**路径**：`/linkfox-ai/image/v2/uploadByBase64`\r\n\r\n**注意**：全局 QPS 100（不分 IP 不分用户）。适用于没有图片存储服务或无法外网访问的场景。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（带扩展名），支持 jpeg/jpg/png/webp | 是 | string |\r\n| base64 | 图片 base64 编码，文件不超过 10MB，最长边不超过 4096 | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传后图片访问地址）。\r\n\r\n### 4.2 生成上传地址（OSS 直传）\r\n\r\n**路径**：`/linkfox-ai/image/v1/generateUploadUrl`\r\n\r\n**注意**：QPS 由阿里控制，并发能力高于 base64 方式。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（主要取后缀） | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传成功后可用地址）、policy（url/signature/policy/key/OSSAccessKeyId，用于客户端直传 OSS）。\r\n\r\n---\r\n\r\n## 五、获取作图结果\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/info`\r\n\r\n**注意**：需轮询此接口直到 status 变为 3（成功）或 4（失败）。建议轮询间隔 3-5 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 作图任务 ID | 是 | number |\r\n| format | 结果格式，目前仅支持 jpg | 否 | string |\r\n\r\n响应 data：\r\n\r\n| 字段 | 说明 | 类型 |\r\n|------|------|------|\r\n| id | 作图任务 ID | number |\r\n| status | 1=排队中 2=生成中 3=成功 4=失败 | integer |\r\n| errorCode | 错误码 | string |\r\n| errorMsg | 错误描述 | string |\r\n| resultList | 结果图片数组 | array |\r\n| resultList[].id | **图片 ID**（用于刷新地址） | number |\r\n| resultList[].status | 0=生成中 1=成功 2=失败 | integer |\r\n| resultList[].url | 高清图临时地址（有效期 8 小时） | string |\r\n| resultList[].width | 宽 | integer |\r\n| resultList[].height | 高 | integer |\r\n| resultList[].format | 格式 | string |\r\n| resultList[].size | 大小（字节） | integer |\r\n| resultList[].extendField | 扩展参数（如 maskUrl、requestId 等） | object |\r\n\r\n---\r\n\r\n## 六、刷新结果图片地址\r\n\r\n**路径**：`/linkfox-ai/image/v2/info`\r\n\r\n**注意**：ID 是**图片 ID**（resultList[].id），不是作图任务 ID。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 图片 ID | 是 | number |\r\n| downloadFormat | 下载格式，如 jpg、png | 否 | string |\r\n\r\n响应 data 含 url（新的图片访问地址）。\r\n\r\n---\r\n\r\n## 七、AI 换模特\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModel`\r\n\r\n**注意**：与 AI 换模特 2.0 的差异——生成的模特脸部更随机，使用同一个头部图，生成的模特脸部有细微变化。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelHeadImageUrl | 模特头部图。格式：jpg/jpeg/png/webp，5M 以内，最小 512x512，最大 2048x2048。或调用作图素材(type=1) | 是 | string |\r\n| sceneImgUrl | 场景参考图。格式：jpg/jpeg/png/webp，10M 以内，最小 768x768，最大 4096x4096。或调用作图素材(type=2 预设场景/type=4 场景素材)。建议使用场景素材，效果稳定 | 否 | string |\r\n| sceneStrength | 场景相似度，值越大越相似，[0,1]，默认 0.7 | 否 | string |\r\n| modelPrompt | 模特特征参数，多选用逗号拼接 | 否 | string |\r\n| customPrompt | 自定义描述，最多 600 字符 | 否 | string |\r\n| customNegPrompt | 画面中不需要的元素 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特（false 为人台），默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\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## 八、AI 换模特-2.0\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/changeModelFixed`\r\n\r\n**注意**：与 AI 换模特的差异——生成的模特脸部更固定，使用同一个头部图，脸部变化很小。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特原图保留区抠图结果 | 否 | string |\r\n| modelImageUrl | 模特头部图。或调用作图素材(type=3) | 是 | string |\r\n| sceneImgUrl | 场景图。或调用作图素材(type=4) | 否 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 九、模特换场景\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/modelChangeScene`\r\n\r\n**注意**：sceneImgUrl 与 scenePrompt 二选一必填。建议使用场景素材（type=4），效果稳定。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 模特原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| imageSegUrl | 模特抠图结果 | 否 | string |\r\n| sceneImgUrl | 场景图。或作图素材(type=2/4)。与 scenePrompt 二选一 | 条件 | string |\r\n| scenePrompt | 场景描述。与 sceneImgUrl 二选一 | 条件 | string |\r\n| sceneStrength | 场景相似度 [0,1]，默认 0.7 | 否 | string |\r\n| genOriRes | 是否生成原分辨率图，默认 false | 否 | boolean |\r\n| realModel | 原图是否真人模特，默认 true | 否 | boolean |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十、AI 穿衣-上下装\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoom`\r\n\r\n**注意**：upperOriginUrl 与 downOriginUrl 至少填一项。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| upperOriginUrl | 上衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 与下衣二选一 | string |\r\n| upperImageUrl | 上衣抠图结果 | 否 | string |\r\n| downOriginUrl | 下装原图。同上衣格式要求 | 与上衣二选一 | string |\r\n| downImageUrl | 下装抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=5) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十一、AI 穿衣-连体衣\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/fittingRoomSuit`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| suitOriginUrl | 连体衣原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 4096x4096 | 是 | string |\r\n| suitImageUrl | 连体衣抠图结果 | 否 | string |\r\n| modelImageUrl | 模特姿势图。或作图素材(type=6) | 是 | string |\r\n| modelMaskImageUrl | 模特穿戴区域图（黑白图，黑色为穿戴区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十二、AI 穿戴\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/intelligentWear`\r\n\r\n**注意**：穿戴模特原图为自定义图片时，targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 穿戴商品图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| targetOriginUrl | 穿戴模特原图。自定义地址或作图素材(type=7) | 是 | string |\r\n| targetMaskUrl | 穿戴区域图（黑白图，黑色为穿戴区域）。自定义模特图时必填 | 条件 | string |\r\n| productCategory | 商品品类，见下表 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n**商品品类字典：**\r\n\r\n| 值 | 说明 |\r\n|------|------|\r\n| footwear | 鞋靴 |\r\n| luggage | 箱包 |\r\n| eyewear | 眼镜 |\r\n| necklace | 项链 |\r\n| hat | 帽子 |\r\n| earring | 耳环 |\r\n| ring | 戒指 |\r\n| wristband | 手环手链 |\r\n| watch | 手表 |\r\n| headwear | 头饰 |\r\n| belt | 皮带 |\r\n| other | 其他 |\r\n\r\n---\r\n\r\n## 十三、商品替换\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/shopReplace`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 384x384，最大 8192x8192 | 是 | string |\r\n| sourceImageUrl | 原图的抠图结果 | 否 | string |\r\n| targetOriginUrl | 替换的目标原图 | 是 | string |\r\n| targetImageUrl | 目标原图抠图结果 | 否 | string |\r\n| denoiseStrength | 生成图变化程度，[0,1]，默认 0.5，越大变化越高 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长边不超过 4096，最短边不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传或只传一个时与原图尺寸一致 | 否 | number |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十四、场景裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/sceneFission`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| segImageUrl | 保留区域图 | 否 | string |\r\n| strength | 相似度 [0.1,1]，默认 0.5，越大越相似，浮点数小数点后一位 | 否 | string |\r\n| prompt | 强化内容描述，不传则自动提取，最长 600 字符 | 否 | string |\r\n| imageOutputWidth | 输出宽度，最长不超过 2048，最短不低于 32 | 否 | number |\r\n| imageOutputHeight | 输出高度，同上。不传时最长边固定 1024，最短边按原图比例调整 | 否 | number |\r\n| provider | 模式：SCENE_FISSION_REALISTIC=写实（默认），SCENE_FISSION_SIMPLE=简约，SCENE_FISSION_INTELLIGENT=智能 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 十五、场景图生成（AI 绘图）\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/aiDraw`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| prompt | 生图描述 | 是 | string |\r\n| imageUrl | 参考图 | 否 | string |\r\n| style | 生图风格，可选：场景素材/人物素材/古韵国风/传神素描/赛博朋克/像素插画/静谧水墨/动漫线稿/新海诚/宫崎骏/CG/黑白插画/复古日漫/Q版人物/写实油画/C4D剪纸/灵韵水彩/清新日漫 | 否 | string |\r\n| scale | 宽高比，默认 1:1，可选 1:1/16:9/9:16 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十六、相似图裂变\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/imageToImage`\r\n\r\n**注意**：自定义尺寸（width+height）与 scale 二选一。宽高只传一个时取原图对应值。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 参考图。格式：jpg/png/webp，10M 以内，最大 4096x4096 | 是 | string |\r\n| prompt | 生图描述，不填则自动提取，最多 600 字符 | 否 | string |\r\n| weight | 相似度 [0,2]，默认 2 | 否 | integer |\r\n| width | 自定义宽度，最小 384，最大 4096 | 否 | integer |\r\n| height | 自定义高度，最小 384，最大 4096 | 否 | integer |\r\n| scale | 宽高比字符串（如 16:9），与自定义尺寸二选一 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 4 | 否 | number |\r\n\r\n---\r\n\r\n## 十七、自动抠图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/cutout`\r\n\r\n**注意**：clothClass 仅在 subType=9（服饰）时生效，可多选以逗号分割，多选会合并抠图结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| subType | 抠图类型：1=通用，2=人像，3=商品，9=服饰，12=头发，13=人脸 | 是 | integer |\r\n| clothClass | 服饰抠图分类（subType=9 时生效），可多选逗号分割：tops/coat/skirt/pants/bag/shoes/hat | 否 | string |\r\n\r\n---\r\n\r\n## 十八、精细抠图-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/create`\r\n\r\n**注意**：pointList 中 x/y 为归一化坐标（0~1），isSelect 1=选中 0=不选中。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图 | 是 | string |\r\n| scoreUrl | 概率图（迭代时传入上一次返回的 scoreUrl） | 否 | string |\r\n| featureUrl | 全局分割图（同上） | 否 | string |\r\n| pointList | 点位操作列表 | 是 | array |\r\n| pointList[].x | 与左边缘距离 / 图片宽度，0~1 | 是 | number |\r\n| pointList[].y | 与上边缘距离 / 图片高度，0~1 | 是 | number |\r\n| pointList[].isSelect | 0=不选中，1=选中 | 是 | integer |\r\n\r\n---\r\n\r\n## 十九、精细抠图-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/interactCutout/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 精细抠图任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result（maskUrl/scoreUrl/imageUrl/featureUrl）。\r\n\r\n---\r\n\r\n## 二十、图片高清放大\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/superResolution`\r\n\r\n**注意**：放大后结果图最长边最大 8192。例如 3000x3000 放大 4 倍 → 8192x8192。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，最大 4096x4096 | 是 | string |\r\n| magnification | 放大倍数 [1,4]（浮点数），只高清不放大传 1 | 是 | float |\r\n| enhanceQuality | 是否高清化 | 否 | boolean |\r\n\r\n---\r\n\r\n## 二十一、智能扩图\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/expandImage`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| width | 期望扩图后宽度 | 是 | number |\r\n| height | 期望扩图后高度 | 是 | number |\r\n| prompt | 提示词，最多 600 字符 | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十二、图片翻译\r\n\r\n**路径**：`/linkfox-ai/image/v3/make/imageTransl`\r\n\r\n**注意**：原图最大 3000x3000，4M 以内。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，4M 以内，最小 385x385，最大 3000x3000 | 是 | string |\r\n| translationPlatform | 翻译源：deepl / chatgpt | 是 | string |\r\n| sourceLanguage | 源语种代码 | 是 | string |\r\n| targetLanguage | 目标语种代码 | 是 | string |\r\n\r\n**源语种代码：** CHS(中文)、ENG(英文)、CHT(繁体中文)、ESP(西班牙语)、JPN(日语)、KOR(韩语)、PT(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、VIN(越南语)、DEU(德语)\r\n\r\n**目标语种代码：** AR(阿拉伯语)、BG(保加利亚语)、BN(孟加拉语)、CHS(中文)、CHT(繁体中文)、CKB(中库尔德语)、CSY(捷克语)、DA(丹麦语)、DEU(德语)、EL(希腊语)、ENG(英语)、ESP(西班牙语)、ET(爱沙尼亚语)、FA(波斯语)、FI(芬兰语)、FIL(菲律宾语)、FRA(法语)、GU(古吉拉特语)、HE(希伯来语)、HI(印地语)、HR(克罗地亚语)、HUN(匈牙利语)、ID(印尼语)、ITA(意大利语)、JPN(日语)、JW(爪哇语)、KOR(韩语)、LO(老挝语)、LT(立陶宛语)、LV(拉脱维亚语)、MR(马拉地语)、MS(马来语)、MY(缅甸语)、NLD(荷兰语)、NO(挪威语)、PLK(波兰语)、PT(葡萄牙语)、PTB(葡萄牙语)、ROM(罗马尼亚语)、RUS(俄语)、SK(斯洛伐克语)、SL(斯洛文尼亚语)、SV(瑞典语)、SW(斯瓦希里语)、TA(泰米尔语)、TE(泰卢固语)、TG(塔吉克语)、TH(泰语)、TL(他加禄语)、TRK(土耳其语)、UK(乌克兰语)、UR(乌尔都语)、VIN(越南语)\r\n\r\n---\r\n\r\n## 二十三、手部修复\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| personType | 人物类型：0=女孩，1=男孩，2=成年女性，3=成年男性 | 是 | number |\r\n| maskUrl | 修复区域（黑白图，白色为修复区域） | 否 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十四、局部重绘\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/areaRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，尺寸 300x300~4096x4096，宽高比 0.4~2.5 | 是 | string |\r\n| prompt | 提示词，最多 600 字符 | 是 | string |\r\n| maskUrl | 重绘区域图（黑白图，白色为重绘区域） | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十五、印花提取\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/printExtract`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 二十六、消除笔\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/interactErase`\r\n\r\n**注意**：原图尺寸 300x300~4096x4096，宽高比 0.4~2.5。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。格式：jpg/jpeg/png/webp | 是 | string |\r\n| maskImageUrl | 消除区域图（黑白图，白色为消除区域） | 是 | string |\r\n\r\n---\r\n\r\n## 二十七、手持商品\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/handHeld`\r\n\r\n**注意**：手持姿势图为自定义图片时 targetMaskUrl 必填。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 手持商品图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n| targetOriginUrl | 手持姿势图。自定义地址或作图素材(type=8) | 是 | string |\r\n| targetMaskUrl | 手持区域图（黑白图，尺寸与姿势图一致）。自定义姿势图时必填 | 条件 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | number |\r\n\r\n---\r\n\r\n## 二十八、饰品文字\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/linkedWord`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fontname | 字体名称（见下方列表） | 是 | string |\r\n| fontSize | 输出字体大小 | 是 | integer |\r\n| left | 左边加环，默认 false | 否 | boolean |\r\n| right | 右边加环，默认 false | 否 | boolean |\r\n| prompt | 饰品文字内容 | 是 | string |\r\n\r\n**可选字体：** Caitlyn、ItaliannoRob、Alison、ALSScript、WhiteAngelica、Milkshake、ScriptMTBold、PassionsConflictROB、Sacramento、Cervanttis、Notera 2 PERSONAL USE ONLY、UyghurMerdane、OldEnglishText、Halimun、AlexBrush、Scriptina、CounselorScript、EliannaBoldItalic、AutumnChant、MagnoliaScript\r\n\r\n---\r\n\r\n## 二十九、商品精修\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/productRepair`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 商品原图。格式：jpg/jpeg/png/webp，20M 以内，最小 385x385，最大 8192x8192 | 是 | string |\r\n\r\n---\r\n\r\n## 三十、图片获取描述词-创建任务\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/create`\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 应用类型：5=相似图裂变，13=场景裂变，69=穿衣套图卖点分析，71=商品套图卖点分析 | 是 | string |\r\n| imageUrlList | 图片地址列表（只有套图卖点分析支持多张） | 是 | List\\<string\\> |\r\n| keyword | 关键字。场景裂变时有效；套图卖点分析时可传入商品信息 | 否 | string |\r\n| provider | 套图模式提取类型：API_PRE_POINT=卖点分析（默认），API_LAYOUT_DESC=排版描述 | 否 | string |\r\n\r\n---\r\n\r\n## 三十一、图片获取描述词-获取结果\r\n\r\n**路径**：`/linkfox-ai/v2/process/result/imageToPrompt/info`\r\n\r\n**注意**：status 1=已创建 2=执行中 3=成功 4=失败。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 任务 ID | 是 | string |\r\n\r\n响应 data：id、status、result.content（描述词文本）。\r\n\r\n---\r\n\r\n## 三十二、智能修图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/imageEditV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `imageEditV2`。\r\n- 旧版 `imageEdit` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageUrl | 原图。支持 jpg/jpeg/png/webp；尺寸 300x300 ~ 4096x4096；宽高比 0.4 ~ 2.5 | 是 | string |\r\n| prompt | 提示词 | 是 | string |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_6 / SEEDREAM5 | 是 | string |\r\n| outputNum | 输出张数 [1,4]，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO 默认 2K，其余默认 1K。WAN2_6不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 比例，如 1:1、16:9、9:16。WAN2_6 / SEEDREAM5 支持：1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9（不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n\r\n---\r\n\r\n## 三十三、智能修图-多图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/multiImageFusionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `multiImageFusionV2`。\r\n- 旧版 `multiImageFusion` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 图片列表。支持 jpg/jpeg/png/webp（10M 以内），最小 800x800，最大 4096x4096。限制:BANANA<=3张、WAN2_6 <=4张、其余<=6张 | 是 | array[string] |\r\n| provider | 模型：BANANA / BANANA_2 / BANANA_PRO / WAN2_6 / SEEDREAM5 | 是 | string |\r\n| prompt | 强化内容描述（100 字以内） | 否 | string |\r\n| outputNum | 输出张数，默认 1 | 否 | integer |\r\n| resolution | 分辨率：1K / 2K / 4K。BANANA_PRO 默认 2K，其余默认 1K。WAN2_6不支持 4K / SEEDREAM5 不支持 1K、4K | 否 | string |\r\n| aspectRatio | 比例，如 1:1、16:9、9:16。WAN2_6 / SEEDREAM5 支持：1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9（不支持 4:5 / 5:4） | 否 | string |\r\n| supplyType | 供应模式：eco（经济）/ stable（稳定，默认）。仅 BANANA 系列生效 | 否 | string |\r\n| needOptimize | 是否提示词优化：true/false。仅 BANANA_PRO 支持 | 否 | boolean |\r\n| template | 提示词模板名称（模板中的 provider、needOptimize 优先级更高） | 否 | string |\r\n\r\n---\r\n\r\n## 三十四、商品套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/productMarketMaterialV3`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `productMarketMaterialV3`。\r\n- 旧版 `productMarketMaterialV2` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 800x800，最大 4096x4096，10M 以内。\r\n- 各类型数量（aPlusNum/sellerTypeNum/sceneTypeNum 等）单项最大 8。\r\n- aPlusStyles/pointStyles 传入时，数量需与目标生成数量一致。\r\n- brandKey 为 JSON 对象，总长度不超过 1000 字符。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| sellerTypeNum | 卖点图 | sellPoint |\r\n| sceneTypeNum | 场景图 | scene |\r\n| closeUpTypeNum | 特写图 | closeUp |\r\n| closeUpWhiteTypeNum | 白底特写图 | closeUpWhite |\r\n| whiteBgTypeNum | 白底图 | whiteBg |\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量（Pro），默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+（基于高级 A+ 结果），默认 false | 否 | boolean |\r\n| aPlusAspectRatio | 自定义 A+ 宽高比（仅高级 A+ 场景使用），如 16:9/9:16/1:1 | 否 | string |\r\n| aPlusStyles | A+ 排版列表，id（风格 id，通过作图素材接口获取）或 prompt（排版词，通过排版描述接口获取） | 否 | List |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| sceneTypeNum | 场景图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpTypeNum | 特写图数量，默认 0，最大 8 | 否 | integer |\r\n| closeUpWhiteTypeNum | 白底特写图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteBgTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:9/9:16/21:9 | 否 | string |\r\n| brandKey | 品牌基因 JSON：brandColor(#RRGGBB)/fontStyle/salesRegion/language/platform/customSettings | 否 | string |\r\n| resolution | 输出分辨率：2K（默认）/4K | 否 | string |\r\n\r\n---\r\n\r\n## 三十五、服装套图\r\n\r\n**路径（新版本优先）**：`/linkfox-ai/image/v2/make/wearCollectionV2`\r\n\r\n**版本说明**：\r\n- 自 **2026/03/13** 起，统一使用 `wearCollectionV2`。\r\n- 旧版 `wearCollection` 视为**废弃接口**，仅用于历史兼容，不建议继续接入。\r\n\r\n**注意**：\r\n- imageList 最多 5 张，最小 384x384，最大 4096x4096，10M 以内。\r\n- sellerPoint 建议包含面料、卖点、目标人群、使用场景、尺码等信息，有助于提升结果质量。\r\n- 结果通过获取作图结果接口轮询，`resultList[].extendField.type` 标识图片类型，参见下方「参数→输出 type 映射」。\r\n\r\n**参数→输出 type 映射：**\r\n\r\n| 参数 | 生成内容 | `extendField.type` |\r\n|------|----------|---------------------|\r\n| aPlusNum | 普通 A+ 排版图 | APlusNormal |\r\n| aPlusProNum | 高级 A+ 排版图 | APlusPro |\r\n| aPlusHasPhone | 手机版 A+（基于高级 A+ 结果） | APlusHasPhone |\r\n| modelTypeNum | **模特+场景合成图**（非纯模特图） | **scene** |\r\n| insTypeNum | 种草图 | ins |\r\n| sellerTypeNum | 卖点图 | point |\r\n| sizeTypeNum | 尺码图 | size |\r\n| whiteTypeNum | 白底图 | white |\r\n\r\n> **⚠️ 特别说明**：`modelTypeNum` 生成的是**模特穿上服装并置于场景中的合成图**，输出 type 为 `scene`，而非 `model`。命名虽含 \"model\"，但产出是模特+场景的完整合成结果。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| imageList | 商品图片列表（最多 5 张） | 是 | array[string] |\r\n| sellerPoint | 商品卖点描述，最多 2500 字符 | 是 | string |\r\n| provider | 模型：BANANA_PRO（Pro）/ BANANA_2（基础版 2 代） | 是 | string |\r\n| aPlusNum | 普通 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusProNum | 高级 A+ 数量，默认 0，最大 8 | 否 | integer |\r\n| aPlusHasPhone | 是否生成手机版 A+，默认 false | 否 | boolean |\r\n| aPlusAspectRatio | A+ 宽高比 | 否 | string |\r\n| aPlusStyles | A+ 排版列表（id 或 prompt） | 否 | List |\r\n| modelTypeNum | **模特+场景合成图**数量（输出 type=`scene`），默认 0，最大 8 | 否 | integer |\r\n| ↳ modelImageUrl | 模特参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ sceneImageUrl | 场景参考图，未设置时启动智能模式。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| ↳ isExactScene | 场景裂变模式：true=遵循背景（默认），false=相似裂变。**仅 modelTypeNum > 0 时生效** | 否 | boolean |\r\n| ↳ modelAndSceneInfo | 描述想要的场景内容和模特特征。**仅 modelTypeNum > 0 时生效** | 否 | string |\r\n| insTypeNum | 种草图数量，默认 0，最大 8 | 否 | integer |\r\n| sellerTypeNum | 卖点图数量，默认 0，最大 8 | 否 | integer |\r\n| isExtractPrePoint | 是否自动分析卖点，默认 false | 否 | boolean |\r\n| pointStyles | 卖点图排版列表（同 aPlusStyles 格式） | 否 | List |\r\n| sizeTypeNum | 尺码图数量，默认 0，最大 8 | 否 | integer |\r\n| whiteTypeNum | 白底图数量，默认 0，最大 8 | 否 | integer |\r\n| aspectRatio | 素材宽高比：1:1/3:2/2:3/4:3/3:4/4:5/5:4/16:\n\nArchive v1.2.1: 5 files, 20718 bytes\n\nFiles: _meta.json (129b), references/image-make.md (31935b), references/open-platform.md (2433b), scripts/linkfoxai.py (20737b), SKILL.md (10013b)","readmeExcerpt":"Skill: LinkFoxAI Owner: linkfox-ai Summary: 调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Tags: latest:1.5.1 Version history: v1.5.1 | 2026-06-12T06:15:20.181Z | user 新增：视频复刻 video-reclone，支持 SEED、SEED_FAST 两个模型进行视频复刻生成。 调整：商品套图/服装套图支持「无字模式」--no-text，生成纯画面、不带文案排版。 调整：图转视频/带货口播新增支持SEED_FAST模型生成 v1.5.0 | 2026-05-07T12:44:16.506Z | u","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: linkfoxai\r\ndescription: \"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。\"\r\nmetadata: {\"clawdbot\":{\"emoji\":\"🦊\",\"requires\":{\"env\":[\"LINKFOXAI_API_KEY\"]}}}\r\n---\r\n\r\n# LinkFoxAI - LinkFox AI 开放平台 Skill\r\n\r\nLinkFoxAI 让 OpenClaw 调用 LinkFox AI 开放平台 AI 作图/视频能力：换模特、自动抠图、场景裂变、智能扩图、高清放大、消除笔、智能修图、商品套图、服装套图、姿势裂变、带货口播、图转视频等。\r\n\r\n## 配置\r\n\r\n1. **获取凭证**：注册 [紫鸟开放平台](https://open.ziniao.com)，认证开发者并创建 LinkFox 卖家应用，然后在 [linkfox.com/team/api-guide](https://www.linkfox.com/team/api-guide) 将应用绑定到团队，获取 API Key。\r\n2. **环境变量**：`LINKFOXAI_API_KEY`（单一 API Key，配置一个 Key 即可调用全部接口）\r\n3. **自定义 Base URL**（可选）：默认 `https://sbappstoreapi.ziniao.com/openapi-router`。若无固定 IP，设置 `LINKFOXAI_BASE_URL=https://sbappstoreapi-proxy.linkfox.com` 并配置白名单。\r\n\r\n## 必须使用 sessions_spawn 调度作图任务\r\n\r\nAI 作图任务需要排队和生成时间（通常 10 秒 ~ 5 分钟，**极端情况下可能因服务端超时或队列积压导致单个任务耗时超过 30 分钟**）。**务必通过 `sessions_spawn` 将作图任务派发到子会话**，让主会话保持响应。脚本的 `--wait` 参数会自动轮询直到出结果。\r\n\r\n### 超时处理策略（AI 自行判断）\r\n\r\n当作图任务超时（`--timeout` 耗尽仍未返回结果）时，AI 应根据具体情况自主选择以下策略，无需等待用户指令：\r\n\r\n1. **延长轮询时间**：将 `--timeout` 增大到 1800（30 分钟），`--interval` 建议 10~30 秒，适用于重要任务或用户明确愿意等待的场景。\r\n2. **告知用户并继续后台等待**：向用户说明任务仍在生成中，预估剩余时间，并在后台子会话中继续轮询；完成后主动汇报结果。\r\n3. **任务分拆重试**：若任务参数含多图（如 `--output-num 4`），可拆分为多个单图任务并行提交，降低单个任务超时概率。\r\n4. **放弃并报错**：仅当用户明确要求快速返回、或超时时间已大幅超出合理范围（> 40 分钟）时，才终止轮询并告知用户稍后手动查询任务 ID。\r\n\r\n> 默认建议：将 `sessions_spawn` 的 `runTimeoutSeconds` 设为 **1800**，`--timeout` 设为 **1700**，以覆盖绝大多数超时场景。仅在明确知道该类型任务通常很快时才缩小超时值。\r\n\r\n### 标准调度模板\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py change-model --wait --timeout 1700 \\\r\n         --image-url \"<模特原图>\" --head-url \"<头部图>\" --output-num 4\r\n    解析输出 JSON，提取 resultList 中的图片 URL 汇报给用户。\r\n    如果 status=4（失败），报告 errorMsg。\r\n    如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 换模特\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n  cleanup: \"keep\"\r\n```\r\n\r\n### 并行调度多个独立任务\r\n\r\n```\r\n# 子任务 1\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py cutout --wait --timeout 1700 --image-url '<url>' --sub-type 1 ...\"\r\n  label: \"LinkFoxAI: 自动抠图\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n\r\n# 子任务 2\r\nsessions_spawn:\r\n  task: \"Run: <skill>/scripts/linkfoxai.py scene-fission --wait --timeout 1700 --image-url '<url>' ...\"\r\n  label: \"LinkFoxAI: 场景裂变\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n### 通用接口调用（api-call）\r\n\r\n对于脚本没有专属命令的接口（如 AI 穿衣、商品替换、饰品文字等），使用 `api-call` 传入路径和 JSON body：\r\n\r\n```\r\nsessions_spawn:\r\n  task: |\r\n    Run: <skill>/scripts/linkfoxai.py api-call \\\r\n         --path /linkfox-ai/image/v2/make/fittingRoom \\\r\n         --body '{\"upperOriginUrl\":\"<上衣图>\",\"modelImageUrl\":\"<模特图>\",\"outputNum\":2}'\r\n    获取返回的 data.id，然后运行：\r\n    <skill>/scripts/linkfoxai.py poll --id <task_id> --timeout 1700\r\n    解析结果汇报给用户。如果超时仍未完成，告知用户任务 ID 以便后续手动查询。\r\n  label: \"LinkFoxAI: AI 穿衣\"\r\n  mode: \"run\"\r\n  runTimeoutSeconds: 1800\r\n```\r\n\r\n## 脚本命令一览\r\n\r\n### 基础命令\r\n\r\n| 命令 | 说明 |\r\n|------|------|\r\n| `material-list --type <1-10>` | 作图素材列表（可用于连通性测试） |\r\n| `upload-base64 "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ai\",\n  \"version\": \"1.5.1\",\n  \"publishedAt\": 1781244920181\n}"},{"path":"references/image-make.md","content":"# AI 作图 / 视频 - 全部接口完整说明\r\n\r\n本文档为 LinkFoxAI Skill 内置参考，涵盖开放平台 AI 作图/视频能力、完整参数与注意事项。\r\n\r\n所有接口均为 **POST**，请求体 **Content-Type: application/json**，响应体 application/json。\r\n\r\n---\r\n\r\n## 一、通用作图流程\r\n\r\n1. **可选**：调用「作图素材」获取预设素材地址（模特、场景等）。\r\n2. **可选**：本地图片需先调用「图片上传」得到可访问 URL。\r\n3. 调用具体作图接口，得到 **任务 ID**（`data.id`）。\r\n4. 轮询「获取作图结果」直到 `data.status` 为 3(成功) 或 4(失败)，取 `data.resultList[].url` 得到结果图。\r\n5. 结果图为**临时地址，有效期约 8 小时**；过期后调用「刷新结果图片地址」传入**图片 ID**（`resultList[].id`，非任务 ID）获取新 URL。\r\n\r\n**注意事项：**\r\n- 用户图片需外网可访问、链接稳定，建议使用国内图床（阿里云 OSS、腾讯云 COS 等）。\r\n- 作图素材地址通过「作图素材」接口获得，用作预设资源。\r\n- 本地图片上传支持 base64 编码，无需单独传 OSS。\r\n\r\n---\r\n\r\n## 二、通用响应结构\r\n\r\n所有作图创建任务接口的响应结构一致：\r\n\r\n| 参数 | 说明 | 类型 |\r\n|------|------|------|\r\n| traceId | 链路 ID | string |\r\n| code | 状态码，200 为成功 | string |\r\n| msg | 成功/错误描述 | string |\r\n| msgKey | 错误码，code 非 200 时存在 | string |\r\n| data.id | 任务 ID（用于轮询结果） | number |\r\n\r\n响应示例：\r\n```json\r\n{\"traceId\":\"f6e0fe4f360f78445c2c5d52f2414dea\",\"code\":\"200\",\"msg\":\"成功\",\"data\":{\"id\":123456}}\r\n```\r\n\r\n---\r\n\r\n## 三、作图素材\r\n\r\n**路径**：`/linkfox-ai/image/v2/material/list`\r\n\r\n**注意**：此接口可用于连通性测试，无需上传图片。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| type | 类型：1=AI换模特-预设模特，2=模特图通用-预设场景，3=AI换模特固定脸-预设模特，4=模特图通用-场景素材，5=AI穿衣姿势-上下装素材，6=AI穿衣姿势-连体衣素材，7=AI穿戴-模特素材，8=手持商品-姿势素材，9=姿势裂变素材，10=套图-排版素材 | 是 | string |\r\n| pageNum | 页数，默认 1 | 否 | number |\r\n| pageSize | 单页条数，默认 10 | 否 | number |\r\n\r\n响应 data 含 list（url/name/tagList）、total、hasMore。\r\n\r\n```json\r\n{\"type\":\"1\"}\r\n```\r\n\r\n---\r\n\r\n## 四、图片上传\r\n\r\n### 4.1 base64 上传\r\n\r\n**路径**：`/linkfox-ai/image/v2/uploadByBase64`\r\n\r\n**注意**：全局 QPS 100（不分 IP 不分用户）。适用于没有图片存储服务或无法外网访问的场景。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（带扩展名），支持 jpeg/jpg/png/webp | 是 | string |\r\n| base64 | 图片 base64 编码，文件不超过 10MB，最长边不超过 4096 | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传后图片访问地址）。\r\n\r\n### 4.2 生成上传地址（OSS 直传）\r\n\r\n**路径**：`/linkfox-ai/image/v1/generateUploadUrl`\r\n\r\n**注意**：QPS 由阿里控制，并发能力高于 base64 方式。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| fileName | 文件名（主要取后缀） | 是 | string |\r\n\r\n响应 data 含 viewUrl（上传成功后可用地址）、policy（url/signature/policy/key/OSSAccessKeyId，用于客户端直传 OSS）。\r\n\r\n---\r\n\r\n## 五、获取作图结果\r\n\r\n**路径**：`/linkfox-ai/image/v2/make/info`\r\n\r\n**注意**：需轮询此接口直到 status 变为 3（成功）或 4（失败）。建议轮询间隔 3-5 秒。\r\n\r\n| 参数 | 说明 | 必填 | 类型 |\r\n|------|------|------|------|\r\n| id | 作图任务 ID | 是 | number |\r\n| format | 结果格式，目前仅支持 jpg | 否 | string |\r\n\r\n响应 data：\r\n\r\n| 字段 | 说明 | 类型 |\r\n|------|------|------|\r\n| id | 作图任务 ID | number |\r\n| status | 1=排队中 2=生成中 3=成功 4=失败 | integer |\r\n| errorCode | 错误码 | string |\r\n| errorMsg | 错误描述 | string |\r\n| resultList | 结果图片数组 | array |\r\n| resultList[].id | **图片 ID**（用于刷新地址） | number |\r\n| resultList[].status | 0=生成中 1=成功 2=失败 | integer |\r\n| resultList[].url | 高清图临时地址（有效期 8 小时） | string |\r\n| resultList[].width | 宽 | integer |\r\n| resultList[].height | 高 | integer |\r\n| resultList[].format | 格式 | string |\r\n| resultList[].size | 大小（字节） | integer |\r\n| resultList[].extendField | 扩展参数（如 maskUrl、requestId 等） | object |\r\n\r\n---\r\n\r\n## 六、刷新结果图片地址\r\n\r\n**路径**：`/linkfox-ai/image/v2"},{"path":"references/open-platform.md","content":"# LinkFox AI 开放平台 - 接入与错误码\r\n\r\n## 接入流程\r\n\r\n1. 注册紫鸟开放平台：https://open.ziniao.com  \r\n2. 认证开发者，创建 LinkFox 卖家应用：https://open.ziniao.com/docSupport?docId=116  \r\n3. 将应用绑定到团队：https://www.linkfox.com/team/api-guide  \r\n4. 鉴权方式以官方文档为准：[API 调用指南 - 简单通用模式（推荐）](https://open.ziniao.com/docSupport?docId=233)\r\n\r\n## API 基础地址\r\n\r\n- 默认：`https://sbappstoreapi.ziniao.com/openapi-router`  \r\n- 路径前缀：`/linkfox-ai`  \r\n- 无固定 IP 时可使用代理：`https://sbappstoreapi-proxy.linkfox.com`（需配置白名单 IP：120.79.189.15）\r\n\r\n## 响应外层结构\r\n\r\n所有接口的响应均由开放平台包装了一层外层结构，实际业务数据在 `data` 字段中。\r\n\r\n```json\r\n{\r\n  \"request_id\": \"abc123\",\r\n  \"code\": 0,\r\n  \"msg\": \"success\",\r\n  \"data\": {\r\n    // 此处为业务接口的实际响应体\r\n    \"traceId\": \"...\",\r\n    \"code\": \"200\",\r\n    \"msg\": \"成功\",\r\n    \"data\": { /* 业务数据 */ }\r\n  }\r\n}\r\n```\r\n\r\n| 字段 | 说明 |\r\n|------|------|\r\n| request_id | 开放平台请求 ID |\r\n| code | 开放平台状态码，0 为成功 |\r\n| msg | 开放平台消息 |\r\n| data | 业务接口实际响应（内部有自己的 traceId/code/msg/data） |\r\n\r\n即实际数据嵌套路径为：`响应.data.data`（外层 data 是开放平台包装，内层 data 是业务数据）。\r\n\r\n## QPS / 限流说明\r\n\r\n- **base64 上传接口** (`/linkfox-ai/image/v2/uploadByBase64`)：全局限流 100 QPS。\r\n- **其他接口**：默认无严格 QPS 限制，但建议单应用并发不超过 50 QPS。\r\n- 触发限流时返回 HTTP 429 或开放平台错误码。\r\n- 作图任务提交后需轮询 `make-info` 获取结果，建议轮询间隔 ≥ 3 秒。\r\n\r\n## 错误码\r\n\r\n| 错误码 | 描述 |\r\n| --- | --- |\r\n| ERR_FILED_VALIDATE | 参数校验异常 |\r\n| ERR_VALIDATE_FAIL | 参数校验异常 |\r\n| ERR_IMAGE_MAKE_AUDIT | 图片审核不通过 |\r\n| ERR_IMAGE_MAKE_WILL_OUT | 作图点数不足 |\r\n| ERR_FORBIDDEN | 没有ID权限，ID取错也有可能 |\r\n| ERR_NOT_HAVE_TEAM_PRIVILEGE | 未绑定团队 |\r\n| TEAM_PERMISSION_DISABLE_USER | 被禁用 |\r\n| ERR_IMAGE_MAKE_COUNT_MAX | 生成中创建上限 |\r\n| TEAM_PERMISSION_EXPIRE | 套餐已过期或者未购买套餐 |\r\n\r\n更多说明见开放平台 https://open.ziniao.com 或本 skill 内 `references/image-make.md`。"},{"path":"skill-card.md","content":"## Description:\n\nLinkFoxAI lets an agent call the LinkFox AI open platform for image and video generation workflows, including model swaps, cutouts, image expansion, scene variation, product image sets, talking sales videos, image-to-video, task polling, generic API calls, and connectivity checks.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external teams use this skill to connect an agent to LinkFox AI media-generation APIs, submit authenticated image or video jobs, poll for results, and return generated media URLs or API responses.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill gives an agent broad authenticated access to LinkFox AI APIs and media upload workflows.\n\nMitigation: Use a scoped API key if available, protect LINKFOXAI_API_KEY, and review proposed api-call and upload-base64 commands before execution.\n\nRisk: Media, prompts, product data, and account credentials are sent to LinkFoxAI/Ziniao services.\n\nMitigation: Install only when that data sharing is acceptable, and avoid uploading sensitive local files or private/person media without consent.\n\nRisk: Changing LINKFOXAI_BASE_URL can route authenticated requests away from the documented official hosts.\n\nMitigation: Keep LINKFOXAI_BASE_URL on the documented official hosts unless the deployment has separately verified the endpoint and allowlist requirements.\n\nRisk: Generated media jobs can take a long time, fail audit checks, or return temporary result URLs.\n\nMitigation: Run long jobs in background sessions, poll status, surface task IDs and error messages, and refresh expired result URLs when needed.\n\n## Reference(s):\n\n- [LinkFox AI Open Platform](https://open.ziniao.com)\n- [LinkFox API Guide](https://www.linkfox.com/team/api-guide)\n- [AI Image and Video API Reference](references/image-make.md)\n- [Open Platform Access and Error Codes](references/open-platform.md)\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-ai)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON]\n\n**Output Format:** [Markdown guidance with shell commands and JSON API responses or generated media URLs]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Outputs may include temporary generated media URLs, task IDs for polling, API error messages, and configuration requirements for LinkFoxAI credentials.]\n\n## Skill Version(s):\n\n1.5.1 (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":"调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Skill: LinkFoxAI Owner: linkfox-ai Summary: 调用 LinkFox AI 开放平台 AI 作图/视频 API（换模特、抠图、扩图、场景裂变、智能修图、套图、姿势裂变、带货口播、图转视频等）。适用场景：(1) AI 任务创建与结果轮询，(2) 通过 api-call 调用任意开放平台接口，(3) 素材连通性测试。 Tags: latest:1.5.1 Version history: v1.5.1 | 2026-06-12T06:15:20.181Z | user 新增：视频复刻 video-reclone，支持 SEED、SEED_FAST 两个模型进行视频复刻生成。 调整：商品套图/服装套图支持「无字模式」--no-text，生成纯画面、不带文案排版。 调整：图转视频/带货口播新增支持SEED_FAST模型生成 v1.5.0 | 2026-05-07T12:44:16.506Z | u","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1275,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:02:50.605Z","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-09T12:02:50.605Z","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-09T19:38:26.312Z","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"}]}}}