技能介绍

解决的问题

当语音生成需求落到具体 API 时，工程师常被字段类型、模型标识、音色 URL 和参数边界卡住：prompt 为空会触发 400，modelCode 不能硬编码，params.speed_level 与 params.pitch_level 必须传 number，voice_url 又必须是可访问的 http/https 公网音频地址。百音 AI 语音生成技能把这些自然语言请求收敛为百音开放平台的稳定任务请求，避免模型猜测和兜底字段。

工作方式

运行时约束：固定调用 https://ai.hikoon.com，仅在缺少 BAIYIN_API_KEY 时向用户索要。
模型选择：调用模型列表接口获取可用语音模型，向用户展示 modelName，提交时使用接口返回的 modelCode。
参数映射：把“慢一点”“高音”“治愈”等表达映射为 speed_level、pitch_level、emotion；未指定时使用默认值，减少追问。
音色处理：静默获取音色列表，默认取第一条 audioUrl，也可接受用户提供的公网音频链接用于音色克隆。
任务闭环：创建任务后复用最近 taskId 查询状态；只有查询结果明确为 succeeded 时才交付音频链接。

适用边界

适合接入百音开放平台的语音合成、状态查询和结果获取。需要注意：必须提供非空 prompt，模型必须来自实时接口，voice_url 不能是本地路径或 file://，数值参数必须是整数 1-5。对于 queued、processing 或 failed 状态，技能应如实返回状态或后端 error，不应虚构完成结果。