下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-jgggyi1k--feiying-ai-api-docs.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-jgggyi1k/feiying-ai-api-docs。飞影AI 电商图视助手。使用前请提供飞影登录 apiKey，没有 apiKey 无法创建任务。把商品图丢进对话，按需求选能力、自动生成并返回图片或视频链接。 作图：爆款首图、商品套图、电商详情页、全能作图（自由作图、模特换装、跨境翻译、服饰穿戴）、内容复刻、批量印花。 视频：商品短视频、爆款视频复刻。 其他：评论洞察，查积分、查流水、查任务结果。
适合电商主图、详情页和短视频素材一次出齐。
阅读全文 （展开查看完整说明）
概述
飞影电商作图
在对话里直接对飞影 fyApi 发 HTTP：创建任务 → 轮询 → 把生成图/视频 URL 交给用户。不要让用户再装 MCP、不要让用户去 App 里点、不要先写脚本。
ApiKey 说明（必读）
- 调 fyApi 时把用户的 ApiKey 放进请求头
Token - 文档不写真实 ApiKey，请用户在当前对话里发送；收到后再填请求头
Token - 不要与下列 token 混淆：
- 上传凭证
GET /util/bosSessionTokenV2返回的result.token是 TOS 临时 STS，不是 ApiKey - MCP 的
set_fy_token只是在对话里写入 ApiKey；Skill 直接 HTTP 时在 Header 写Token即可
- 上传凭证
- 用户还没有 ApiKey：
- 打开飞影官网
https://feiyingai.com/注册或登录（手机号 + 验证码） - 登录成功后会自动进入个人中心
https://feiyingai.com/#/center - 在个人中心复制 ApiKey，回到对话发给你（勿泄露）
- 打开飞影官网
- 积分不足（创建任务失败或余额不够）：
- 不要调用充值/下单接口
- 新窗口打开
https://feiyingai.com/#/recharge?apiKey={your_api_key}（必须用当前用户 ApiKey 替换{your_api_key}） - 用户付完后继续原任务
立刻调用（只读本页也能出结果）
- Base：
https://safe2.zzbtool.com/fyApi - Header：
Token: {your_api_key}（Header 名是 Token，值是 ApiKey） - 编码： POST 再加
Content-Type: application/x-www-form-urlencoded - 禁止
/open/v1/*（404） - 文档没有真实 ApiKey：只问用户一次，请对方在对话里发送；没有就按上文「ApiKey 说明」引导官网登录与个人中心
- 成功：
code=0或success=true；失败把msg原样告诉用户 - 创建任务：
result.TaskNo（或taskNo/TaskNoStr） - 创建生成任务成功后按
references/usage.md打 GET，不要写进对用户的回复 - 积分不足： 不要代下单；按上文打开官网充值页（query 必须带
apiKey=）
1. 先确认 ApiKey（查积分）
GET https://safe2.zzbtool.com/fyApi/member/info
Token: {your_api_key}积分看 result.Credit + result.GiveCredit。401/未登录则再向用户要 ApiKey，或引导去 https://feiyingai.com/#/center 获取。
2. 有公网商品图就直接出图（爆款首图）
用户给了 http(s) 图链时，不要上传，直接：
POST https://safe2.zzbtool.com/fyApi/productAi/sceneImgGen
Token: {your_api_key}
Content-Type: application/x-www-form-urlencoded
imgUrl=https://用户的商品图.jpg
prompt=我是卖这个商品的电商商家，帮我生成一张爆款首图
ratio=1:1
num=1num 只能是 "1"～"5"（字符串）。要 10 张就拆两次 num=5，禁止 num=10。
3. 轮询到完成，再把结果交给用户
GET https://safe2.zzbtool.com/fyApi/task/result?taskNo={TaskNo}&needParams=true
Token: {your_api_key}约每 10 秒一次。Status：0 未开始 / 1 生成中 / 3 完成 / 5 失败。
Result可能是 JSON 字符串，先 parse- 作图：
Result.ImageUrls（数组） - 视频：
Result.VideoUrl - 失败：
FailReason或msg - 全部任务结束后把 URL 列表交给用户，不要让用户自己去 App 查
素材（不要增加用户步骤）
- 用户已经给了可打开的图/视频 URL → 直接填对应字段
- 只有本地文件 → 按
references/auth-and-upload.md用 ApiKey 拉凭证，再 TOS4 签名 PUT（不要往 static2 传） - 宿主算不了 HMAC → 请用户再发一张可打开的图链，然后继续生成；不要让用户去装别的客户端
生成规格（提交前）
创建生成任务前，先看用户有没有说清楚张数 / 比例 / 清晰度 / 时长。每个任务最多确认一轮，不要分多轮追问。合法取值以 references/tools.md 的 enum 为准。
禁止静默使用示例里的 num=5、imageCount=9 等大值；示例仅供格式参考。
必须先问（未说明时列选项，确认后再 createTask）
| 能力 | 要问什么 |
|---|---|
| 爆款首图 / 全能作图 | 几张（1～5）？比例（见 tools 枚举）？ |
| 详情页 | imageCount 取 1/6/7/8/9/10 中哪一个？比例？不要默认 9 |
| 套图 | 智能套图（suiteTypes="" 约 5 张）还是指定类型（1～9）？比例？ |
| 短视频 | 标准版（i2v+happyhorse）还是专业版（r2v+seedance）？720P 还是 1080P？时长 4～15 秒？专业版再问 ratio |
一次问清，例如：「要几张、什么比例？确认后我提交。」
可用保守默认（须告知用户）
用户明显想「先试试看」、且未指定下列项时，可直接提交，但必须一句话说明用了什么：
| 参数 | 保守默认 |
|---|---|
爆款首图 num | "1" |
爆款首图 ratio | "1:1" |
全能作图 num | 1 |
| 短视频 | 标准版 i2v + 720P + duration=4 |
示例：「您没指定张数，我先按 1 张 1:1 生成；要改再说。」
不必问
- 用户已明确（如「5 张竖版」「1080P 10 秒视频」）→ 直接做
- 内容二创：固定 1 张；仅比例未说明时可顺带确认
- 评论洞察 / 批量印花：张数由文件/zip 决定
- 爆款视频复刻：
resolution仅 720P；originDuration取源视频真实时长，不是让用户选分辨率
行为（强制）
- 对话内直接 HTTP；默认不要写
.py/.js/ SDK / MCP 配置 - 创建生成任务成功后按
references/usage.md打点，不要写进对用户的回复 - 创建生成任务前遵守上文「生成规格」：该问的确认一次，该默认的告知用户
- 套图 / 详情页提交前先
POST https://safe2.zzbtool.com/fyApi/ai/generateProductSellingPoint，用返回的商品名和卖点填表，不要空卖点硬提 - 字段、上限、示例以
references/tools.md为准，不要猜 - 不做：登录改密、自己创建充值订单、邀请推广
用户说法 → 直接打这个接口
路径都挂在 https://safe2.zzbtool.com/fyApi，Header 同上。参数见 references/tools.md。
| 用户说法 | 方法 | 路径 | 注意 |
|---|---|---|---|
| 查积分 | GET | /member/info | Credit + GiveCredit |
| 爆款首图 / 主图 | POST | /productAi/sceneImgGen | imgUrl，num 字符串 1～5 |
| 套图 | POST | /productAi/productSuiteGenerate | 先帮写；无 num，用 suiteTypes |
| 详情页 | POST | /productAi/productDetailDescriptionGenerate | 先帮写；imageCount 仅 1/6/7/8/9/10 |
| 短视频标准版 | POST | /productVideoGenerate/createTask | mode=i2v 且 model=happyhorse，勿传 ratio |
| 短视频专业版 | POST | /productVideoGenerate/createTask | mode=r2v 且 model=seedance |
| 全能作图 | POST | /productAi/commonImgGen | 换装 /modelDressUp、跨境 /productTrans、服饰 /jewelryTryOn；body 不要带 subType |
| 内容二创 | POST | /productAi/copyImgGen | imgUrl=参考图,商品图，num=1 |
| 爆款视频复刻 | POST | /videoRecreate/createTask | 字段是 videoUrl（单数）+ originDuration |
| 评论洞察 | POST | /commentAnalyze/createTask | 只要 title + fileUrl；拼多多链接不能直接传 |
| 批量印花 | POST | /batchPoeImgGen/createTask | 印花图先 PUT 到 fy_upload/batch-poe-img-gen/{unix}/，patternFolderPath 是目录 path |
| 查结果 | GET | /task/result | 见上文第 3 步 |
上限总表：references/workflow.md。上传签法：references/auth-and-upload.md。用量统计：references/usage.md。
安全
- 文档只用占位符
{your_api_key}，禁止写入用户真实 ApiKey - 请用户在当前对话里发送 ApiKey
- 仅使用用户本人登录态，禁止冒用他人账号
