应天AI

Appearance

使用指南 ​

本指南面向第一次使用 应天AI 的客户，重点帮助你快速完成登录、创建 Token、配置 AI 客户端，并成功发起第一条请求。你不需要先理解所有后台概念，只要按本文顺序走完一遍，就能把常见客户端或开发工具顺利接起来。

适用场景 ​

  • 需要通过 OpenAI 兼容接口调用主流 AI 模型的用户
  • 需要在网页控制台管理令牌、查看日志和用量的个人或团队
  • 需要将 应天AI 配置到 Cursor、Cherry Studio、ChatBox、Postman、OpenAI SDK 等工具中的用户

这份指南能帮你完成什么 ​

通过 应天AI，你可以使用统一的服务地址和统一的 API Token，在不同客户端和开发工具中调用平台提供的模型能力，例如：

  • 文本对话与内容生成
  • 代码编写与开发辅助
  • 图像、多模态或其他扩展能力
  • 在多个客户端之间复用同一套接入配置

对终端用户来说，最重要的是：只要拿到访问地址和 Token，就可以在多个工具里完成接入。

前置条件 ​

开始前，请先确认你已经具备以下条件：

  • 已获得 应天AI 的访问地址
  • 已拥有可登录账号
  • 已有可用额度
  • 已能够在控制台创建 API Token

如果你是团队用户，这些信息通常由管理员提供；如果你使用的是开放注册的平台，则可以在控制台自行完成。

快速上手 ​

本节只做一件事：把 应天AI 配置到你的客户端中，并在日志里看到第一条成功请求。

如果你是第一次使用，建议按下面顺序完成：

  1. 登录 应天AI
  2. 进入令牌管理
  3. 创建 API Token
  4. 配置客户端或测试工具
  5. 发起一条最小请求
  6. 在日志中确认调用成功

这条路径能最快帮你确认问题是在账号、Token、地址、模型名，还是客户端本身。

第一步：登录 应天AI ​

在浏览器中打开你的 应天AI 官网 访问地址，使用账号登录。登录后可以进入控制台首页查看账号概况、余额和用量信息。

登录成功后，建议先确认以下信息：

  • 能正常进入控制台首页
  • 能看到账号、余额、用量或基础信息
  • 能进入令牌页面和日志页面

成功标志：能够稳定进入控制台，而不是反复回到登录页。

如果登录后页面不断跳转、加载异常或无法保持登录状态，优先检查浏览器 Cookie、代理环境和当前账号状态。

第二步：进入令牌管理 ​

登录后，在左侧导航栏进入 API 密钥 页面，或直接打开API 密钥管理。

成功标志：你能看到已有令牌列表，或者看到“暂无数据”的空状态页面。

如果连令牌页面都无法访问，通常说明账号权限或页面加载存在问题，建议先确认账号状态是否正常。

第三步：创建 API Token ​

API Token 是接入客户端和调用接口时最重要的凭证。无论你使用的是 SDK、脚本、桌面客户端还是编辑器插件，都需要先创建一枚可用 Token。

创建时建议关注以下配置项：

  • 令牌名称：建议使用容易识别的名称，例如 cursor、chatbox、my-app
  • 过期时间：可留空，或按需设置过期日期
  • 配额限制：新手阶段可先使用默认值
  • 模型限制：如无特殊要求，可先留空
  • IP 白名单：如无固定出口 IP，可先留空

创建后请立即复制并保存完整 Token Key。它通常以 sk- 开头。

成功标志：你拿到了一枚完整可复制的 Token。

注意事项：

  • 不要带空格、换行或中文引号复制 Token
  • 不要把真实 Token 发到群聊、截图或公开仓库中
  • 某些平台关闭弹窗后将无法再次查看完整 Key，丢失后需要重新创建
  • 建议为不同设备或不同应用创建不同 Token，便于后续管理和排查

第四步：确认服务地址和模型名 ​

在客户端里，你通常需要填写三项核心配置。模型名称可以前往模型广场查看并复制：

配置项填写内容
Base URL平台提供的服务地址，例如 https://ai.t1qq.com/v1
API Key刚创建的 Token
Model当前平台支持的模型名称，例如 gpt-5

这里最容易出错的是地址和模型名：

  • 有些客户端要求填写根地址
  • 有些客户端要求填写完整的 /v1 前缀
  • 有些客户端会自动补 /v1
  • 模型名称必须以控制台实际提供的模型为准

如果你不确定某个客户端的地址格式，建议先用 curl 或 Postman 跑通，再回头填到客户端里。

第五步：配置你的 AI 客户端 ​

应天AI 对外提供 OpenAI 兼容接口，因此大多数支持 OpenAI Compatible 的工具都可以直接接入。

常见填写方式如下：

  • Base URL：https://ai.t1qq.com/v1
  • API Key：你的 Token
  • Model：模型广场中当前可用的模型名称

在 Cursor、Cherry Studio、ChatBox、Postman 等工具中，一般可以这样操作：

  1. 打开设置页或模型配置页
  2. 选择 OpenAI Compatible、自定义 OpenAI 接口 或类似选项
  3. 填入 Base URL、API Key 和模型名称
  4. 保存配置并重新测试

建议第一次先关闭不必要的高级选项，优先验证基础调用是否成功。

用 curl 测试第一条请求 ​

如果你的服务地址是：

text
https://ai.t1qq.com/v1

可以直接用下面的示例测试：

bash
curl https://ai.t1qq.com/v1/chat/completions \
  -H "Authorization: Bearer 你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "请回复：配置成功"
      }
    ]
  }'

成功标志：接口返回正常模型回复，而不是认证错误、路径错误或网络错误。

用 SDK 接入 ​

如果你在项目中使用 OpenAI 兼容 SDK，通常只需要把 base_url 和 api_key 替换成平台提供的值。

Python 示例 ​

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_TOKEN",
    base_url="https://ai.t1qq.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "请回复：SDK 接入成功"}
    ],
)

print(resp.choices[0].message.content)

Node.js 示例 ​

javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_TOKEN",
  baseURL: "https://ai.t1qq.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [
    { role: "user", content: "请回复：Node SDK 接入成功" }
  ],
});

console.log(resp.choices[0].message.content);

如果你只是想先验证接口能不能通，也可以先用 curl 或 Postman，不必一上来就接入完整业务代码。

如何验证是否成功 ​

完成配置后，建议发送一条最小测试消息，例如：

text
请只回复：配置成功

然后检查以下结果：

  • 客户端能正常返回内容
  • 没有出现 401、403、404 或网络错误
  • 使用日志中能看到对应请求记录
  • 日志中能看到模型、时间、状态和消耗信息

成功标志：日志中出现本次请求，且状态为成功。

API 快速开始 ​

如果你是开发者，希望用最小请求确认接口可用，可以按下面方式快速验证。

1. 设置环境变量 ​

推荐先把 Token 和模型名放到环境变量里，避免直接写进脚本：

bash
export NEWAPI_API_KEY="你的 API Token"
export NEWAPI_MODEL="控制台可用的模型名称"

2. 发起一次最小请求 ​

bash
curl https://ai.t1qq.com/v1/chat/completions \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$NEWAPI_MODEL"'",
    "messages": [
      {"role": "user", "content": "用一句话介绍 应天AI"}
    ]
  }'

3. 确认返回结果 ​

如果以下条件同时满足，说明 API 已经可用：

  • HTTP 状态码为 200
  • 响应中包含模型输出内容
  • 日志中出现本次请求记录

常见问题与排障 ​

登录后反复回到登录页 ​

可能原因：

  • 浏览器 Cookie 异常
  • 登录会话未正确建立
  • 本地代理或网络环境干扰了请求

解决方法：

  • 检查浏览器 Cookie 设置
  • 关闭代理后重试
  • 更换无痕窗口或浏览器测试
  • 确认账号状态正常

返回 401 Unauthorized ​

可能原因：

  • Token 无效、缺失或复制不完整
  • Authorization 头格式不正确
  • Token 已过期或被禁用

解决方法：

  • 确认请求头格式为 Authorization: Bearer 你的Token
  • 重新复制 Token，检查是否带了空格或换行
  • 如有必要，重新创建一枚新 Token 测试

返回 403 Forbidden ​

可能原因：

  • 当前 Token 没有权限访问对应模型
  • Token 配置了 IP 白名单，但当前来源不在允许范围内

解决方法：

  • 检查 Token 的模型限制
  • 检查 IP 白名单设置
  • 必要时重新创建一枚不带限制的测试 Token

返回 404 Not Found ​

可能原因：

  • Base URL 填写错误
  • 客户端多拼了一层 /v1
  • 请求路径不正确

解决方法：

  • 确认实际地址格式
  • 检查客户端是否自动补全路径
  • 优先用 curl 直接验证正确地址

返回 429 Too Many Requests ​

可能原因：

  • 请求过于频繁
  • 当前额度或频率限制已触发

解决方法：

  • 降低请求频率
  • 稍后重试
  • 联系平台方确认是否需要提升额度或限流配置

返回 500 或 503 ​

可能原因：

  • 服务端临时异常
  • 当前模型不可用
  • 上游服务波动

解决方法：

  • 稍后重试
  • 更换其他可用模型测试
  • 如持续出现，联系平台方排查

提示余额不足或 insufficient_quota ​

可能原因：

  • 账户额度不足
  • Token 本身设置了较低限额

解决方法：

  • 检查账户可用额度
  • 检查 Token 限额设置
  • 联系平台方补充额度

提示模型不存在 ​

可能原因：

  • 模型名称填写错误
  • 当前平台未开放该模型

解决方法：

  • 以控制台提供的模型列表为准
  • 不要直接照搬其他平台的模型名称

客户端超时，但日志里没有记录 ​

这通常说明请求没有真正到达服务端。

优先检查：

  • 服务地址是否填错
  • 请求是否被代理、浏览器插件或网络工具改写
  • 当前客户端是否真的发送到了目标域名

令牌使用建议 ​

为了保证安全和后续管理方便，建议遵循以下做法：

  • 不同设备和不同应用使用不同 Token
  • 不在公开页面、仓库或截图中暴露 Token
  • 长期使用的 Token 定期轮换
  • 如怀疑泄露，立即删除旧 Token 并重新生成

如果你是团队用户，也建议不同成员分别使用各自的 Token，避免多人共用同一凭证导致日志难以区分。

推荐接入顺序 ​

对于大多数客户来说，最省时间的方式通常不是一开始就接复杂业务，而是按下面顺序推进：

  1. 登录平台
  2. 创建 Token
  3. 用 curl 或 Postman 跑通一条最小请求
  4. 再接入 SDK
  5. 最后接入 Cursor、Cherry Studio 或内部系统

只要第 3 步已经跑通，后面的客户端接入通常都会顺很多。

下一步 ​

完成本指南后，你可以继续：

  • 查看模型广场中的可用模型和价格信息
  • 查看数据看板和使用日志
  • 前往充值页面管理账户余额
  • 为不同应用创建独立 Token
  • 将相同的 Base URL 与 Token 配置到更多客户端中
  • 参考完整 API 文档接入自己的系统或服务

一句话总结 ​

对客户来说，使用 应天AI 的核心很简单：登录平台，创建 Token，填好地址，选对模型，再用一条最小请求验证成功。 一旦这一步完成，后续无论是接 SDK、接客户端，还是接入自己的业务系统，都会变得非常直接。