获取 Token 指南

什么时候需要看这页

如果你想用天池 Token 调用平台上的模型，先从这页开始。完成后你会拿到一个 Consumer API Key，并能用 OpenAI 兼容协议发起第一次请求。

第一步：注册或登录

打开天池 Token 首页，点击「获取 Token」。如果还没有账号，按页面提示注册；已有账号则直接登录。

登录后进入 Consumer 控制台。Consumer 侧负责创建 API 密钥、查看请求活动记录、充值积分和测试模型调用。

第二步：创建 API 密钥

进入 Consumer 控制台的「API 密钥」页面，点击「创建 API 密钥」。

创建成功后，页面会显示完整密钥内容。密钥通常以 sk- 开头，请立即复制并妥善保存。离开当前页面后，完整密钥可能无法再次查看。

建议为不同项目创建不同的 API Key，方便后续查看活动记录、定位异常请求，也便于在密钥泄露时单独删除。

第三步：选择模型

你可以在首页或「模型」页面查看当前可用模型。调用接口时，需要把模型名称填入请求体中的 model 字段。

在 Consumer 控制台的「Token 使用示例」里，也可以直接复制当前可用模型名称。

第四步：发起第一次请求

天池 Token 支持 OpenAI 兼容协议。本地联调时，API Gateway 默认地址是：

http://127.0.0.1:3000/v1/chat/completions

生产环境地址是：

https://a.skypool.xyz/v1/chat/completions

用你刚创建的 API Key 替换下面的 <api_key>，并把 model 改成你要使用的模型名称：

curl -X POST "https://a.skypool.xyz/v1/chat/completions" \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "model": "qwen2.5-7b-instruct-q4",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍天池 Token。"
      }
    ],
    "max_tokens": 64,
    "stream": false
  }'

如果返回了模型生成的文本，说明 Token 已经可以正常使用。

第五步：查看活动记录

请求完成后，回到 Consumer 控制台，进入「活动记录」页面。这里可以查看请求时间、模型、Token 用量和状态。

如果请求失败，优先确认：

• API Key 是否复制完整
• 请求地址是否正确
• model 是否是平台当前可用模型
• 账户积分是否充足

常见问题

创建后没有复制 API Key 怎么办

如果完整密钥已经无法查看，建议删除旧 Key，重新创建一条新的 API Key。

API Key 泄露了怎么办

进入「API 密钥」页面删除泄露的 Key，然后创建新 Key。删除后旧 Key 会失效，使用它发起的请求会被拒绝。

应该使用哪个请求地址

生产环境 HTTP API 使用 https://a.skypool.xyz。本地联调使用 http://127.0.0.1:3000。

Relay WebSocket 另有专用地址：生产环境使用 wss://a.skypool.xyz/relay/v1/agent/connect，本地使用 ws://127.0.0.1:3000/relay/v1/agent/connect。

最小上手流程

按以下顺序操作即可完成最基础的 Token 使用：

1. 点击首页「获取 Token」并登录
2. 进入 Consumer 控制台的「API 密钥」页面
3. 创建并复制 API Key
4. 在「模型」页面选择模型名称
5. 用 OpenAI 兼容协议发起请求
6. 在「活动记录」里确认请求状态