5 分钟快速开始

适用范围：HangToken 当前线上服务　最后核验：2026-08-26

**完成标准：**能查询模型列表、收到一条模型回复，并能在控制台调用日志中找到这次请求。

准备工作

• 注册并登录 HangToken 控制台。
• 确认账户有可用余额或测试额度。
• 准备 cURL，或使用系统自带终端。

1. 创建 API Key

1. 进入控制台的令牌管理页面，点击新建令牌。
2. 名称建议使用“设备-应用-环境”，例如 macbook-codex-dev。
3. 首次测试可设置较小额度和有效期；模型范围只勾选实际需要的模型。
4. 创建后立即复制。页面若不再显示完整密钥，请重新创建，不要尝试猜测。

2. 查询可用模型

curl https://hangtoken.com/v1/models \
  -H "Authorization: Bearer sk-[你的密钥]"

从返回结果的 data[].id 复制模型名称。客户端中的模型名必须完全一致，包括大小写、连字符和版本后缀。

3. 完成第一次请求

curl https://hangtoken.com/v1/chat/completions \
  -H "Authorization: Bearer sk-[你的密钥]" \
  -H "Content-Type: application/json" \
  -d '{"model":"[模型ID]","messages":[{"role":"user","content":"只回复：连接成功"}],"stream":false}'

成功响应应包含

{
  "choices": [{
    "message": {"role": "assistant", "content": "连接成功"}
  }],
  "usage": {"prompt_tokens": 12, "completion_tokens": 4, "total_tokens": 16}
}

不同模型可能返回额外字段；只要 HTTP 状态为 200 且存在回复内容，即可认为基础连接成功。随后在控制台调用日志核对模型、Token 用量、费用和请求时间。

请求成功后，记录会出现在“使用日志”表格中。可按时间、模型、分组和类型筛选，再从“详情”列查看单次请求信息。

失败时先看这里

状态码	常见原因	下一步
401	密钥错误、已禁用或认证头格式错误	重新复制 Key，确认 Bearer 后有一个空格
402	账户余额或令牌额度不足	充值或提高令牌额度后重试
403	模型或分组没有权限	换用 /v1/models 返回的模型
404	Base URL 缺少或重复 /v1	核对最终路径是否为 /v1/chat/completions
429	并发或频率过高	降低并发并进行指数退避
5xx	上游或临时服务异常	稍后重试，并记录时间、模型和请求 ID

:::warning 密钥安全 不要把真实 API Key 放进截图、群聊、浏览器前端或 Git 仓库。疑似泄露时立即撤销并重建。 :::