一、步骤一:订阅套餐
前往对应的购买页,选择适合你的订阅套餐,套餐介绍请参见 Token Plan 个人版套餐概览:
·通用 Token Plan 购买页
·Hy Token Plan 购买页
二、步骤二:获取核心配置
你可以获取模型配置、Base URL、API Key,用于工具中。
三、获取模型配置
在工具配置文件中指定模型,可实时切换模型。支持配置的模型列表如下:
注意:说明:
·通用 Token Plan 可用模型
·Hy Token Plan 可用模型
四、获取 Base URL 和完整 URL
不同的工具配置的 URL 根据兼容的协议会有不同:
1. Base URL
·兼容 OpenAI 接口协议工具:https://tokenhub.tencentmaas.com/plan/v3
·兼容 Anthropic 接口协议工具:https://tokenhub.tencentmaas.com/plan/anthropic
2. 完整 URL
·兼容 OpenAI 接口协议工具:https://tokenhub.tencentmaas.com/plan/v3/chat/completions
·兼容 Anthropic 接口协议工具:https://tokenhub.tencentmaas.com/plan/anthropic/v1/messages
五、获取 API Key
1. 生成 API Key:在大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,单击生成密钥,生成你的专属 API Key。(如果你已生成密钥,请跳过步骤。)
注意:通用 Token Plan 与 Hy Token Plan 共用同一个 API Key,你购买后,可在任意一个套餐页面生成密钥,仅需生成一次即可通用。
2. 获取 API Key:密钥生成成功后,即可单击复制,获取套餐专属 API Key(格式为 sk-tp-xxx)。
六、步骤三:快速验证模型调用
获取 API Key 后你可在命令行终端通过 cURL 简单验证连通性,请将下方$your_api_key 替换为你的实际 API Key,$model_id 可以对照 模型配置 换成你要测试的模型 Model ID:
curl –location 'https://tokenhub.tencentmaas.com/plan/v3/chat/completions' \\–header 'Authorization: Bearer $your_api_key' \\–header 'Content-Type: application/json' \\–data '{ "model": "$model_id", "messages": [ { "role": "user", "content": "hello" } ], "stream": false}'
七、步骤四:配置 AI 工具
Token Plan 兼容热门的 龙虾工具和 AI 编码工具,你可以根据自己的偏好选择,将 URL、API Key 和具体的模型(Model Name)配置到工具中,就能使用大模型服务。
八、步骤五(可选):管理套餐用量
你可以在控制台查看你套餐的 Tokens 消耗情况,也可以根据需要对套餐进行升级。
九、1. 查看套餐用量消耗
可以前往大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,查看当前周期套餐额度消耗情况。
注意:说明:
注意:额度刷新规则:套餐额度在订阅月的周期内耗尽后,不会消耗其他资源包或账户余额,需要等待下一个订阅月自动恢复额度。你也可以选择升级到更高等级套餐享有更充裕的 Token 配额。
1.1 在剩余额度版块查看套餐额度整体消耗情况。
1.2 在页面下方的用量详情版块查看每日 Token 总用量、分钟级输入 / 输出 Token 用量、请求维度 Token 用量。
十、2. 套餐升配
注意:说明:
2.1 在大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,单击升配,进行套餐升配。
2.2 选择要升配的目标套餐名称,升级到更高等级套餐以获得更多 Token 量。
十一、步骤六(可选):API Key 管理
注意:通用 Token Plan 和 Hy Token Plan 两个套餐共用同一个 API Key。在通用 Token Plan 和 Hy Token Plan 页面上对 API Key 的生成、重置、删除都会影响另一个套餐。
十二、1. 复制 API Key
在大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,点击复制即可获得 API Key。
十三、2. 重置 API Key
在大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,单击重置即可重新生成 API Key。
注意:Token Plan 个人版套餐(通用 / Hy Token Plan)共用同一个 API Key,重置后将导致旧 API Key 将于 5 分钟内永久失效,所有套餐的实时 API 调用会立即中断,直至你将新 API Key 配置到所有调用端,请谨慎操作。
十四、3. 删除 API Key
在大模型服务平台 TokenHub > Token Plan > 通用 Token Plan / Hy Token Plan 标签页,单击删除,删除 API Key。
注意:Token Plan 个人版套餐(通用 / Hy Token Plan)共用同一个 API Key,删除后将导致旧 API Key 将立即永久失效并且无法恢复,所有套餐的实时 API 调用会立即中断,请谨慎操作。
十五、步骤七(可选):套餐续费
注意:警告:
注意:请你在 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。1. 确认 API Key 根据 API Key 获取指引 正确获取。1. 参考 龙虾工具、编程工具指引,确认 URL 和 API Key 配置正确。 |
| 429 | tpm rate limit exceeded | 系统负载高触发限流 | 请重试 1-2 次或者切换其他模型。 |
| 20033 | invalid model | 模型名称配置错误 | 根据你订阅的套餐,检查模型配置是否正确:通用 Token Plan 可用模型列表Hy Token Plan 可用模型列表 |
| 20059 | Input length too long | 输入长度超出了允许范围 | 可通过新建会话解决报错。 |
| 20097 | month allocated quota exceeded | 每个订阅月请求额度已用完 | 等待至下个订阅月的同一时刻(订阅时刻)额度重置,或升级至更高级套餐。 |
十九、常见问题
详情请参见 Token Plan 常见问题。