L10 · Especificación · 4 min
¿Qué es una API (y una clave de API)?
En una frase
Una API es un contrato estructurado de mensajería que permite al backend de tu aplicación pedir trabajo a otro servicio (como un proveedor de IA) por internet, y una clave de API es la contraseña privada que envía tu servidor para demostrar que tiene permiso.
Piénsalo así
Una API es como un albarán estándar entre la cocina de un hotel y un obrador de confianza: la cocina envía un pedido exacto («12 cruasanes sencillos») y recibe una caja etiquetada. La clave de API es el sello de la cuenta del hotel en ese albarán: quien robe ese sello puede hacer pedidos a tu cargo.
Cómo funciona
Los programas no hacen clic en botones para hablar entre sí; usan una DefiniciónAPILa forma acordada en que dos programas hablan entre sí, como tu app pidiendo una respuesta a un proveedor de IA.Abrir en el glosario → (interfaz de programación de aplicaciones). El DefiniciónbackendLa parte de una app que funciona en un servidor: guarda datos, comprueba inicios de sesión y habla con otros servicios.Abrir en el glosario → de tu app envía una petición segura por HTTPS con texto estructurado (JSON) a una dirección concreta —como https://api.tokentide.app/v1— y recibe una respuesta en JSON un instante después.
Como los servicios externos tienen un precio o manejan datos privados, exigen una Definiciónclave de APIUna contraseña que usa tu app con otro servicio. Quien la tenga puede gastar tu dinero.Abrir en el glosario → en cada petición. Por ejemplo, una clave de Tokentide empieza por tt_live_ y se muestra una sola vez al crearla (puedes cargar saldo desde 10 USD). Quien tenga esa clave puede gastar tu saldo, por lo que siempre pones un tope de gasto diario y usas una clave aparte de límite bajo para el desarrollo en tu equipo.
Tu app lee cada clave de API desde una Definiciónvariable de entornoUn hueco con nombre, como `TOKENTIDE_API_KEY`, que guarda un ajuste o un secreto fuera de tu código.Abrir en el glosario → —como TOKENTIDE_API_KEY o AI_GATEWAY_API_KEY— guardada únicamente en DefiniciónVercelEl servicio que convierte tu código de GitHub en una web publicada, con una vista previa para cada cambio.Abrir en el glosario → (tipo Secret) y en el archivo .env.local de tu equipo. Tú pegas las claves directamente allí; nunca pegas una clave de API en el chat, en el código ni en GitHub.
Todas las llamadas a una API que usan una clave DefiniciónsecretoTodo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en `.env.local`.Abrir en el glosario → se hacen estrictamente desde el servidor (en Server Actions o Route Handlers de Next.js), nunca desde el navegador visitante. Si alguna vez sospechas que una clave se ha filtrado, la revocas al instante en la web del proveedor, creas una nueva y actualizas Vercel y .env.local.
Cómo se ve en tu proyecto
Cuando tu plan llega a una función con IA, tu agente prepara .env.local con las líneas TOKENTIDE_API_KEY= y AI_GATEWAY_API_KEY= vacías y te indica cómo pegar tus claves en VS Code y en los ajustes de Vercel. Después ejecuta npm run check-env, que solo comprueba si cada nombre está puesto o falta, sin mostrar jamás su valor.
Copia para tu agente
Comprueba qué API externas usa mi proyecto, confirma que todas las llamadas se ejecutan exclusivamente en el servidor y haz una comprobación que diga solo si los nombres de sus variables de entorno están puestos o faltan.
Comprobación rápida · 1 pregunta