获取您的 Ody API 密钥
您可以在设置 → 开发者 API中创建 API 密钥：命名密钥，选择其范围，选择实时或测试，点击创建密钥，并从一次性横幅中复制密钥。
开始之前
- 您必须是工作区管理员或所有者才能创建或撤销密钥。
- 密钥以创建者的身份行事 — 它们在应用中永远不能拥有比创建者更多的权限。
分步指南
点击侧边栏中的设置，然后点击开发者 API。（在您的手机上：更多 → 设置 → 开发者 API。）
在创建表单中，输入一个密钥名称 — 例如“Zapier”或“生产服务器” — 以便您以后能够区分密钥。
使用名称字段下方的芯片选择密钥的范围。所有十个都已预选，这将创建一个完全访问密钥；取消选择芯片以缩小范围。可用的范围包括读取联系人、管理联系人、读取对话、更新对话、发送消息、读取号码、管理 Webhook、购买号码和 10DLC、拨打 AI 电话和管理 AI 代理。
在密钥类型下，选择实时或测试。实时密钥以
ody_live_开头，并执行所有真实操作。测试密钥以ody_test_开头，读取真实数据，但消息发送被记录为模拟，从不实际发送 — 非常适合构建和 CI。请参阅使用测试模式安全构建。点击创建密钥。
从绿色横幅中复制密钥 — “立即复制您的新密钥 — 您将不会再次看到它。” Ody 仅存储哈希值，因此明文只显示一次。
像密码一样存储密钥 — 存储在密钥管理器或环境变量中，切勿存储在客户端代码或共享文档中。
管理现有密钥
在创建表单下方，每个密钥都列出了其名称、一个掩码提示（ody_live_…WXYZ 或 ody_test_…WXYZ）、测试密钥的测试徽章、其作为芯片的范围（不受限制时显示“完全访问”），以及上次使用时间。点击撤销可立即禁用密钥 — 撤销的密钥会立即停止认证，并且无法恢复。
相关文章
常见问题
我丢失了我的 API 密钥 — 我能再次看到它吗？
不能。完整的密钥仅在创建时显示一次。请撤销丢失的密钥并创建一个新密钥。
实时密钥和测试密钥有什么区别？
实时密钥 (ody_live_…) 发送真实的短信。测试密钥 (ody_test_…) 行为相同，但消息发送是模拟的 — 记录在对话中，但从不实际发送。
谁可以创建 API 密钥？
工作区管理员和所有者。密钥以创建者的权限行事。
哪些套餐包含 API？
所有套餐 — API 和 MCP 从 Starter 套餐开始包含。