PoYo 替换段落（Replace Section）功能

PoYo 相关链接

• 模型页面：https://poyo.ai/models/replace-section
• API 文档：https://docs.poyo.ai/api-manual/music-series/replace-section
• API 密钥页面：https://poyo.ai/dashboard/api-key

本技能用于在 PoYo 平台上执行 replace-section 类任务。它可协助智能体构建音乐段落替换的请求载荷（payload），精确定义待替换的时间区间，提交异步请求，并说明如何获取处理结果。

适用场景

• 用户明确希望替换某条已由 PoYo 生成的音乐音轨中的特定段落。
• 用户已拥有完成状态的 PoYo 音乐任务 task_id 和对应音频 audio_id，并请求生成编辑载荷、服务端 curl 命令、回调（callback）配置或结果获取方式。
• 用户已在音乐编辑工作流中明确选定 PoYo 作为执行提供方。

模型选择

• replace-section：适用于在已生成的音乐音轨中，以新音乐内容替换指定时间范围内的原有内容。

关键输入参数

• task_id：标识源音乐生成任务（需为已完成状态）。
• audio_id：标识待编辑的具体音频轨道。
• prompt：描述待替换段落所需生成的新音乐内容。
• tags：描述替换段落所需的风格或情绪特征。
• title：为最终生成的音轨命名。
• infill_start_s 与 infill_end_s：以秒为单位定义待替换的时间区间（闭区间）。
• full_lyrics：当工作流涉及歌词修改时，根据文档化 schema 要求，该字段为必填项。
• callback_url：为可选字段，适用于生产环境中的队列式处理流程。

安全规范

• 将 POYO_API_KEY 视为敏感凭据，严格保密。
• PoYo API 密钥应仅存储于服务端环境变量或后端密钥管理服务中。
• 严禁将 API 密钥嵌入浏览器端代码、前端构建产物、公开代码仓库、日志、截图或聊天输出中。
• 除非产品策略明确允许，否则不得记录私有 prompt、歌词、客户 task id、音频标识符、生成文件 URL、callback URL 或原始鉴权请求头等敏感信息。
• 除非用户明确要求使用 PoYo Replace Section API 工作流，否则不得将本技能用于通用型音乐编辑场景。
• 除非用户明确要求发起调用、确认载荷将发送至 PoYo 且运行环境为安全的服务端环境，否则不得执行实际的 API 请求。

执行方式

• 请查阅 references/api.md 获取接口地址、请求字段、示例及结果获取说明等详细信息。
• 仅当用户明确要求、且在可信 shell 环境中运行时，方可使用 scripts/submit_replace_section.sh 提交已准备好的 JSON 载荷。
• 若用户仅需一个 curl 示例命令，请基于 references/api.md 中的示例进行适配。
• 提交成功后，请清晰返回并报告响应中的 task_id，以便后续状态查询操作便捷进行。

输出预期

在协助用户完成 Replace Section 操作时，输出内容应包含以下要素：

• 所选模型 ID
• 源任务与音频标识符摘要
• 待替换的时间区间
• prompt、标题、风格标签及歌词内容摘要
• 最终请求载荷，或简洁明了的参数汇总
• 若已实际提交请求，则须返回响应中的 task_id
• 下一步操作建议：主动轮询任务状态，或等待 Webhook 回调