令牌管理

令牌是调用 API 的凭证,每个令牌可独立配置权限范围和配额上限。左侧导航点击「令牌」,或直接访问 /console/token

令牌列表展示所有已创建的令牌,包含名称、状态、已用配额、剩余配额、过期时间等信息。

创建令牌

基本配置

  1. 1在令牌列表页点击右上角「创建令牌」按钮,弹出创建弹窗
  2. 2填写令牌名称(建议按用途命名,如「生产环境」「测试用」)

高级配置选项

按需配置以下选项:

配置项 说明
过期时间 设置有效期,留空或设为 -1 表示永不过期
剩余配额 限制该令牌可消耗的最大配额,超出后自动失效
无限配额 开启后不受配额限制(仍受账户总配额约束)
模型限制 限定该令牌只能调用指定模型,留空表示不限制
IP 白名单 限定允许使用该令牌的来源 IP,留空表示不限制
分组 指定该令牌使用的渠道分组

保存令牌 Key

点击「提交」,弹窗显示完整的令牌 Key,立即复制保存,关闭弹窗后无法再次查看完整 Key。

注意:令牌 Key 仅在创建时完整显示一次,请立即复制保存。令牌 Key 具有完整的 API 调用权限,请勿泄露给他人,不要提交到代码仓库。

编辑与删除

编辑令牌

在令牌列表中找到目标令牌,点击右侧「编辑」按钮,可修改令牌的配置选项(不包括令牌 Key 本身)。

删除令牌

在令牌列表中找到目标令牌,点击右侧「删除」按钮,确认后该令牌立即失效,无法恢复。

操练场在线测试

操练场是内置的在线测试工具,无需编写代码即可直接与模型对话,适合快速验证令牌是否可用。

访问操练场

左侧导航点击「操练场」,或直接访问 /console/playground

使用操练场

  1. 1在左侧选择要测试的模型
  2. 2在底部输入框输入消息内容,点击发送
  3. 3右侧对话区域显示模型的回复结果

获取 API 地址

复制 API 地址

  1. 1访问平台首页
  2. 2在页面中部找到 API Base URL 显示区域
  3. 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 查询可用模型