GetAPI.ONE
Node.js から GetAPI.ONE を呼び出す
信頼できる Node.js 実行環境で公式 OpenAI JavaScript SDK を使い、ONE ベース URL、環境変数の認証情報、正確なカタログモデルを設定します。
サーバー側プロジェクトを準備
- 保守対象の Node.js リリースと ESM プロジェクト。
- 有効で範囲を限定した GetAPI.ONE キー。
- Responses エンドポイントを明示した現在のカタログの正確なモデル。
npm install openaiクライアントを作成してリクエスト
- サーバープロセスの環境を通じて GETAPI_ONE_API_KEY を設定します。
- baseURL を https://www.getapi.one/v1 に設定します。
- プレースホルダーを現在のカタログの正確な ID に置き換えます。
- 課金の可能性を受け入れられる場合のみ、小さなリクエストを 1 回実行します。
- 最初の確認では自動再試行を無効にします。安全に繰り返せる操作を分類してから、回数制限付きの再試行方針を追加します。
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 やフロントエンドの環境変数ではなく、デプロイ先のシークレット管理に保存します。
- サーバーのエンドポイントを公開する前に、リクエストのタイムアウト、エラー処理、独自のユーザー認可を適用します。
- 漏洩したキーを更新し、使用記録に想定外の呼び出しがないか確認します。