GenAI API for Apple Shortcuts
Louis Brulé Naudet · Programación
GenAI API for Apple Shortcuts es una API en TypeScript que corre en Cloudflare Workers y mete los modelos Gemini de Google en tus atajos del iPhone, gratis hasta 1.500 peticiones al día.
Acerca de GenAI API for Apple Shortcuts
What Is GenAI API for Apple Shortcuts
GenAI API for Apple Shortcuts es una API de IA sin servidor que conecta la app Atajos de Apple con los modelos Gemini de Google. La despliegas una vez en Cloudflare Workers, guardas tu clave de Google AI Studio como secreto y, a partir de ahí, tus atajos pueden mandar texto o imágenes a un modelo Gemini y recibir una respuesta. El proyecto está escrito en TypeScript con el framework Hono y se publica bajo licencia Apache 2.0.
Lo que resuelve es la fricción. La app Atajos tiene una acción nativa para hacer peticiones web, pero ninguna para IA generativa, así que quien quería un paso de IA en un atajo tenía que montar la fontanería por su cuenta. Este repositorio se encarga de esa fontanería: la autenticación, el enrutado de modelos y un único endpoint de completado que ya habla el formato que tu atajo necesita.
La limitación más grande es que no hay servicio alojado. Lo ejecutas tú, así que la puesta en marcha pide una cuenta de Cloudflare, una clave de Google AI Studio y unos cuantos comandos en la terminal. El plan gratuito de Cloudflare Workers cubre hasta 100.000 peticiones al día, mientras que el plan gratuito de Google AI Studio limita Gemini a 1.500 peticiones diarias, y los modelos más ligeros no cuestan nada dentro de ese tope.
Getting Started
- Clona el repositorio y edita los archivos de configuración, sobre todo el archivo wrangler.jsonc, y luego ejecuta make init para instalar las dependencias.
- Guarda tu clave de API de Google AI Studio como secreto con el comando wrangler secret put GOOGLE_AI_STUDIO_API_KEY y añade después un token bearer con wrangler secret put BEARER_TOKEN.
- Despliega el worker con make deploy, que te devuelve una URL de Cloudflare Workers terminada en /api/v1/completion.
- Crea un atajo que envíe una petición POST a ese endpoint de completado, con tu token bearer en la cabecera Authorization y un mensaje en el cuerpo JSON.
- Prueba con un prompt corto y luego engancha la respuesta al resto de tu atajo, por ejemplo para resumir un texto o describir una foto.
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de GenAI API for Apple Shortcuts.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Usuarios avanzados de Atajos
- Desarrolladores que prueban funciones de IA
- Usuarios preocupados por la privacidad
Tareas
- Resumir texto en el móvil
- Describir o leer fotos
- Redactar respuestas
- Automatizar escritura repetitiva
Casos de uso
- Flujos donde manda la voz
- Crear sin presupuesto de servidor
- Prototipar una idea de app
Funciones clave
Un único endpoint de completado
Toda la API se reduce a una ruta, POST /completion, que acepta un array de mensajes estilo OpenAI y devuelve texto plano. Esa forma significa que puedes colocarla detrás de herramientas que ya esperan el formato de OpenAI sin reescribir la lógica de la petición. Las respuestas de texto vuelven como el completado del modelo, sin envoltorio que parsear.
Entrada multimodal
Las peticiones pueden mezclar texto e imágenes en un mismo mensaje. Envías una imagen como data URL junto a un prompt de texto, lo que abre la puerta a responder preguntas sobre una imagen, ponerle pies de foto o sacar el texto de una foto. La imagen tiene que ser un data URL válido, así que tu atajo codifica el archivo antes de enviarlo.
Elección de modelo Gemini
La API enruta a Google AI Studio y te deja escoger el modelo en cada petición. La lista disponible cubre gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.0-flash y gemini-2.0-flash-lite, así que cambias velocidad por capacidad según la tarea. El valor por defecto es gemini-2.5-flash, un punto medio sólido para los prompts del día a día.
Seguridad con token bearer
Cada petición necesita un token bearer que guardas como secreto en Cloudflare, y las que no lo llevan fallan. También puedes mandar una cabecera X-API-Key para usar una clave de proveedor por petición, lo que te deja cambiar de clave sin volver a desplegar el worker. Así el endpoint no queda como una puerta abierta si se filtra la URL.
Despliegue sin servidor
Como se distribuye como Cloudflare Worker, no hay servidor que parchear, ni contenedor que mantener caliente, ni coste en reposo. El despliegue es un único comando make deploy y las actualizaciones están a un make update. El plan gratuito de Cloudflare absorbe hasta 100.000 peticiones al día, bastante por encima de lo que usa un atajo personal.
Pensado para Atajos de Apple
El proyecto nació como refuerzo para atajos y el README te remite a la guía de Apple para hacer llamadas API en Atajos. Se apoya en la acción nativa Obtener contenido de la URL, así que tu atajo envía la petición y lee la respuesta sin app extra. Eso mantiene todo el paso de IA dentro de las apps de Apple que ya usas.
Ventajas y desventajas
Ventajas
- Código abierto bajo Apache 2.0, así que puedes leer, forkear y cambiar cada línea en vez de fiarte de una caja negra.
- Corre en Cloudflare Workers sin servidor que mantener y con un plan gratuito que cubre un uso personal intenso.
- Un único endpoint de completado estilo OpenAI maneja texto e imágenes, lo que encaja en los atajos con una configuración mínima.
- Elección de modelo en cada petición, desde los rápidos Flash-Lite hasta el más capaz Gemini 2.5 Flash.
- El token bearer y la clave de API opcional por petición te dan un control básico sobre quién puede llamar al endpoint.
Desventajas
- Al no haber servicio alojado, necesitas una cuenta de Cloudflare, una clave de Google AI Studio y soltura con la línea de comandos para arrancar.
- El formato de la petición tiene que cuadrar con el esquema de la API, y un data URL de imagen mal formado hace fallar la llamada en vez de degradarse con elegancia.
- El plan gratuito de Google AI Studio limita Gemini a 1.500 peticiones al día, así que una automatización intensa puede tocar techo y necesitar una clave de pago.
- Lo mantienes tú, lo que implica estar pendiente de las actualizaciones de dependencias y volver a desplegar cuando cambien los modelos de Gemini.
Preguntas frecuentes
No. El worker corre en el plan gratuito de Cloudflare y Google AI Studio ofrece un cupo gratuito de Gemini de hasta 1.500 peticiones al día, así que una instalación personal puede funcionar sin coste. Solo pagas si tu volumen pasa esos límites o si quieres el plan de pago de Workers en Cloudflare.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con GenAI API for Apple Shortcuts.
Alternativas a GenAI API for Apple Shortcuts
Base Code
Base44 (Wix) · Programación · ProductividadBase Code es un entorno de desarrollo en la nube compartido de Base44. El equipo describe cambios sobre un repositorio de GitHub en el chat, los ve en una vista previa y los envía como pull requests.
Google EmbeddingGemma 2
Google DeepMind · Escritura · Imagen · ProgramaciónGoogle EmbeddingGemma 2 es un modelo abierto de 740 millones de parámetros que convierte texto, código, imágenes, audio y fotogramas de vídeo en vectores de un mismo espacio de 768 dimensiones, y funciona en móviles y portátiles.
GitGlow
GitGlow · Programación · ProductividadGitGlow es un cliente Git de escritorio que reúne tu código y los cambios de tus agentes de IA en una sola revisión, para que sepas qué va a salir de tu máquina antes de publicarlo.