GetAPI.ONE
Appeler GetAPI.ONE depuis Node.js
Utilisez le SDK JavaScript officiel OpenAI dans un environnement Node.js de confiance avec l’URL de base ONE, un identifiant d’environnement et un modèle exact du catalogue.
Préparer un projet côté serveur
- Une version maintenue de Node.js et un projet ESM.
- Une clé GetAPI.ONE activée et à portée limitée.
- Un modèle exact du catalogue actuel qui déclare le point de terminaison Responses.
npm install openaiCréer le client et la requête
- Injectez GETAPI_ONE_API_KEY via l’environnement du processus serveur.
- Définissez baseURL sur https://www.getapi.one/v1.
- Remplacez la valeur de substitution par un identifiant exact du catalogue actuel.
- N’exécutez qu’une petite requête lorsque vous acceptez une facturation éventuelle.
- Le premier contrôle désactive les nouvelles tentatives automatiques. N’ajoutez une politique limitée qu’après avoir classé les opérations pouvant être répétées en toute sécurité.
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);Conserver des limites d’exécution claires
| Décision | Utilisation |
|---|---|
| Base du point de terminaison | https://www.getapi.one/v1 |
| Source des identifiants | process.env.GETAPI_ONE_API_KEY |
| Modèle | Identifiant exact du catalogue actuel, pas un alias supposé |
Vérifier le résultat attendu
- La promesse est résolue et response.output_text contient la réponse courte.
- Aucun identifiant ne figure dans les bundles côté client, les journaux ou les pages d’erreur.
- Un enregistrement correspondant de requête ou d’utilisation est visible dans la console ONE.
Corriger les erreurs courantes
| Symptôme | Action |
|---|---|
| Exception pour clé manquante | Définissez la variable dans le shell ou l’environnement de service qui lance Node. |
| 401 | Copiez de nouveau la clé ONE activée et supprimez les espaces superflus. |
| 404 ou opération non prise en charge | Conservez un seul /v1 et faites correspondre la méthode du SDK au point de terminaison déclaré du modèle. |
Protéger l’utilisation en production
- Stockez les secrets dans le gestionnaire de secrets de la plateforme de déploiement, pas dans package.json ni dans les variables d’environnement du frontend.
- Appliquez des délais d’expiration, une gestion des erreurs et votre propre autorisation utilisateur avant d’exposer un point de terminaison serveur.
- Faites tourner les clés divulguées et examinez les enregistrements d’utilisation pour détecter les appels inattendus.