应天AI

Appearance

API 快速接入 ​

本页面向开发者和需要快速联调的客户。你可以先用最小请求确认应天AI 的 API 能否正常调用，再把同样的配置接入自己的项目、脚本或测试工具。

如果你还没有创建 Token，建议先阅读 客户新手使用指南。

接入地址 ​

平台接入地址如下：

text
http://ai.t1qq.com/

实际调用时通常需要使用 OpenAI 兼容接口路径：

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

你需要准备什么 ​

在开始调用前，请准备以下信息：

信息说明示例
Base URLAPI 调用地址http://ai.t1qq.com/v1
API Token在控制台创建的访问令牌sk-...
模型名称控制台可用模型列表中的名称gpt-4o

如果你不确定模型名称，请先到控制台查看可用模型列表。

最小调用流程 ​

推荐按下面顺序操作：

  1. 确认账号可用、Token 已创建
  2. 确认 Base URL 填写正确
  3. 先发起一条最小请求
  4. 在控制台日志中确认请求成功
  5. 再接入 SDK 或业务系统

不要一开始就加复杂参数。先让最简单的请求跑通，后面排查会容易很多。

用 curl 测试 ​

把 你的Token 替换成真实 Token，把 gpt-4o 替换成控制台实际可用的模型名称。

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

成功时，你应该能收到模型回复，而不是认证错误、路径错误或网络错误。

Python 接入示例 ​

python
from openai import OpenAI

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

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

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

Node.js 接入示例 ​

javascript
import OpenAI from "openai";

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

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

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

返回结果如何判断成功 ​

如果以下条件都满足，说明 API 接口已经接通：

  • HTTP 状态码正常
  • 返回了模型内容
  • 控制台日志中能看到对应请求
  • 请求模型、状态和消耗信息正常

常见问题 ​

1. 返回 401 Unauthorized ​

通常表示 Token 不正确。

请检查：

  • Token 是否复制完整
  • 请求头是否写成 Authorization: Bearer 你的Token
  • Token 前后是否带了空格或换行

2. 返回 404 Not Found ​

通常表示地址或路径错误。

请检查：

  • 是否使用了 http://ai.t1qq.com/v1
  • 客户端是否重复拼接了 /v1
  • 是否把站点首页地址当成接口地址

3. 返回 403 Forbidden ​

通常表示 Token 没有权限访问对应模型。

请检查：

  • Token 是否限制了模型
  • 当前模型是否对账号开放
  • 是否配置了 IP 白名单

4. 客户端有返回，但日志里没有记录 ​

通常表示请求没有真正到达平台。

请检查：

  • Base URL 是否填写正确
  • 客户端是否走了代理
  • 网络环境是否拦截了请求

推荐接入顺序 ​

对于新项目，建议按下面顺序推进：

  1. 先用 curl 跑通
  2. 再用 Python 或 Node.js 验证 SDK
  3. 最后接入 Cursor、Cherry Studio、ChatBox 或业务系统

这样可以快速判断问题是出在平台、Token、地址，还是客户端本身。

下一步 ​

如果你已经成功调用 API，可以继续：