跳到主要内容

使用案例：用 QQ音乐助手查歌与看榜

本案例展示如何只用对话就让 AI 调用 QQ音乐开放平台接口，完成歌曲搜索、排行榜查看、每日推荐、AI 歌单和听歌报告。首次使用时 AI 会自动发现密钥未配置并引导你完成初始化，无需手动翻文档。

点击播放查看完整操作演示
案例前提

第 1 步：提出音乐查询需求​

在对话中直接说出你要做什么，例如“看看今天的热歌榜”“搜一下周杰伦”“推荐一些跑步歌单”。AI 会识别意图并调用对应接口。

AI 自动发现密钥未配置并说明配置方式

第 2 步：按提示完成密钥配置​

首次使用时，若 AI 检测到 QQMUSIC_API_KEY 环境变量尚未设置，会自动询问并引导你完成初始化：提供 API Key 后，AI 会将其写入当前 Shell 配置文件并立即生效，无需手动编辑文件。

AI 引导写入 QQ音乐 API Key 环境变量
密钥安全

QQ音乐 API Key 与你的账号绑定，写入本地环境变量后仅供本机调用，请勿把 Key 粘贴到公开聊天或截图中。

第 3 步：查看结果并继续对话​

密钥生效后，AI 会继续完成查询，用列表展示歌曲、歌手和排行榜，并附带播放链接。后续对话会记住已查询的内容，无需重复提供。

AI 返回的 QQ音乐排行榜结果

常见问题​

现象可能原因建议处理
AI 提示未配置密钥QQMUSIC_API_KEY 未设置按 AI 引导提供 API Key，让其写入环境变量
接口返回限流错误调用过于频繁稍等片刻后重试，避免在循环中连续高频调用
查询结果为空关键词或参数不匹配换一种说法描述需求，或明确指定歌手/歌曲名

下一步​