Zum Inhalt springen
GetAPI
Deutsch
Menü

GetAPI.ONE

GetAPI.ONE aus Node.js aufrufen

Verwenden Sie das offizielle OpenAI-JavaScript-SDK in einer vertrauenswürdigen Node.js‑Laufzeit mit ONE-Basis-URL, Zugangsdaten aus der Umgebung und einem exakten Katalogmodell.

Serverseitiges Projekt vorbereiten

  • Eine gepflegte Node.js‑Version und ein ESM-Projekt.
  • Ein aktivierter, begrenzter GetAPI.ONE‑Schlüssel.
  • Ein exaktes aktuelles Katalogmodell, das den Responses-Endpunkt angibt.
shell
npm install openai

Client erstellen und Anfrage senden

  1. Stellen Sie GETAPI_ONE_API_KEY über die Umgebung des Serverprozesses bereit.
  2. Setzen Sie baseURL auf https://www.getapi.one/v1.
  3. Ersetzen Sie den Platzhalter durch eine exakte aktuelle Katalog-ID.
  4. Führen Sie eine kleine Anfrage nur aus, wenn Sie mögliche Kosten akzeptieren.
  5. Die erste Prüfung deaktiviert automatische Wiederholungen. Ergänzen Sie eine begrenzte Wiederholungsregel erst, nachdem Sie sicher wiederholbare Operationen eingeordnet haben.
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);

Laufzeitgrenzen klar halten

EntscheidungVerwendung
Endpunktbasishttps://www.getapi.one/v1
Quelle der Zugangsdatenprocess.env.GETAPI_ONE_API_KEY
ModellExakte aktuelle Katalog-ID, kein vermuteter Alias

Erwartetes Ergebnis prüfen

  • Das Promise wird erfüllt und response.output_text enthält die kurze Antwort.
  • In clientseitigen Bundles, Protokollen und Fehlerseiten erscheinen keine Zugangsdaten.
  • Ein passender Anfrage- oder Nutzungsdatensatz ist in der ONE-Konsole sichtbar.

Häufige Fehler beheben

SymptomAktion
Ausnahme wegen fehlenden SchlüsselsSetzen Sie die Variable in derselben Shell- oder Dienstumgebung, die Node startet.
401Kopieren Sie den aktivierten ONE-Schlüssel erneut und entfernen Sie überflüssige Leerzeichen.
404 oder nicht unterstützte AktionBehalten Sie genau ein /v1 bei und stimmen Sie die SDK-Methode auf den angegebenen Endpunkt des Modells ab.

Produktionsnutzung schützen

  • Speichern Sie Geheimnisse im Secret Manager der Bereitstellungsplattform, nicht in package.json oder Frontend-Umgebungsvariablen.
  • Implementieren Sie Anfragezeitlimits, Fehlerbehandlung und eigene Nutzerberechtigungen, bevor Sie einen Serverendpunkt bereitstellen.
  • Tauschen Sie offengelegte Schlüssel aus und prüfen Sie Nutzungsdatensätze auf unerwartete Aufrufe.

Nächste Schritte