SDK / API 调用总览
SDK 调用适合后端服务、脚本、自动化任务和自己写的应用。Enodot 对外兼容三类主流协议：
| 协议 | Base URL | 主要端点 |
|---|---|---|
| OpenAI | https://ai.enodot.shop/v1 | /responses、/chat/completions、/models |
| Anthropic | https://ai.enodot.shop | /v1/messages、/v1/messages/count_tokens |
| Gemini | https://ai.enodot.shop/v1beta | /models/{model}:generateContent |
最小接入步骤
- 在控制台复制 Enodot API Key。
- 选择协议：OpenAI、Anthropic 或 Gemini。
- 把官方 SDK 的 Key 换成 Enodot Key。
- 把官方 Base URL 换成 Enodot Base URL。
- 运行 curl 自测。
- 再把相同配置迁移到项目代码里。
什么时候选哪个协议
| 你的代码原本使用 | 推荐文档 |
|---|---|
| OpenAI SDK / Responses API | OpenAI SDK |
| Anthropic SDK / Claude Messages | Anthropic SDK |
| Gemini SDK / Google GenAI | Gemini SDK |
| 只想先测接口是否通 | curl 自测 |
安全建议
- 不要把 API Key 写死在前端代码里。
- 服务端使用环境变量或密钥管理系统保存 Key。
- 为不同项目创建不同 Key，方便限额、停用和审计。
- 生产环境建议为不同项目使用不同 Key，方便停用和查看用量。