本文へ移動
GetAPI
ダッシュボード
日本語
外観
通知
通知
読み込み中…
メニュー

Node.js から GetAPI.ONE を呼び出す

信頼できる Node.js 実行環境で公式 OpenAI JavaScript SDK を使い、ONE ベース URL、環境変数の認証情報、正確なカタログモデルを設定します。

ここから始める

この例はブラウザーではなく Node.js で実行してください。コードを index.mjs として保存し、プロセスの環境変数で API キーを渡して、Responses 対応モデルを選びます。テキストの応答が出力されます。リクエストには料金が発生する場合があります。

サーバー側プロジェクトを準備

  • 保守対象の Node.js リリースと ESM プロジェクト。
  • 有効で範囲を限定した GetAPI.ONE キー。
  • Responses エンドポイントを明示した現在のカタログの正確なモデル。
shell
npm install openai

クライアントを作成してリクエスト

  1. サーバープロセスの環境を通じて GETAPI_ONE_API_KEY を設定します。
  2. baseURL を https://www.getapi.one/v1 に設定します。
  3. プレースホルダーを現在のカタログの正確な ID に置き換えます。
  4. 課金の可能性を受け入れられる場合のみ、小さなリクエストを 1 回実行します。
  5. 最初の確認では自動再試行を無効にします。安全に繰り返せる操作を分類してから、回数制限付きの再試行方針を追加します。
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 に短い応答が含まれること。
  • クライアント側バンドル、ログ、エラーページに認証情報が含まれないこと。
  • ONE コンソールに対応するリクエスト記録または使用記録が表示されること。

一般的なエラーを解決

症状対処
キー欠落の例外Node を起動する同じシェルまたはサービス環境に変数を設定します。
401有効な ONE キーをコピーし直し、余分な空白を除去します。
404 または未対応の操作/v1 は 1 つだけ残し、SDK メソッドをモデルが明示したエンドポイントに合わせます。

本番での利用を保護

  • シークレットは package.json やフロントエンドの環境変数ではなく、デプロイ先のシークレット管理に保存します。
  • サーバーのエンドポイントを公開する前に、リクエストのタイムアウト、エラー処理、独自のユーザー認可を適用します。
  • 漏洩したキーを更新し、使用記録に想定外の呼び出しがないか確認します。

次の手順