百音 AI 歌手训练

解决的问题

当用户需要基于音频创建百音 AI 歌手模型时，常见卡点不在调用接口，而在参数组织：本地音频、聊天附件或网盘私链不能直接训练，可选字段过多，中文名称可能乱码，任务状态与最终结果也容易混淆。这个技能把“训练歌手”“查询进度”“获取结果”收敛为同一套百音开放平台任务流程，并尽量减少不必要的追问。

技能如何工作

• 创建模式：从对话中提取 name、materialUrl、description、avatar、tags 和 trainType。缺少可选字段时不阻塞，默认 trainType = 2；用户要求高质量时映射为 1。如果只有本地文件或不可公网访问的链接，会先建议通过百音文件上传接口 POST /api/open/v1/file/upload 获取 data.url，再填入训练请求。
• 状态与结果模式：使用任务查询接口 GET /api/open/v1/tasks/{taskId} 获取 queued、processing、succeeded、failed。成功时优先返回 modelId、demoUrl，以及 modelName、avatar、userTaskId、trainType。
• 可靠性处理：对中文 name、description、tags 强调 UTF-8 编码；若返回的 modelName 出现 ??、乱码或明显异常，会标记为异常结果，而不是当作训练成功。
• 轮询边界：只有用户明确要求持续等待时才轮询，默认间隔约 10 分钟，单轮最多 6 次；queued 或 processing 继续等待，succeeded 或 failed 停止。

适用边界与注意点

• 需要有效的 BAIYIN_API_KEY，且训练音频必须是可访问的公开 URL。
• 适用于 AI 歌手训练任务，不适用于普通 AI 翻唱结果生成。
• 查询状态或结果时，如果上下文没有明确 taskId，仍需用户提供。
• 后端返回 400、401、402、404 时，技能会按参数、鉴权、余额、任务不存在等方向提示修正，不猜测最终模型结果。