GetAPI.ONE
使用 Node.js 调用 GetAPI.ONE
在可信 Node.js 运行时中使用官方 OpenAI JavaScript SDK,并配置 ONE Base URL、环境凭据和准确的目录模型。
准备服务端项目
- 仍在维护期内的 Node.js 版本与 ESM 项目。
- 一个已启用且额度受限的 GetAPI.ONE 密钥。
- 当前目录中明确声明 Responses 端点的准确模型。
npm install openai创建客户端并发起请求
- 通过服务端进程环境注入 GETAPI_ONE_API_KEY。
- 将 baseURL 设为 https://www.getapi.one/v1。
- 用当前目录的准确 ID 替换占位符。
- 仅在接受可能计费时运行一次小请求。
- 首次检查禁用自动重试。仅在分类可安全重复的操作后添加有界重试策略。
import OpenAI from 'openai';
const apiKey = process.env.GETAPI_ONE_API_KEY;
if (!apiKey) throw new Error('Set GETAPI_ONE_API_KEY before starting');
const client = new OpenAI({
apiKey,
baseURL: 'https://www.getapi.one/v1',
timeout: 30_000,
maxRetries: 0,
});
const response = await client.responses.create({
model: '<MODEL_ID_FROM_CURRENT_CATALOG>',
input: 'Reply with one short readiness check.',
});
console.log(response.output_text);明确运行时边界
| 决策 | 做法 |
|---|---|
| 端点基址 | https://www.getapi.one/v1 |
| 凭据来源 | process.env.GETAPI_ONE_API_KEY |
| 模型 | 当前目录中的准确 ID,而不是猜测的别名 |
验证预期结果
- Promise 正常完成,response.output_text 包含简短回复。
- 客户端 Bundle、日志或错误页中均不出现凭据。
- ONE 控制台中可见匹配的请求或用量记录。
修复常见错误
| 现象 | 处理 |
|---|---|
| 缺少密钥异常 | 在启动 Node 的同一 Shell 或服务环境中设置变量。 |
| 401 | 重新复制已启用的 ONE 密钥并去除多余空白。 |
| 404 或操作不支持 | 只保留一个 /v1,并让 SDK 方法匹配模型声明的端点。 |
保护生产用量
- 将密钥存入部署平台的 Secret Manager,不要写入 package.json 或前端环境变量。
- 对外暴露服务端端点前,加入请求超时、错误处理与自己的用户鉴权。
- 密钥泄露时立即轮换,并检查用量记录中的异常调用。