本文介绍如何在龙虾或者编程工具中快速使用 Token Plan 套餐所支持的模型进行办公或者代码开发。
步骤一：订阅套餐
步骤二：获取核心配置
您可以获取模型配置、Base URL、API Key，用于工具中。
获取模型配置
在工具配置文件中指定模型，可实时切换模型。支持配置的模型列表如下：
说明：
配置 Model ID 时，必须使用全小写格式。
Token Plan 可用模型暂不支持图片、视频等多模态能力。
通用 Token Plan 与 Hy 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/anthropic2. 完整 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 > 通用 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://api.lkeap.cloud.tencent.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 工具
步骤五（可选）：管理套餐用量
您可以在控制台查看您套餐的 Tokens 消耗情况，也可以根据需要对套餐进行升级。
1. 查看套餐用量消耗
说明：
额度刷新规则：套餐额度在订阅月的周期内耗尽后，不会消耗其他资源包或账户余额，需要等待下一个订阅月自动恢复额度。您也可以选择升级到更高等级套餐享有更充裕的 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.2 选择要升配的目标套餐名称，升级到更高等级套餐以获得更多 Token 量。
步骤六（可选）：API Key 管理
注意：
通用 Token Plan 和 Hy Token Plan 两个套餐共用同一个 API Key。在通用 Token Plan 和 Hy Token Plan 页面上对 API Key 的生成、重置、删除都会影响另一个套餐。
1. 复制 API Key
2. 重置 API Key
注意：
Token Plan 个人版套餐（通用 / Hy Token Plan）共用同一个 API Key，重置后将导致旧 API Key 将于 5 分钟内永久失效，所有套餐的实时 API 调用会立即中断，直至您将新 API Key 配置到所有调用端，请谨慎操作。
3. 删除 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 页面，单击开启，开启自动续费。套餐开启自动续费后，在账户余额充足的情况下，套餐到期前一天会自动执行续费。自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致 API Key 失效。
常见错误码
错误码 | 错误信息 | 可能原因 | 解决方法 |
401 | unauthorized | URL 或者 API Key 配置错误 | 1. 确认 URL 是 Token Plan 的 URL。 2. 确认 API Key 根据 API Key 获取指引 正确获取。 |
429 | tpm rate limit exceeded | 系统负载高触发限流 | 请重试 1-2 次或者切换其他模型。 |
20033 | invalid model | 模型名称配置错误 | 根据您订阅的套餐，检查模型配置是否正确： |
20059 | Input length too long | 输入长度超出了允许范围 | 可通过新建会话解决报错。 |
20097 | month allocated quota exceeded | 每个订阅月请求额度已用完 | 等待至下个订阅月的同一时刻（订阅时刻）额度重置，或升级至更高级套餐。 |
常见问题
