> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/api/model-api-key.md).

# 用模型 API 密钥调用 Duaer 模型网关

在 Duaer 里，模型 API 密钥让你在自己的代码里调用 Duaer 模型网关 https://api.duaer.com/v1/*，只能用管理员开放给用户调用的模型。
## 创建模型 API 密钥

1. 在 Duaer 里打开「设置 → 模型 API 密钥」。
2. 点「新建模型 API 密钥」。
3. 填一个名称，例如「CI 流水线」，点保存。
4. 立即复制密钥。完整值只显示这一次。

## 用密钥调用 Duaer 模型网关

把密钥放在请求头 `Authorization: Bearer <密钥>` 里（也接受 `X-API-Key` 或 `X-DUAER-API-KEY`）。例如列出这个密钥能用的模型：

```
curl https://api.duaer.com/v1/models \
  -H "Authorization: Bearer $DUAER_API_KEY"
```

网关提供 `/v1/chat/completions`、`/v1/responses`、`/v1/messages`、`/v1/images/generations`、`/v1/embeddings`、`/v1/audio/speech` 等接口，每次调用按模型价格扣你的积分。

同一把密钥也能调用你在 [Duaer 员工市场](/zh/build/employee-market.md) 雇佣的员工：`POST /v1/employees/<岗位 ID>/runs`。

## 查看可调用的模型和用量

页面下方的「可调用的模型」列出管理员为用户开放的模型。列表为空时，请管理员在模型池里为至少一个模型开启用户调用。

密钥列表显示每把密钥的最近使用、调用次数和已用积分，「调用记录」列出最近的调用。

## 轮换或撤销 Duaer 模型 API 密钥

- 轮换：撤销这把密钥并生成一把同名的新密钥。旧密钥立即失效，新密钥同样只显示一次。
- 撤销：用这把密钥的脚本和集成立即停止工作，不能恢复。

## 模型 API 密钥和账号级 API 密钥的区别

「设置 → API」里的账号级 API 密钥可以调用所有已启用的模型，也能调用 [Duaer 公开 API](/zh/api/authentication.md)。Duaer 模型 API 密钥只能调模型网关里开放给用户的模型，适合交给脚本或第三方。
## Questions

### Duaer 模型 API 密钥和「设置 → API」里的密钥有什么区别？

Duaer 模型 API 密钥只能调用模型网关里管理员开放给用户的模型；账号级 API 密钥能调用所有已启用的模型，也能调用 Duaer 公开 API。

### 为什么 Duaer 模型 API 密钥调不到某个模型？

管理员还没在 Duaer 模型池里为这个模型开启用户调用。「设置 → 模型 API 密钥」下方的「可调用的模型」就是这把密钥能用的全部模型。