本文へ移動
GetAPI
日本語
メニュー

GetAPI.ONE

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

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

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

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

次の手順