L23 · Construcción y vista previa · 6 min
Añadir IA a tu app, con un respaldo
En una frase
Cuando tu app llama a un modelo de IA, esas peticiones se hacen solo desde el servidor: van primero a Tokentide por su menor precio y cero retención de datos, y pasan automáticamente a Vercel AI Gateway si no hay capacidad para que tus usuarios reciban siempre respuesta.
Piénsalo así
Piensa en una panadería que compra harina a un molino de confianza a muy buen precio, pero tiene un segundo proveedor de reserva. Si una mañana de mucho trabajo el molino se queda sin existencias, el pedido pasa automáticamente al segundo proveedor y el pan sale a su hora.
Cómo funciona
Las llamadas a la IA se hacen siempre en tu 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 → (en una Server Action, un Route Handler o una tarea en segundo plano), nunca en el navegador, para que tu Definiciónclave de APIUna contraseña que usa tu app con otro servicio. Quien la tenga puede gastar tu dinero.Abrir en el glosario → siga secreta y protegida por un Definiciónlímite de usoUn tope de cuántas veces se puede hacer algo, como intentos de inicio de sesión por minuto, para frenar abusos.Abrir en el glosario →. Cada petición de texto fija max_completion_tokens —unas dos veces la respuesta más larga esperada— para que una sola respuesta descontrolada no vacíe tu saldo.
Tu proveedor principal es Tokentide (https://api.tokentide.app/v1), que cuesta hasta un ~63 % menos que el precio de lista y no guarda copia de tus prompts ni de las respuestas. Configuras maxRetries: 0 en el cliente de Tokentide para que, si en un momento dado no hay capacidad (503), salta un límite (429), falta saldo (402) o hay un fallo del servidor (500/502/504) o un tiempo de espera agotado, no espere: pasa la petición al instante a tu Definiciónrespaldo (fallback)Una alternativa que responde cuando el proveedor principal no puede, para que tu app siga funcionando.Abrir en el glosario →, Vercel AI Gateway (https://ai-gateway.vercel.sh/v1), y respeta el tiempo de Retry-After antes de volver a intentar el principal.
No todos los errores deben activar el respaldo. Si la clave está mal (401 invalid_api_key) o restringida (403 ip_not_allowed o account_restricted), la app usa el respaldo para no dejar a nadie colgado y además te avisa para corregir la clave. Pero si la petición en sí es incorrecta —como 403 model_not_allowed u otro 4xx—, no se usa el respaldo: tu agente corrige la petición y comprueba la pareja de identificadores del DefiniciónmodeloEl sistema de IA que produce las respuestas, como el que hay detrás de tu agente.Abrir en el glosario → en ambos catálogos.
Para proteger la privacidad y la seguridad, tu Definiciónlog (registro)El diario de tu app: una línea por evento. Cuando algo se rompe, los logs cuentan qué pasó.Abrir en el glosario → anota el gasto (X-Tokentide-Charge-USD), el identificador (X-Request-Id), la función de la app y qué proveedor respondió, pero nunca el DefiniciónpromptEl mensaje que le das a un modelo de IA. Un prompt claro da mejores resultados.Abrir en el glosario → ni la respuesta. Y como lo que devuelve un modelo no es de confianza, tu código lo valida y escapa antes de mostrarlo o guardarlo.
Tokentide primero. Vercel AI Gateway cuando no puede responder.
- Hasta ~63 % por debajo del precio de lista El precio baja a lo largo del día UTC (entre un 25 % y un 47 % por debajo de lista) y el carril Low Tide es un 30 % más barato todavía para trabajos que pueden esperar.
- No guarda copia de tus datos Retención cero: Tokentide nunca guarda prompts ni respuestas, y cada clave tiene un modo de privacidad.
- Un gasto que controlas Crédito prepago desde 10 USD que no caduca, topes de gasto por clave y por cuenta, y las peticiones rechazadas nunca se cobran.
- Sin código nuevo que aprender Compatible con OpenAI: los mismos SDK, con otra URL base y otra clave.
- Responde cuando Tokentide no puede Suministro diario agotado (503), límites de uso (429), sin crédito o con tope de gasto (402), errores del servidor y tiempos agotados pasan al Gateway al instante.
- Muchos modelos con una sola clave Añade crédito o usa tus propias claves de proveedor, dentro del panel de Vercel que ya usas.
- Pagas solo cuando se usa Pago por uso: en un día normal atiende poco o nada.
- El precio más bajo siempre que Tokentide tiene capacidad, y una respuesta cada vez.
- Sin reintentos en Tokentide (
maxRetries: 0), así que un rechazo llega al respaldo en milisegundos; se respetaRetry-After. - Las llamadas se quedan en el servidor, con un límite de tokens en cada petición y el respaldo probado en dev antes de publicar.
Cifras de la documentación de Tokentide, comprobadas el 8 nov 2026. Los precios cambian cada día; consulta siempre el precio en vivo. Lección: añadir IA a tu app, con un respaldo · Cómo elegimos las herramientas y nuestras relaciones comerciales
Cómo se ve en tu proyecto
Tu agente usa las skills tokentide-api y ai-sdk para conectar ambos proveedores con su pareja de modelos, y tú pegas TOKENTIDE_API_KEY y AI_GATEWAY_API_KEY en .env.local y en Vercel (con claves de tope bajo para trabajar en tu equipo). Antes de fusionar, tu agente prueba el respaldo en una Definiciónvista previa (Preview)Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.Abrir en el glosario → apuntando el cliente de Tokentide a una dirección inexistente y comprobando que el Gateway responde sin fallos.
Copia para tu agente
Configura nuestra llamada a la IA en el servidor usando las skills tokentide-api y ai-sdk: Tokentide primero con maxRetries: 0, Vercel AI Gateway como respaldo, max_completion_tokens definido y registrando en el log solo el gasto y el proveedor, nunca los prompts ni las respuestas.
Comprobación rápida · 1 pregunta