GetAPIGetAPI.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 或前端環境變數。
- 對外暴露伺服器端端點前，加入請求逾時、錯誤處理與自己的使用者鑑權。
- 金鑰洩露時立即輪換，並檢查用量記錄中的異常呼叫。