9. 创建 API Key 与发起调用
The English version of this chapter is pending; the original Chinese text is shown below.
适合角色:管理员(签发他人 Key)/ 普通成员(创建自己的 Key)
9.1 管理员:Key 管理
Key 管理(/keys/platform)顶部是 KPI(活跃 Key / 闲置 Key / 需关注),下方三个 Tab:成员 Key / 项目 Key / 项目成员 Key。

- 「签发 Key」:仅「项目 Key」Tab 可签发;成员 Key 需由成员在「我的 Key」自行创建(按钮禁用提示「成员 Key 请让对应成员在「我的 Key」中创建」)。
- 表格列:成员/项目、Key 名称、所属部门、Key 前缀、状态、额度(进度条)、模型白名单、最后使用、到期时间、操作。
- 操作:「强制轮转」(toast「Key 已轮转,旧 Key 24h 后失效」)、「删除」;勾选后可「批量禁用/批量启用」。

9.2 成员:我的 Key
我的 Key(/me/keys)展示总额度/已使用/已分配/预留池,以及本月的 Key 卡片列表(含额度进度条、到期时间)。

点「新建 Key」打开创建表单:
| 字段 | 说明 |
|---|---|
| 绑定成员 | 固定为本人 |
| Key 名称(可选) | 留空自动生成,可稍后修改 |
| 额度 (¥) | 不能超过剩余额度 |
| 模型白名单 | 「至少选择一个模型」,支持搜索/全选 |
创建成功后显示「Key 已创建,请立即复制保存」,关闭后无法再次查看完整 Key。

9.3 成员:申请额度
额度用尽时点「申请额度」,在「发起申请」中选申请类型(额度追加)、填申请理由与申请额度,提交后进入审批中心(见 11.4)。

9.4 发起第一次调用
Key 卡片上的「使用方法」可展开代码片段(curl / Python / Node.js 三个 Tab),复制即用。调用地址为网关 {站点}/v1,与 OpenAI SDK 兼容:
curl {网关地址}/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tj-..." \
-d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"Hello!"}]}'
from openai import OpenAI
client = OpenAI(api_key="tj-...", base_url="{网关地址}/v1")
resp = client.chat.completions.create(model="deepseek-v4-pro",
messages=[{"role": "user", "content": "Hello!"}])
print(resp)
除 chat 外还支持 image / audio / video(异步两步)/ embedding / rerank 等类型的示例,随所选模型的类型自动变化。
This chapter has 5 interface screenshots; click an image to view the original.
