大模型服务平台 TokenHub Token Plan 快速入门

本文介绍如何在龙虾或者编程工具中快速使用 Token Plan 套餐所支持的模型进行办公或者代码开发。
步骤一：订阅 Token Plan 套餐
前往 Token Plan 购买页，选择适合您的订阅套餐。套餐介绍请参见 Token Plan 套餐概览。
﻿
﻿
﻿
步骤二：获取核心配置
您可以获取 Model Name、Base URL、API Key，用于工具中。
获取 Model Name
在工具配置文件中指定 Model Name，可实时切换模型。支持配置的 Model Name：
tc-code-latest
hunyuan-2.0-instruct
hunyuan-2.0-thinking
minimax-m2.5（兼容别名 minimax-m-2-5）
kimi-k2.5（兼容别名 kimi-k-2-5）
glm-5（兼容别名 glm-5-0）
hunyuan-t1（即将下线）
hunyuan-turbo（即将下线）
说明：
配置 Model Name 时，支持使用全小写格式。
设置 Model Name 为 tc-code-latest 值，平台会通过算法自动匹配最优模型。
kimi-k2.5 当前资源负载较高，高峰时段可能触发请求限频机制，为保障使用体验，请优先选用其他模型。
Token Plan 可用模型暂不支持多模态能力。
获取 Base URL 和完整 URL
不同的工具配置的 URL 根据兼容的协议会有不同：
1. Base URL
兼容 OpenAI 接口协议工具：https://api.lkeap.cloud.tencent.com/plan/v3。
兼容 Anthropic 接口协议工具：https://api.lkeap.cloud.tencent.com/plan/anthropic。
2. 完整 URL
兼容 OpenAI 接口协议工具：https://api.lkeap.cloud.tencent.com/plan/v3/chat/completions。
兼容 Anthropic 接口协议工具：https://api.lkeap.cloud.tencent.com/plan/anthropic/v1/messages。
获取 API Key
1. 生成 API Key：在 TokenHub > Token Plan 页面，单击生成密钥，生成您的专属 API Key。
﻿
﻿
﻿
2. 获取 API Key：密钥生成成功后，即可单击复制，获取套餐专属 API Key（格式为 sk-tp-xxx）。
﻿
﻿
﻿
步骤三：快速验证模型调用
获取 API Key 后您可在命令行终端通过 cURL 简单验证连通性，请将下方$your_api_key 替换为您的实际 API Key，$model_name 可以对照 Model Name 换成您要测试的模型：
curl --location 'https://api.lkeap.cloud.tencent.com/plan/v3/chat/completions' \\
--header 'Authorization: Bearer $your_api_key' \\
--header 'Content-Type: application/json' \\
--data '{
  "model": "$model_name",
  "messages": [
    {
      "role": "user",
      "content": "介绍下你自己"
    }
  ],
  "stream": true
}'
步骤四：配置 AI 工具
Token Plan 兼容热门的 龙虾工具和 AI 编码工具，您可以根据自己的偏好选择，将 URL、API Key 和具体的模型（Model Name）配置到工具中，就能使用大模型服务。
步骤五（可选）：管理套餐用量
您可以在控制台查看您套餐的 Tokens 消耗情况，也可以根据需要对套餐进行升级。
1. 查看套餐用量消耗
可以前往 TokenHub > Token Plan 页面查看本周期套餐额度消耗情况。
说明：
额度刷新规则：套餐额度在订阅月的周期内耗尽后，不会消耗其他资源包或账户余额，需要等待下一个订阅月自动恢复额度。您也可以选择升级到更高等级套餐享有更充裕的 Token 配额。
1.1 在剩余额度板块查看套餐额度整体消耗情况。
﻿
1.2 在页面下方的用量详情板块查看每日 Token 总用量、分钟级输入 / 输出 Token 用量、请求维度 Token 用量。
2. 升级套餐用量
说明：
Token Plan 套餐仅支持套餐升级，不支持套餐降级操作。
升级套餐的费用 = 新套餐费用 − 原套餐费用（补差价）。
升级后套餐 Token 剩余量 = 新套餐总 Token 量 - 原套餐 Token 使用量。
套餐升级成功后：
套餐的 API Key 保持一样。
套餐到期时间跟原套餐保持一样，例如：Lite 套餐是 2026-04-23 到期，升级到 Standard 套餐也是 2026-04-23 到期。
2.1 在 TokenHub > Token Plan 页面，单击升配，进行套餐升级。
﻿
﻿
﻿
2.2 选择要升配的目标套餐名称，升级到更高等级套餐以获得更多 Token 量。
﻿
步骤六（可选）：套餐续费
警告：
请您在 Token Plan 套餐到期前完成续费操作，套餐到期后将无法进行续费，套餐将失效，API Key 也会失效。
续费规则
套餐续费是指续订下一订阅月的套餐，续费完成后，新的额度将在下个订阅月生效：
若本订阅月额度未用尽：剩余额度可继续使用至本订阅月结束，下个订阅月自动重置为新的额度。
若本订阅月额度已用尽：续费操作不会重置本订阅月的额度，新的额度需等待下个订阅月生效。
示例如下：用户购买 Standard 套餐，本订阅月（2026-03-23～2026-04-23）Token 总额度 1 亿。用户为下个订阅月（2026-04-23～2026-05-23）续费，不同场景可用额度说明如下：
场景
本月额度消耗情况
可用额度说明
本订阅月额度未用尽
假如本订阅月（2026-03-23～2026-04-23）已用 0.5 亿。
本订阅月（2026-03-23～2026-04-23）剩余可用额度 0.5 亿。
下个订阅月（2026-04-23～2026-05-23）可用额度 1 亿。
若本订阅月额度已用尽
假如本订阅月（2026-03-23～2026-04-23）已用 1 亿。
本订阅月（2026-03-23～2026-04-23）剩余可用额度 0。
下个订阅月（2026-04-23～2026-05-23）可用额度 1 亿。
续费方式
Token Plan 支持手动续费和自动续费两种方式。具体说明如下：
手动续费：套餐自购买到到期前，您可以在任意时间为套餐手动续费，以延长套餐的使用时间。
在 TokenHub > Token Plan 页面，单击立即续费。
﻿
确认续费周期，单击续费，即可完成操作。
﻿
自动续费：在 TokenHub > Token Plan 页面，单击开启，开启自动续费。套餐开启自动续费后，在账户余额充足的情况下，套餐到期前一天会自动执行续费。自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致 API Key 失效。
﻿
常见错误码
错误码
错误信息
可能原因
解决方法
401
unauthorized
URL 或者 API Key 配置错误
1. 确认 URL 是 Token Plan 的 URL。
2. 确认 API Key 根据 API Key 获取指引 正确获取。
3. 参考 龙虾工具、编程工具指引，确认 URL 和 API Key 配置正确。
429
tpm rate limit exceeded
系统负载高触发限流
请重试 1-2 次或者切换其他模型。
20033
invalid model
模型名称配置错误
检查配置的模型名称（Model Name）是否是 Token Plan 支持的 Model Name。
20059
Input length too long
输入长度超出了允许范围
可通过新建会话解决报错。
20097
month allocated quota  exceeded
每个订阅月请求额度已用完
等待至下个订阅月的同一时刻（订阅时刻）额度重置，或升级至更高级套餐。
常见问题
详情请参见 Token Plan 常见问题。
﻿

场景	本月额度消耗情况	可用额度说明
本订阅月额度未用尽	假如本订阅月（2026-03-23～2026-04-23）已用 0.5 亿。	本订阅月（2026-03-23～2026-04-23）剩余可用额度 0.5 亿。下个订阅月（2026-04-23～2026-05-23）可用额度 1 亿。
若本订阅月额度已用尽	假如本订阅月（2026-03-23～2026-04-23）已用 1 亿。	本订阅月（2026-03-23～2026-04-23）剩余可用额度 0。下个订阅月（2026-04-23～2026-05-23）可用额度 1 亿。

错误码	错误信息	可能原因	解决方法
401	unauthorized	URL 或者 API Key 配置错误	1. 确认 URL 是 Token Plan 的 URL。 2. 确认 API Key 根据 API Key 获取指引正确获取。 3. 参考龙虾工具、编程工具指引，确认 URL 和 API Key 配置正确。
429	tpm rate limit exceeded	系统负载高触发限流	请重试 1-2 次或者切换其他模型。
20033	invalid model	模型名称配置错误	检查配置的模型名称（Model Name）是否是 Token Plan 支持的 Model Name。
20059	Input length too long	输入长度超出了允许范围	可通过新建会话解决报错。
20097	month allocated quota exceeded	每个订阅月请求额度已用完	等待至下个订阅月的同一时刻（订阅时刻）额度重置，或升级至更高级套餐。

Token Plan 快速入门

本页目录：

步骤一：订阅 Token Plan 套餐

步骤二：获取核心配置

获取 Model Name

获取 Base URL 和完整 URL

获取 API Key

步骤三：快速验证模型调用

步骤四：配置 AI 工具

步骤五（可选）：管理套餐用量

1. 查看套餐用量消耗

2. 升级套餐用量

步骤六（可选）：套餐续费

续费规则

续费方式

常见错误码

常见问题