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.
npm install openaiClient erstellen und Anfrage senden
- Stellen Sie GETAPI_ONE_API_KEY über die Umgebung des Serverprozesses bereit.
- Setzen Sie baseURL auf https://www.getapi.one/v1.
- Ersetzen Sie den Platzhalter durch eine exakte aktuelle Katalog-ID.
- Führen Sie eine kleine Anfrage nur aus, wenn Sie mögliche Kosten akzeptieren.
- Die erste Prüfung deaktiviert automatische Wiederholungen. Ergänzen Sie eine begrenzte Wiederholungsregel erst, nachdem Sie sicher wiederholbare Operationen eingeordnet haben.
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
| Entscheidung | Verwendung |
|---|---|
| Endpunktbasis | https://www.getapi.one/v1 |
| Quelle der Zugangsdaten | process.env.GETAPI_ONE_API_KEY |
| Modell | Exakte 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
| Symptom | Aktion |
|---|---|
| Ausnahme wegen fehlenden Schlüssels | Setzen Sie die Variable in derselben Shell- oder Dienstumgebung, die Node startet. |
| 401 | Kopieren Sie den aktivierten ONE-Schlüssel erneut und entfernen Sie überflüssige Leerzeichen. |
| 404 oder nicht unterstützte Aktion | Behalten 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.