seedance2.5 视频提示词优化

概述

Seedance 2.5 提示词优化（付费AI服务）

功能描述

本技能提供付费的 Seedance 2.5 视频提示词优化服务。用户输入一段原始提示词，经服务端规范、扩写、增强为结构化镜头提示词；每次优化需要支付 0.9 元。

触发场景（命中任一项即启用）

• “优化 / 润色 / 扩写 / 增强 / 规范化这段 Seedance 提示词”
• “帮我把这条 prompt 优化，走付费”
• 用户粘贴一段视频生成提示词，明确要求“优化 / 改写”且接受付费
• 用户提到 seedance 提示词质量不佳，需要结构化改写并愿意支付 0.9 元

本技能只做提示词优化，不生成视频、不分镜、不调用 Seedance 模型本身。

付费前置检查

• 调用方 Agent 已启用 weixinpay 插件，具备支付插件调用能力；未安装则向用户提示“当前 Agent 暂不支持微信支付付费能力”并终止流程。
• 开发者服务已部署并可公网访问（接口地址见下方「付费调用流程」）。
• 请求参数包含 query（待优化的原始提示词）。

工作流程

第一步：请求资源（首次，未支付）

向统一接口发起首次 POST 请求：

POST https://seedance-api.loopchat.top/api/resource
Content-Type: application/json

{ "query": "用户的原始提示词" }

未支付时，服务返回 HTTP 402，并通过响应 Header / Body 返回支付信息。Agent 需要从响应中读取并保存：

• Header WeixinPay-Required：支付码（paymentCode）
• Header X-Out-Trade-No：商户订单号

两者都必须保存，缺一不可。

响应体示例：

{
  "code": "PAYMENT_REQUIRED",
  "message": "本次 Seedance 提示词优化需要支付 ¥0.9",
  "WeixinPay": {
    "WeixinPay-Required": "payment_code_xxx",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "WX402_20260630120000abcdef123456",
  "amount": 90,
  "currency": "CNY"
}

支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。

第二步：处理 402 响应（支付由插件完成）

如果收到 HTTP 402 响应，weixinpay 插件会拦截并完成支付流程，无需手动调用支付接口。

402 响应中会通过 Header 和 Body 返回支付信息：

• Header WeixinPay-Required：支付凭证码（插件用于完成支付）
• Header X-Out-Trade-No：商户订单号

支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。

第三步：发起支付

将 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay 向用户申请支付授权。

第四步：支付成功后获取资源（⚠️ 必须执行）

支付成功后重新发起请求获取付费内容，body 与第一步完全一致，并通过请求头携带支付信息：

POST https://seedance-api.loopchat.top/api/resource
Content-Type: application/json
WeixinPay-Required: <第二步保存的支付码>
X-Out-Trade-No: <第二步保存的订单号>

{ "query": "与第一步完全一致的原始提示词" }

⚠️ 第四步是最容易被 Agent 遗漏的一步：不携带 X-Out-Trade-No Header 重试，就永远拿不到付费内容。Body 必须与第一步完全一致，仅通过 Header 传递订单号和支付凭证。

支付成功后返回 HTTP 200：

{
  "code": "SUCCESS",
  "message": "付费内容获取成功",
  "out_trade_no": "WX402_20260630120000abcdef123456",
  "transaction_id": "4200001234202306300000000001",
  "content": "【优化后的提示词】...",
  "already_fulfilled": false
}

第五步：处理退款响应

如果第三步返回 "code": "REFUNDED"，说明商户服务异常无法提供内容，已自动退款：

• 向用户说明：“抱歉，该服务暂时无法提供内容，已自动退款至原支付账户。”
• 不要再次尝试支付或重新请求

注意事项

1. 必须先通过“付费前置检查”确认 weixinpay 插件已安装，否则不要进入支付流程
2. 收到 402 响应时，支付由 weixinpay 插件完成，Skill 无需关心支付细节
3. 支付成功后必须主动发起重试请求，body 保持不变，通过 Header X-Out-Trade-No 传递订单号
4. 如果返回 "code": "NOT_PAID"，说明支付尚未完成，请等待后重试
5. 如果返回 "code": "REFUNDED"，说明服务异常已退款，告知用户并终止流程
6. 如果返回 "code": "FULFILL_AND_REFUND_FAILED"，说明服务异常且退款失败，建议用户联系客服

结果美化展示（拿到 content 后）

拿到响应体 content（优化后的提示词）后，不要原样平铺，按以下方式呈现以提升可读性：

1. 分镜拆解：若内容含多个 Shot / 镜头，用二级标题或卡片分镜展示，每镜标注 主体 / 动作 / 空间关系 / 镜头运动 / 光线 / 音频 / 结束状态 / 约束 八个要素。
2. 关键参数高亮：对 Seedance 关键字段（镜头运动、光线、音频、约束、结束状态）用粗体或引用块突出。
3. 前后对照（若用户给了原始提示词）：附一段「优化前 → 优化后」对照，点明补全 / 规范了哪些要素。
4. 可直接复制版：在末尾给出一份纯文本版（代码块），方便用户直接粘贴到 Seedance。
5. WorkBuddy 环境（可选增强）：可用 present_files / 内联卡片把结果渲染为可读卡片或预览面板；多镜头场景也可用可视化组件分镜展示。

呈现示例（单镜头，示意，非真实项目）：

MARKDOWN复制

## 优化后提示词（Shot 1）
**主体**：少女（双马尾、米色风衣）/ 橘猫（蜷坐窗台）

**动作**：少女伸手逗猫 → 猫抬眼 → 尾巴轻摆

**镜头运动**：`Slow push-in`（由全景推至中景）

**光线**：午后斜阳暖调 + 窗边冷调补光

**音频**：猫咪呼噜声、远处车流白噪

**约束**：吉卜力手绘风、主体居中

可直接复制：

午后窗边，少女伸手逗弄蜷坐窗台的橘猫……

容错与排查

• 第一步未读到 402 / 缺支付信息：检查网络与技能调用地址；确认响应 Header 含 WeixinPay-Required 与 X-Out-Trade-No。
• 第三步返回 NOT_PAID：用户尚未完成微信支付，等待后重试第三步（body 与 Header 均不变）。
• 404 ORDER_NOT_FOUND：订单号在服务端不存在（多为部署环境内存态被回收 / 订单号填错）。核对 X-Out-Trade-No 与第一步一致，且 body 与第一步完全一致。
• REFUNDED：服务端异常无法提供内容，已自动退款；向用户说明“已退款至原支付账户”，不要再次支付。
• FULFILL_AND_REFUND_FAILED：服务异常且退款失败，建议用户联系客服。
• 非 200/402：打印原始响应体；多为服务端异常，附报错信息排查。

安全提示

• 本技能不持有任何微信支付密钥；真实支付由 weixinpay 插件完成。
• WeixinPay-Required 与 X-Out-Trade-No 仅用于 X402 协议流程，不要在回复中展示给用户。