​

首次接入 GTNet

首次接入前，建议先确认服务信息，再配置客户端或业务系统，并通过一次低风险测试验证链路。登录入口、鉴权细节和客户端配置方式可能随平台安排变化，具体信息应以 GTNet 官方公告、控制台或管理员通知为准。

​

1. 确认你已获得服务信息

开始前，请先确认你已经获得以下信息：

• GTNet Web 访问地址
• GTNet API Token 接口地址
• API Key 或等效鉴权信息
• 当前可用模型
• 当前套餐、额度、限额和倍率
• 客户端、SDK 或业务系统的配置入口

当前已确认的 Web 访问地址、API Token 接口地址和平台模型见 模型与接口地址。

​

2. 了解你的套餐与额度

使用前建议先了解当前套餐周期、日限额、周限额、月限额、倍率和平台入金额度换算规则。 如果你还不了解当前套餐、限额、倍率或平台入金换算规则，请先阅读 套餐与额度。 重点关注：

• 套餐周期是 1 天、7 天还是 30 天。
• 当前套餐是否有日限额、周限额或月限额。
• 倍率（￥/$）如何影响额度理解。
• 平台入金按 ￥1 = ￥2 额度 换算。

​

3. 查看模型与接口地址

当前已确认的信息包括：

• GTNet Web 访问地址：https://www.gtnet.xyz/
• GTNet API Token 接口地址：https://token.gtnet.xyz/v1

当前已确认的平台模型包括：

• GPT-5.3 Codex Spark
• GPT-5.4
• GPT-5.5
• GPT-5.4 Mini
• Codex Auto Review

更多说明见 模型与接口地址。登录入口、额外接口、额外模型范围和具体鉴权方式，应以 GTNet 官方公告、控制台或管理员通知为准。

​

4. 配置客户端或业务系统

根据你使用的客户端、SDK 或业务系统，将已确认的信息填入对应配置项。不同客户端字段名称可能不同，常见配置项包括：

• API Base URL 或接口地址
• API Key、Token 或鉴权信息
• 模型名称
• 请求参数

配置时建议：

• 保持接口地址格式完整。
• 模型名称按文档或控制台显示填写，避免手动改写。
• 不要在公开仓库、公开截图、聊天记录或客户端日志中泄露 API Key。
• 保存配置后，先做低风险测试，不要直接用于生产任务。

​

5. 发起低风险测试请求

首次配置完成后，建议先发送简短测试请求：

• 请求内容尽量简短。
• 不要包含敏感数据、隐私数据或真实业务机密。
• 观察返回结果是否符合预期。
• 记录模型名称、请求时间和错误信息，便于后续排查。

​

6. 检查返回结果与额度变化

测试完成后，建议确认：

• 请求是否成功返回。
• 使用的模型是否为预期模型。
• 额度或用量记录是否正常变化。
• 客户端是否出现重试、超时或鉴权失败。
• 是否触发日限额、周限额或月限额。

如果 GTNet 提供控制台、公告或其他查询方式，应以这些渠道为准确认用量和状态。

​

7. 请求失败时先检查什么

如果请求失败，请先检查：

• API Token 接口地址是否填写完整。
• API Key 或 Token 是否正确、有效且没有多余空格。
• 当前账号是否仍有可用额度。
• 当前模型是否在你的可用范围内。
• 客户端是否支持当前接口格式。
• 是否达到套餐限额或平台限制。
• 是否存在平台公告中的维护或异常通知。

更多问题可查看 常见问题。

​

API Key 安全提醒

不要把 API Key 写入公开仓库、公开截图、聊天记录或客户端日志。若怀疑 API Key 泄露，应立即停止使用该 Key，并通过 GTNet 官方渠道或管理员获取处理方式。