后端与接口
需要配置 Vapi 语音 AI 平台 API Key 时…
当用户需要接入 Vapi 语音 AI 平台、API 调用因缺少密钥失败,或需要配置 VAPI_API_KEY 环境变量时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
需要配置 Vapi 语音 AI 平台 A特定
解决思路
- 告知用户打开 Vapi Dashboard 的 API keys 页面 https://dashboard.vapi.ai/org/api-keys;若还没有账号,先到 https://dashboard.vapi.ai/signup 注册。
- 指导用户创建密钥:点击 "Create Key",为密钥命名(例如 "development"),立即复制密钥——它只显示一次。
- 明确要求用户不要把私钥粘贴到聊天中,而是按后续步骤保存到本地,保存好后告知即可;然后等待用户确认本地环境文件已就绪,不要索取或展示密钥。
- 确认密钥可用但不打印它:优先使用已有的环境变量;否则让用户用编辑器把密钥保存为本地 .env.local 文件中的 VAPI_API_KEY,绝不显示文件内容。
- 在加载了该环境变量的环境中验证密钥:curl -s -o /dev/null -w "%{http_code}" https://api.vapi.ai/assistant -H "Authorization: Bearer $VAPI_API_KEY"。
- 若验证失败(非 200 响应):告知用户密钥似乎无效,请其重新核对并重试,并再次提醒密钥页面地址 https://dashboard.vapi.ai/org/api-keys。
- 若验证成功:在不显示值的前提下,确认本地环境文件包含 VAPI_API_KEY=<the-api-key>。
- 向用户确认成功:密钥已作为 VAPI_API_KEY 配置在本地,现在可以使用 Vapi API 创建 assistant、拨打电话并构建语音 AI agent,并提醒妥善保管密钥、不要提交到版本控制。
- 检查 .gitignore 是否保护了本地环境文件;若没有,添加:.env* 和 !.env.example。
- 记住所有 Vapi 技能都从 VAPI_API_KEY 环境变量读取密钥,API 基础地址为 https://api.vapi.ai,认证方式为 Bearer token:Authorization: Bearer $VAPI_API_KEY。
- 如需高级配置、故障排查、SDK 细节等超出本技能的内容,可使用 Vapi 的 documentation MCP server 搜索其知识库,配置方法见 https://docs.vapi.ai/cli/mcp。
适用边界 · 注意事项
- 用户尚未注册 Vapi 账号或无法访问 Vapi Dashboard 时(需先完成注册)。
- 用户不愿在本地保存密钥、坚持要在聊天中粘贴私钥时(存在泄露风险,不应继续)。