在国内开发 AI 产品时,直接使用 OpenAI 官方 API 经常会遇到网络、注册和付费等障碍。GPTsAPI.net 提供了一个兼容 OpenAI 协议的 API 服务。
本文将从注册、申请 API Key 到后端集成逐步拆解,并结合真实 Nuxt 后端代码解释如何打造一个稳定、可控的 AI 产品。
🧠 一、什么是 GPTsAPI.net?
它的主要特点包括:
- 支持兼容 OpenAI 的 API 调用方式(如
/v1/chat/completions)知乎专栏 - 在国内访问更稳定
- 模型资源丰富,且支持按量计费
📍 二、如何在 GPTsAPI.net 上申请 API Key
1. 访问 GPTsAPI.net 官网
首先打开:gptsapi.net 你会看到平台介绍和入口页面。
注:GPTsAPI.net 没有公开 API 文档页面,但其官网提供了注册入口和控制台用于 API Key 管理。
2. 注册账号
- 点击 注册 / 登录 按钮
- 使用邮箱或手机号完成注册
- 进入用户控制台
3. 在控制台中创建 API Key
在控制台界面中你可以看到 API Key 管理界面:
- 点击 "创建 API Key"
- 系统会生成一个独一无二的 Key
通常你会看到形如:
sk-xxx...或者由平台生成的一串字符
请务必保管好这个 Key!
4. 充值 / 选择计费计划(如有)
部分 API Key 需要充值才能调用,你可以在控制台中选择计费方式并完成充值。
不同模型的价格可能不同,例如:
| 模型 | 价格(示例) |
|---|---|
| GPT-4 系列 | 较高定价 |
| Claude 系列 | 不同版本价格不同 |
| 其他轻量模型 | 特定价格 知乎专栏 |
🛠️ 三、如何在后端使用 GPTsAPI Key
有了 API Key 之后,你就可以通过标准的 OpenAI API 兼容方式调用 GPTsAPI 了。
基本原则:
✨ 把 API Key 放在后端,不暴露给前端
✨ 使用统一基地址 https://api.gptsapi.net/v1
下面是关键的集成方式(基于你提供的 Nuxt 后端代码)。
🔌 四、后端集成示例代码(Nuxt 3 + OpenAI SDK)
ini
import OpenAI from "openai"
import { Config } from "~/utils/Config"
export default defineEventHandler(async (event) => {
const body = await readBody(event)
const {
model = "gpt-5-nano",
prompt = "",
history = [],
summary = "",
files = [],
} = body;
const client = new OpenAI({
apiKey: Config.AI_API_KEY(),
baseURL: Config.AI_API_BASE_URL(),
})
🔹 Config.AI_API_KEY() 的值需要是你在 GPTsAPI.net 申请的 Key
🔹 Config.AI_API_BASE_URL() 通常填 https://api.gptsapi.net/v1
✂️ 五、清洗历史消息 & 多模态内容构造
为了提升生成质量,你的代码中做了以下优化:
javascript
const cleanHistory = (history || []).filter((m) => {
// 过滤无效历史
})
这样可以避免无效、空内容浪费 token。并支持文本 + 图片输入逻辑:
bash
userContent.push({
type: "image_url",
image_url: { url: `data:${f.type};base64,${f.data}` },
})
📡 六、流式响应与产品体验
调用 API 时你采用了流式输出:
csharp
const completion = await client.chat.completions.create({
model,
stream: true,
messages,
})
并使用 Nuxt 的 sendStream 将实时输出返回前端,这样:
- 用户前端可以像 ChatGPT 一样实时看到结果
- 响应体验更好
💡 七、产品级注意事项
- 不要在前端暴露 API Key
- 对调用进行限流与监控
- 设置最大 token 限制
- 做好错误兜底与重试策略
🧾 八、示例请求方式(curl)
当你获取 Key 以后,可以在本地测试:
arduino
curl https://api.gptsapi.net/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-3.5-turbo",
"messages": [{"role": "user","content": "Hello"}]
}'
📌 这里使用的就是GPTsAPI 提供的兼容 OpenAI 的 API 。知乎专栏
✅ 九、总结
通过 GPTsAPI.net 申请 Key 的步骤可以概括为:
- 打开 gptsapi.net
- 注册账号
- 进入控制台创建 API Key
- 在后端使用这个 Key 调用模型接口
本文部分内容借助 AI 辅助生成,并由作者整理审核。