Programar · GUÍA PRÁCTICA
Tu primera API de IA sin exponer la clave
Entiende el viaje de una llamada, ejecuta un ejemplo en Node y aprende dónde mirar tokens, precios y seguridad.
Actualizado el · Lectura 10 min
Una API conecta tu programa con un servicio. Aquí harás una llamada de texto desde Node en el servidor, distinguirás la clave secreta del código público y sabrás qué consultar antes de estimar el coste. No hace falta instalar nada en Toma Clara para seguir el ejemplo.
import OpenAI from "openai";
const client = new OpenAI(); // Lee OPENAI_API_KEY del entorno
const model = process.env.OPENAI_MODEL;
if (!model) throw new Error("Define OPENAI_MODEL con un modelo disponible para tu proyecto.");
const response = await client.responses.create({
model,
input: "Explica qué es una API en una frase.",
});
console.log(response.output_text);La clave se configura como variable de entorno OPENAI_API_KEY en el servidor. OPENAI_MODEL debe ser un identificador disponible para tu cuenta; comprueba la documentación de modelos antes de ejecutar.
1. Qué ocurre en una llamada
Tu aplicación prepara una petición con un modelo y una entrada; se autentica con una credencial y el servicio devuelve una respuesta. El SDK oficial simplifica la autenticación y el formato. La respuesta sigue siendo texto generado: valida lo que usarás.
2. Ejecuta el ejemplo en local
Necesitas Node.js, un proyecto de prueba y el paquete oficial. Instala el SDK con “npm install openai”. Configura OPENAI_API_KEY y OPENAI_MODEL en el entorno de esa terminal y guarda el ejemplo como .mjs. No pongas valores reales de clave en el archivo. Consulta el inicio rápido enlazado abajo si cambia el comando de instalación o el flujo.
3. Una clave API es un secreto
Nunca la pegues en el JavaScript de una página, una aplicación móvil, una captura, un repositorio público o un prompt. El navegador entrega el código al visitante, así que cualquier secreto incluido puede extraerse. Si una web pública necesita una API, la llamada debe pasar por un servidor tuyo, con límites, controles y almacenamiento seguro de claves.
4. Tokens no equivalen exactamente a palabras
Los servicios miden el texto de entrada y salida en tokens, fragmentos que pueden ser palabras, partes de palabra o símbolos. El recuento cambia con el idioma, el modelo y el contenido. Archivos, imágenes, herramientas y caché pueden tener reglas de cómputo distintas; usa los datos de uso que devuelve la API para medir una petición real.
5. Estima el coste con la tarifa vigente
Cuando la tarifa se expresa por millón de tokens, una estimación simple es (tokens de entrada × precio de entrada + tokens de salida × precio de salida) ÷ 1.000.000. Usa las tarifas actuales del modelo y verifica si hay precios diferenciados, caché, herramientas, impuestos o mínimos. El coste de la API se consulta por separado del producto de chat; no asumas que una suscripción incluye llamadas API.
6. Antes de subirlo a producción
No subas .env ni una clave al control de versiones; añade .env a .gitignore. Usa variables de entorno o un gestor de secretos, separa la clave de desarrollo y producción, impón límites al número y tamaño de peticiones, registra uso sin registrar secretos y crea alertas de gasto. Si sospechas que una clave se filtró, revócala y comprueba el consumo.