令牌管理
令牌是调用 API 的凭证,每个令牌可独立配置权限范围和配额上限。左侧导航点击「令牌」,或直接访问 /console/token。
令牌列表展示所有已创建的令牌,包含名称、状态、已用配额、剩余配额、过期时间等信息。
创建令牌
基本配置
- 1在令牌列表页点击右上角「创建令牌」按钮,弹出创建弹窗
- 2填写令牌名称(建议按用途命名,如「生产环境」「测试用」)
高级配置选项
按需配置以下选项:
| 配置项 | 说明 |
|---|---|
| 过期时间 | 设置有效期,留空或设为 -1 表示永不过期 |
| 剩余配额 | 限制该令牌可消耗的最大配额,超出后自动失效 |
| 无限配额 | 开启后不受配额限制(仍受账户总配额约束) |
| 模型限制 | 限定该令牌只能调用指定模型,留空表示不限制 |
| IP 白名单 | 限定允许使用该令牌的来源 IP,留空表示不限制 |
| 分组 | 指定该令牌使用的渠道分组 |
保存令牌 Key
点击「提交」,弹窗显示完整的令牌 Key,立即复制保存,关闭弹窗后无法再次查看完整 Key。
注意:令牌 Key 仅在创建时完整显示一次,请立即复制保存。令牌 Key 具有完整的 API 调用权限,请勿泄露给他人,不要提交到代码仓库。
编辑与删除
编辑令牌
在令牌列表中找到目标令牌,点击右侧「编辑」按钮,可修改令牌的配置选项(不包括令牌 Key 本身)。
删除令牌
在令牌列表中找到目标令牌,点击右侧「删除」按钮,确认后该令牌立即失效,无法恢复。
操练场在线测试
操练场是内置的在线测试工具,无需编写代码即可直接与模型对话,适合快速验证令牌是否可用。
访问操练场
左侧导航点击「操练场」,或直接访问 /console/playground。
使用操练场
- 1在左侧选择要测试的模型
- 2在底部输入框输入消息内容,点击发送
- 3右侧对话区域显示模型的回复结果
获取 API 地址
复制 API 地址
- 1访问平台首页
- 2在页面中部找到 API Base URL 显示区域
- 3点击复制按钮,将地址复制到剪贴板
配置客户端
将复制的地址填入你的客户端或代码中作为 base_url,配合令牌即可开始调用。
代码示例
Python(OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxx",
base_url="https://your-platform.com/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)
Claude 原生格式
curl https://your-platform.com/v1/messages \
-H "x-api-key: sk-xxxxxxxx" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-3-5-sonnet-20241022",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello"}]
}'
Gemini 原生格式
curl "https://your-platform.com/v1beta/models/gemini-1.5-pro:generateContent?key=sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"contents": [{"parts": [{"text": "Hello"}]}]
}'
支持的接口端点
| 接口 | 路径 | 说明 |
|---|---|---|
| 聊天补全 | POST /v1/chat/completions |
对话生成,支持流式输出 |
| 文本补全 | POST /v1/completions |
传统补全接口 |
| 向量嵌入 | POST /v1/embeddings |
文本向量化 |
| 图像生成 | POST /v1/images/generations |
文生图 |
| 图像编辑 | POST /v1/images/edits |
图像编辑 |
| 语音转文字 | POST /v1/audio/transcriptions |
Whisper 等 |
| 文字转语音 | POST /v1/audio/speech |
TTS |
| 重排序 | POST /v1/rerank |
文档重排序 |
| Responses API | POST /v1/responses |
OpenAI Responses 格式 |
| 实时对话 | GET /v1/realtime(WebSocket) |
OpenAI Realtime API |
| 模型列表 | GET /v1/models |
查询可用模型 |