快速上手

入口、用途和适用场景

• 入口位置：文档侧边栏进入【认识控制台】后，打开【快速上手】；实际操作从登录 Routescope 后的个人中心开始。
• 页面用途：把首次接入拆成可执行步骤，帮助您从账户检查走到第一次 API 调用和扣费核对。
• 适合什么时候使用：第一次接入 Routescope API、换新模型前做验证、或为新项目创建独立 API Key 时使用。

查看仪表板

1. 登录 Routescope，进入个人中心。
2. 打开左侧导航中的 【仪表板】。
3. 先确认【当前余额】是否足够完成测试。
4. 查看页面上的模型消耗数据、日期统计和常用接入地址。
5. 如需复制基础接入地址，直接使用页面提供的复制入口。

如果余额不足，先进入 【余额充值】 完成充值，再继续后续步骤。

充值

1. 在左侧导航打开 【余额充值】。
2. 查看当前余额，确认是否需要补充额度。
3. 输入充值金额；充值额度以美元计。
4. 查看页面展示的本次到账额度。
5. 如页面提供套餐、优惠码或支付方式选择，按实际需要选择；支付方式以页面实际展示为准。
6. 完成支付后回到页面确认余额是否到账。

挑选模型

1. 打开 【模型广场】。
2. 在搜索框输入模型名称或关键词。
3. 按供应商、令牌分组、计费类型、标签或端点类型筛选。
4. 查看模型价格，确认输入、输出或任务计费口径。
5. 在卡片视图或表格视图中找到目标模型后，复制模型 ID。

模型 ID 是后续文本对话测试和 API 调用中需要填写的标准模型标识。

测试模型

1. 打开 【体验中心】。
2. 进入 【文本对话】。
3. 选择刚才确认的模型。
4. 如需要测试视觉输入，按页面字段填写图片地址。
5. 配置最大 Token、随机种子等页面可见参数。
6. 输入一条测试消息并发送。
7. 查看回复内容和调试信息，确认模型效果、响应速度和错误提示是否符合预期。

创建 API Key

1. 打开 【令牌管理】。
2. 点击【添加令牌】。
3. 填写令牌名称，建议按项目和环境命名，例如 web-prod 或 agent-test。
4. 按需要配置可用模型、额度、IP 限制和过期时间。
5. 保存后查看并复制完整密钥。

完整密钥只应放在服务端、环境变量或受保护的客户端配置中，不要公开展示。

模型配置：客户端配置或发起 API 调用

准备三项信息：仪表板 中的接入地址、令牌管理 中复制的 API Key、模型广场 中复制的模型 ID。

客户端配置

打开客户端配置教程，把接入地址、API Key 和模型 ID 配置到您的常用客户端并开始使用。

• CC Switch
• Claude Code
• Codex
• Cursor
• OpenCode
• VS Code

发起 API 调用

1. 打开现有 API 接口参考，选择要调用的能力页面。
2. 按接口参考中的示例，把接入地址、API Key 和模型 ID 填入您的代码、脚本或客户端配置。
3. 发送一次最小测试请求，先确认鉴权、模型权限和余额状态正常。
4. 如果需要详细字段说明，继续查看对应 API 接口参考；认识控制台只说明接入流程。

查看调用结果和扣费

1. 打开 【操作记录】。
2. 在 【使用日志】 中按日期、令牌名称、模型名称、分组或请求 ID 查询刚才的请求。
3. 查看输入、输出、花费、RPM、TPM 和请求详情。
4. 如果是图片、音频、视频等异步任务，切换到 【任务日志】 查看任务状态、结果或失败原因。
5. 如需核对财务记录，再进入 【账单及发票】 查看账单记录、订单状态和消费记录。

常见问题

API Key 创建后为什么仍然不能调用

先检查账户余额是否充足，再检查令牌是否启用、是否过期、是否限制了当前模型或来源 IP。

应该先写代码还是先测试模型

建议先在 【体验中心】 的 【文本对话】 中验证模型效果，再把同一个模型 ID 和接入配置放到代码里。