GetAPI.ONE
Llamar a GetAPI.ONE desde Node.js
Use el SDK JavaScript oficial de OpenAI en un entorno Node.js fiable con la URL base ONE, una credencial de entorno y un modelo exacto del catálogo.
Preparar un proyecto del servidor
- Una versión mantenida de Node.js y un proyecto ESM.
- Una clave GetAPI.ONE habilitada y limitada.
- Un modelo exacto del catálogo actual que declare el endpoint Responses.
npm install openaiCrear el cliente y la solicitud
- Inyecte GETAPI_ONE_API_KEY mediante el entorno del proceso del servidor.
- Defina baseURL como https://www.getapi.one/v1.
- Sustituya el marcador por un ID exacto del catálogo actual.
- Ejecute una solicitud pequeña solo cuando acepte los posibles cargos.
- La primera comprobación desactiva los reintentos automáticos. Añada una política limitada solo tras clasificar las operaciones que pueden repetirse con seguridad.
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);Mantener claros los límites del entorno de ejecución
| Decisión | Uso |
|---|---|
| Base del endpoint | https://www.getapi.one/v1 |
| Origen de credenciales | process.env.GETAPI_ONE_API_KEY |
| Modelo | ID exacto del catálogo actual, no un alias supuesto |
Verificar el resultado esperado
- La promesa se resuelve y response.output_text contiene la respuesta breve.
- No aparece ninguna credencial en paquetes del cliente, registros ni páginas de error.
- Hay un registro correspondiente de solicitud o uso en la consola ONE.
Corregir errores habituales
| Síntoma | Acción |
|---|---|
| Excepción por clave ausente | Defina la variable en el mismo shell o entorno de servicio que inicia Node. |
| 401 | Copie de nuevo la clave ONE habilitada y quite espacios accidentales. |
| 404 u operación no compatible | Conserve un único /v1 y haga coincidir el método del SDK con el endpoint declarado del modelo. |
Proteger el uso en producción
- Guarde secretos en el gestor de secretos de la plataforma de despliegue, no en package.json ni variables de entorno del frontend.
- Aplique tiempos de espera, gestión de errores y autorización de usuarios propia antes de exponer un endpoint de servidor.
- Rote claves filtradas y revise registros de uso en busca de llamadas inesperadas.