AI配音工作台

这个技能能帮你什么

把「一段文字」变成「一段能直接用的配音音频」。

做视频、录课程、做有声内容的人都知道：配音这事看着简单，真上手全是坑——免费工具音色机械像机器人念稿，专业软件要配 API、调参数、试十几个音色，搞一小时还没出成品。它把这条链路封装成一次操作：

1. 音色匹配：根据你的文案场景（宣传片/课程/故事/口播），推荐合适的音色，不用自己在几十个音色里试
2. 情绪语速设定：按场景给推荐参数（激昂/沉稳/温柔/活泼 + 语速），可直接用也能微调
3. 智能分句停顿：长文自动断句、加自然停顿，避免一口气念完的机器感
4. 成品音频交付：直接产出可下载的音频文件，不是教程、不是参数表
5. 商用授权说明：输出附带授权范围说明，用起来安心

开始之前

提供以下两项（缺一不可）：

1. 配音文案：要配音的文字内容（复制粘贴即可）
2. 使用场景（可选但强烈建议）：宣传片 / 课程讲解 / 故事旁白 / 短视频口播 / 有声书……没有就按"通用口播"处理

> 提示：第一版为控制生成质量与成本，单次建议 500-1500 字；文案更长会自动引导分段处理。

你会拿到什么

1. 配音方案：音色推荐 + 语速/情绪参数 + 分句停顿标记（先看方案，不满意可调整）
2. 音频文件：按确认后的方案生成的可下载音频
3. 商用授权说明：本次产出的使用范围说明

使用示例

示例 1：短视频口播（活泼、快节奏）
> 用户：文案"今天教大家三招，让简历在 HR 眼里多活五秒"+ 场景"短视频口播"
>
> 方案：音色=活泼女声（适合口播）；语速=中快；情绪=有活力、节奏感强；断句=短句切分
> 产出：带节奏的口播音频 + 授权说明

示例 2：企业宣传片（沉稳、大气）
> 用户：文案"十年深耕，我们只做一件事，让每一份信任都有回响"+ 场景"宣传片"
>
> 方案：音色=沉稳男声（适合宣传片）；语速=中速偏慢；情绪=大气、有质感；停顿=关键句前后留白
> 产出：有质感的宣传片配音 + 授权说明

注意事项

• 文案真实使用：配音内容来自用户提供的文案，不代为改写文案主体（可优化断句、口语化节奏）
• 不承诺绝对效果：描述用"更自然、少机器感"，不做"完全不像 AI"的绝对化承诺
• 商用边界：输出附授权范围说明；涉及他人声音克隆、模仿特定名人声音等请求一律拒绝
• 适合/不适合：
• ✅ 适合：短视频口播、课程讲解、有声内容、宣传片旁白、PPT 演示配音
• ❌ 不适合：声音克隆（需本人授权且第一版不做）、恶意模仿特定人物声音、将配音用于欺诈/造谣内容

隐私与安全

• 你的配音文案仅用于本次生成，不存储、不泄露
• 唯一外送：仅完成付费验证时，将用户确认过的最小必要字段（订单验证所需的输入摘要）发送至支付网关（仅用于订单生成与支付状态校验）；发送前向用户明示域名、字段与用途并取得确认，用户未同意不发送
• 音频生成：仅在用户确认配音方案后调用音频生成能力，不擅自生成
• 除付费验证与音频生成外：不联网、不读取外部数据、不调用其他外部服务

付费调用执行协议（Agent 执行层）

> 本技能为付费技能（X402 协议），内容由统一支付网关（pay-gateway）承载。
> 本协议对 Agent 可见，支付细节由 Agent 向用户透明说明（Agent 代为引导支付）。
> 支付透明原则：发起支付前，Agent 必须向用户明示服务价格（¥2.99）、收款方（技能开发者/微信支付商户）与支付步骤，获得用户明确同意后再引导支付；用户未同意不得发起支付。
> 时长说明：本服务生成需要约 1 分钟（不是秒出），中途可能返回一次「生成中」（HTTP 504，属正常过程）。发起调用前先告诉用户"AI配音工作台需要约 1 分钟生成"。

前置检查：当前智能体是否支持微信 AI 支付（发起下单前必须最先执行）

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具
（如 mcp__weixinpay__weixinpay_register，工具名带前缀也算；存在任意一个即视为支持）。

只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持：按下方「支付方式：平台自适应」继续本 Skill 的流程。本项检查是公开、可告知的：无需专门向用户宣布这一检查，但用户若问起请如实说明检查结论。
• 不支持：终止流程且不要发起下单（不调用本技能网关接口、不生成订单）。只向用户说明结论与解决办法（结论透明、过程从简：不必展开你如何检查，也避免把内部工具名抛给用户造成困惑），按智能体类型提示：
• 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
• 开放智能体（如 OpenClaw / DeepSeek Harness）：请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/weixinpay-installer。
• 无法判断类型：请升级智能体或安装微信 AI 支付插件后重试。

> 判定条件不可改写：必须「按子串 weixinpay_ 匹配 + 存在任意一个即可」，不要检查某个特定完整工具名（如 weixinpay_pay），否则在不支持的环境里会把"支持"误判成"不支持"。

支付方式：平台自适应

本技能支付采用平台自适应策略——不预设走哪条流程，收到网关 402 后按实际情况处理（前提：上方「前置检查」判定为「支持」；判定为「不支持」时按前置检查终止，不进入本步骤）：

1. 先看平台是否已自动拉起支付：在已接入自动支付的平台（如 WorkBuddy），网关返回 402 后平台会自动弹出支付卡片并完成支付。若系统提示"支付已由系统发起/支付成功"，不要调用任何支付工具，直接进入履约重试（见下）。
2. 平台未自动支付时，默认用「二维码扫码」：把 402 响应体中的 code_url 渲染成二维码让用户微信扫码支付（最低门槛，任何平台可用）。
3. 仅在平台未自动拉起、二维码也不可用、且用户明确要求时，若你的工具列表中存在 weixinpay_ 工具，才考虑调用 weixinpay_pay（传入 WeixinPay-Required 的 payment_code）。

⚠️ 工具存在 ≠ 需要你调用：在已接入自动支付的平台，402 返回后支付由系统代办，不要主动调用 weixinpay_pay（会被系统拒绝，并可能让你误判"还没付款"而重复引导用户付费）。

网关服务

• BASE_URL：https://phantom-ai.cn
• 调用接口：POST {BASE_URL}/api/v1/skill/peiyin-gongzuotai/invoke

请求体

{
  "prompt": "用户输入（用户确认后发送）",
  "meta": {}
}

履约流程（支付成功后）

1. 首次调用：POST /api/v1/skill/peiyin-gongzuotai/invoke，不携带 X-Out-Trade-No。
   - 网关返回 HTTP 402，响应体与响应头均携带 X-Out-Trade-No（订单号）与 WeixinPay-Required（值等于 WeixinPay.payment_code）；code_url（微信 Native 支付二维码链接）在响应体中。取值读响应体即可（字段更全）。
2. 支付：按「支付方式：平台自适应」处理（平台自动支付 / 二维码扫码 / 兜底 weixinpay_pay）。
   - 二维码渲染：优先用本地二维码能力（如 Python qrcode 库 / 平台图片生成工具）；无本地能力时用公网服务 https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=<urlencode(code_url)>；若本地与公网二维码能力均不可用：直接把 code_url 原样展示给用户，并说明"请在微信中打开此链接完成支付"，不要把支付流程卡在二维码渲染上。
   - ⚠️ code_url 是 weixin:// 支付链接，必须渲染成二维码让用户用微信「扫一扫」支付，不要当作普通网页链接直接发给用户。
3. 重试履约（504 是正常过程，不是失败）：支付完成后，携带响应体中的 X-Out-Trade-No 重新请求同一接口（同一请求体）。
   - 生成需要约 1 分钟，超过网关 45 秒等待窗口会返回 HTTP 504（响应体 {"ok":false,"retryable":true,"user_message":"正在生成，请稍等片刻，已保留您的订单，不会重复扣费。"}）。继续用同一个 X-Out-Trade-No 重试即可，通常 1–2 次内返回 200。
   - 已支付且生成完成 → 返回 {"ok": true, "skill_id": "peiyin-gongzuotai", "result": "配音方案（音色+语速/情绪+智能分句）+ 可下载配音音频 + 商用授权说明"}
   - 未支付 → 再次返回 402（继续提示用户支付；同一订单重复请求是幂等的，不会重复扣费）。
4. 交付内容：把 result 中的内容按技能要求的格式直接交付给用户。

异常处理

• 生成中（HTTP 504 / ok:false + retryable:true）：内容正在生成、订单已保留、不会重复扣费。用同一个 X-Out-Trade-No 重试，间隔 5–10 秒，最多重试 3 次；3 次仍未拿到结果时，告知用户「内容仍在生成中，订单已保留，稍后可继续获取」——不要重新下单，不要再次引导用户支付；用平实语言说明进度即可（如「内容仍在生成中，订单已保留」），不要下"失败"的结论。
• 未支付/支付中断：再次返回 402 时，说明支付尚未完成，引导用户继续支付（平台自动支付/扫码/兜底 AI 支付），不重复下单。
• 长时间重试后仍无结果：订单已保留、不会重复扣费。请保留订单号、不要重新下单，稍后可用同一订单继续获取。若用户要求退款：退款为人工处理，向用户说明「请提供订单号，我们将在 1–3 个工作日内原路退回」——不要承诺"已自动退款"（网关无退款接口）。
• 重复请求：订单已支付后重复请求同一 X-Out-Trade-No 是幂等的，可安全重试；不要重复向用户收费或重复下单。
• 缓存命中：同一订单同一内容再次请求会秒回（cached:true），内容与首次一致，属正常缓存，不要重复引导付费。

注意事项

• 402 / 504 都是正常支付流程，不是错误。请用平实语言向用户说明当前进度（如「正在等待支付完成」「内容正在生成中」），不要下"出错了/失败了"的结论。
• 网关生成的内容已内置技能方法论与合规要求，Agent 无需重复加工。
• 价格：¥2.99/次（price_fen=299）