使用 Node.js 呼叫 GetAPI.ONE

在可信 Node.js 執行時中使用官方 OpenAI JavaScript SDK，並設定 ONE Base URL、環境憑據和準確的目錄模型。

從這裡開始

請在 Node.js 中執行本範例，不要放進瀏覽器。將程式碼儲存為 index.mjs，透過程序環境提供 API 金鑰，並選擇支援 Responses 的模型。範例會輸出文字回覆；請求可能產生費用。

準備伺服器端專案

仍在維護期內的 Node.js 版本與 ESM 專案。
一個已啟用且額度受限的 GetAPI.ONE 金鑰。
目前目錄中明確宣告 Responses 端點的準確模型。

shell

npm install openai

建立用戶端並發起請求

透過伺服器端程序環境注入 GETAPI_ONE_API_KEY。
將 baseURL 設為 https://www.getapi.one/v1。
用目前目錄的準確 ID 替換預留位置。
僅在接受可能計費時執行一次小請求。
首次檢查停用自動重試。僅在分類可安全重複的操作後新增有界重試策略。

node index.mjs

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