如何获取API接口网址与API令牌密钥

##如何获取接口网址接口及令牌

#### 获取 Base URL 与 API Key（接口地址与令牌）

调用 API 前，你只需要准备两项信息：

1. **Base URL（接口地址）**
2. **API Key（访问令牌）**

---

## 一、Base URL 是什么？

Base URL 就是接口根地址，你的服务地址为：

```text
https://api.zaimod.com
```

实际调用时，在后面加接口路径，例如：

- 查询模型列表：`https://api.zaimod.com/v1/models`
- 对话请求：`https://api.zaimod.com/v1/chat/completions`
- Responses 请求：`https://api.zaimod.com/v1/responses`

---

## 二、API Key 是什么？

API Key 是你的调用凭证，类似“密码”。
示例格式：

```text
sk-DuOFzxxxxxxxxxnHCAg4plVx1ZXpD
```

> 请妥善保管，不要泄露给他人。

---

## 三、如何获取 API Key？

1. 登录平台后台
2. 进入 **令牌管理** 页面
3. 点击 **添加令牌 / 新建令牌**
4. 创建成功后复制并保存该令牌Key

![](/uploads/editor/20261101/img_6ae663c3e038d0.33431169.png)

---

## 四、如何在请求中使用？

在请求头中带上：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

示例（查询模型）：

```bash
curl -X GET "https://api.zaimod.com/v1/models" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

---

## 五、小白用户快速理解

- **Base URL** = 门牌号（去哪儿请求）
- **API Key** = 门禁卡（你是否有权限）
- 两者缺一不可：
  - 地址错了：找不到服务
  - Key 错了：会返回 `401 Unauthorized`

---

## 六、给开发者的最佳实践

- 将 `API_KEY` 放入环境变量，不要写死在代码中：
  ```bash
  export API_BASE="https://api.zaimod.com"
  export API_KEY="sk-xxxx"
  ```
- 服务端调用，避免在前端暴露密钥
- 开启密钥分环境管理（dev/staging/prod）
- 定期轮换 Key，疑似泄露立即删除并重建
- 配合日志审计调用来源与用量

---

## 七、安全提醒（必须阅读）

- 不要把 API Key 提交到 GitHub / 代码仓库
- 不要发在聊天群、工单截图、前端网页源码中
- 如发现泄露，请立刻：
  1) 在令牌管理中删除旧 Key
  2) 新建 Key
  3) 更新你的服务配置

---

上一篇：zaimod 快速接入{else}上一篇：没有了下一篇：WorkBuddy 桌面版接入{else}下一篇：没有了