新手指引

欢迎使用应天AI。本文档面向第一次接入平台的客户，帮助你按正确顺序完成账号登录、Token 创建、客户端配置和首次调用验证。

如果你只想尽快跑通，请先阅读 客户新手使用指南。

你可以用应天AI做什么

应天AI 提供 OpenAI 兼容接口。你可以使用统一的服务地址和 API Token，在客户端、开发工具或自己的业务系统中调用平台开放的模型能力。

常见使用场景包括：

• 在 Cursor、Cherry Studio、ChatBox 等客户端中配置 AI 模型
• 使用 Postman 或 curl 验证接口是否可用
• 通过 Python、Node.js 或 OpenAI 兼容 SDK 接入业务系统
• 在控制台管理 Token、查看调用日志和用量消耗

新手推荐流程

第一次使用时，不建议一开始就接入复杂项目。请按下面顺序操作：

1. 登录应天AI 控制台
2. 确认账号可用、余额正常
3. 创建一枚 API Token
4. 确认服务地址、模型名称和 Token 都正确
5. 先用 curl 或 Postman 发起最小测试请求
6. 在日志页面确认请求成功
7. 再把同一套配置填入客户端或 SDK

这样可以先确认平台、Token、地址和模型名都没有问题，再排查具体客户端配置。

接入时需要准备的信息

信息	说明	示例
控制台地址	用于登录和管理 Token、日志、用量	https://ai.t1qq.com
Base URL	客户端或 SDK 调用接口时填写的服务地址	https://ai.t1qq.com/v1
API Token	在控制台令牌页面创建，通常以 sk- 开头	sk-...
模型名称	以控制台实际开放的模型列表为准	gpt-4o

注意：不同客户端对 Base URL 的要求可能不同。有些需要填写完整 /v1，有些会自动补全。首次接入建议先用 curl 或 Postman 验证标准地址。

文档入口

客户新手使用指南

适合第一次使用平台的客户。内容包括登录、创建 Token、确认地址、配置客户端、发送第一条测试请求和常见错误排查。

进入：客户新手使用指南

模型定价与计费

介绍模型广场中的输入、输出、缓存读取、缓存写入、倍率、按量付费、按次付费和动态计费，帮助你理解模型价格与实际额度消耗之间的关系。

进入：模型定价与计费说明

AI 应用客户端接入

适合希望在 AI 编程工具或聊天客户端中使用应天AI的用户。教程会从注册账号、创建 API Token 开始，逐步说明如何填写 Base URL、API Key 和模型名称，并通过测试消息与控制台日志确认接入成功。

目前已提供：Trae 接入应天AI教程

成功接入的判断标准

当以下条件都满足时，说明基础接入已经完成：

• 客户端或测试工具能正常返回模型回复
• 没有出现 401、403、404、429、500 等错误
• 控制台日志页面能看到本次请求记录
• 日志中的模型、时间、状态和消耗信息正常

常见错误快速判断

现象	优先检查
401 Unauthorized	Token 是否复制完整，请求头是否为 Authorization: Bearer 你的Token
403 Forbidden	Token 是否有模型权限，是否配置了 IP 白名单
404 Not Found	Base URL 是否填错，是否重复拼接 /v1
429 Too Many Requests	请求是否过快，额度或频率限制是否触发
余额不足	账号余额或 Token 配额是否足够
模型不存在	模型名称是否以控制台可用列表为准
客户端超时但无日志	请求可能没有到达平台，检查网络、代理和客户端地址

建议

新手接入时请记住一条原则：先用最小请求跑通，再配置客户端，最后接入业务系统。

如果 curl 或 Postman 已经成功，但客户端失败，问题通常在客户端地址格式、模型名、代理或高级参数配置上。