开发者
使用 API Key 和 Shortcuts
接入可重复的捕捉或转写流程，同时保护密钥。
- 适合用户
- 想把 Vowise 接入现有工作流的开发者和高级用户。
- 预计时间
- 18 分钟
- 难度
- 高级
使用场景
先确认这篇教程适合什么工作流，再进入操作步骤。
作为自动化搭建者，我想用可重复的方式把音频发送到 Vowise，这样就不用每次手动上传文件。
你会知道 API Key 适合放在哪里、如何测试公开接口，以及应该遵守哪些密钥处理规则。
完整步骤
1
创建或找到 API Key
在账号里专门用于 API Key 的入口创建或查看密钥。把它当作密钥，不要写进公开视频或教程截图。
密钥没有保存在仓库里。
截图会遮挡或省略密钥。
2
测试公开 API 参考
先用 `/api-reference` 了解公开转写和词典请求结构，再放进自动化。
你知道认证 Header 的格式。
你知道哪些接口是公开的。
3
搭建自动化封装
用 Shortcuts、本地脚本或服务端工作流封装请求，并确保密钥不暴露。
工作流不会在日志里打印密钥。
失败信息可见，但不暴露凭据。
补充说明
密钥处理规则
文档可以讲请求结构，但示例应使用占位符，不要包含真实密钥、可复用密码或私人 URL。
- 文档和截图里使用占位符。
- 真实密钥放在本地密钥库或服务端配置。
- 如果密钥出现在公开视频里，立即轮换。
关联功能路径
这篇教程完成后，不应该停在这里。下面是它自然连接到的功能和下一步。