GenAI API for Apple Shortcuts
Louis Brulé Naudet · Programmation
GenAI API for Apple Shortcuts est une API en TypeScript qui tourne sur Cloudflare Workers et place les modèles Gemini de Google dans vos raccourcis iPhone, gratuitement jusqu'à 1 500 requêtes par jour.
À propos de GenAI API for Apple Shortcuts
What Is GenAI API for Apple Shortcuts
GenAI API for Apple Shortcuts est une API IA sans serveur qui relie l'app Raccourcis d'Apple aux modèles Gemini de Google. Vous la déployez une fois sur Cloudflare Workers, vous rangez votre clé Google AI Studio comme secret et, à partir de là, vos raccourcis peuvent envoyer du texte ou des images à un modèle Gemini et recevoir une réponse. Le projet est écrit en TypeScript avec le framework Hono et publié sous licence Apache 2.0.
Ce qu'il règle, c'est la friction. L'app Raccourcis possède une action native pour les requêtes web, mais aucune pour l'IA générative, si bien que quiconque voulait une étape d'IA dans un raccourci devait d'abord monter toute la tuyauterie. Ce dépôt s'occupe de cette tuyauterie : l'authentification, le routage des modèles et un unique point de terminaison de complétion qui parle déjà le format dont votre raccourci a besoin.
La plus grosse limite, c'est l'absence de service hébergé. Vous le faites tourner vous-même, donc la mise en place demande un compte Cloudflare, une clé Google AI Studio et quelques commandes dans le terminal. L'offre gratuite de Cloudflare Workers couvre jusqu'à 100 000 requêtes par jour, tandis que celle de Google AI Studio plafonne Gemini à 1 500 requêtes quotidiennes, et les modèles plus légers ne coûtent rien dans cette limite.
Getting Started
- Clonez le dépôt et modifiez les fichiers de configuration, surtout le fichier wrangler.jsonc, puis lancez make init pour installer les dépendances.
- Rangez votre clé API Google AI Studio comme secret avec la commande wrangler secret put GOOGLE_AI_STUDIO_API_KEY, puis ajoutez un jeton bearer avec wrangler secret put BEARER_TOKEN.
- Déployez le worker avec make deploy, qui vous renvoie une URL Cloudflare Workers terminée par /api/v1/completion.
- Créez un raccourci qui envoie une requête POST vers ce point de terminaison de complétion, avec votre jeton bearer dans l'en-tête Authorization et un message dans le corps JSON.
- Testez avec un prompt court, puis branchez la réponse sur le reste de votre raccourci, par exemple pour résumer un texte ou décrire une photo.
Informations sur le produit
Aperçu des tarifs, des plateformes compatibles et des performances de GenAI API for Apple Shortcuts.
Idéal pour
Les utilisateurs, tâches et cas d'usage où cet outil convient le mieux.
Utilisateurs
- Utilisateurs avancés des Raccourcis
- Développeurs qui testent des fonctions d'IA
- Utilisateurs soucieux de la vie privée
Tâches
- Résumer un texte sur le téléphone
- Décrire ou lire des photos
- Rédiger des réponses
- Automatiser une écriture répétitive
Cas d'usage
- Flux pilotés à la voix
- Créer sans budget serveur
- Prototyper une idée d'app
Fonctionnalités clés
Un unique point de terminaison de complétion
Toute l'API se résume à une route, POST /completion, qui accepte un tableau de messages au format OpenAI et renvoie du texte brut. Cette forme vous permet de la placer derrière des outils qui attendent déjà le format OpenAI sans réécrire la logique de requête. Les réponses texte reviennent comme la complétion du modèle, sans enveloppe à analyser.
Entrée multimodale
Les requêtes peuvent mêler texte et images dans un même message. Vous envoyez une image en data URL à côté d'un prompt texte, ce qui ouvre la voie aux questions sur une image, aux légendes et à l'extraction de texte sur une photo. L'image doit être un data URL valide, donc votre raccourci encode le fichier avant l'envoi.
Choix du modèle Gemini
L'API route vers Google AI Studio et vous laisse choisir le modèle à chaque requête. La gamme prise en charge couvre gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.0-flash et gemini-2.0-flash-lite, donc vous arbitrez entre vitesse et capacité selon la tâche. La valeur par défaut est gemini-2.5-flash, un bon compromis pour les prompts du quotidien.
Sécurité par jeton bearer
Chaque requête exige un jeton bearer que vous définissez comme secret Cloudflare, et celles qui n'en ont pas échouent. Vous pouvez aussi envoyer un en-tête X-API-Key pour utiliser une clé de fournisseur par requête, ce qui permet de changer de clé sans redéployer le worker. L'endpoint n'est donc pas une porte ouverte si l'URL fuite.
Déploiement sans serveur
Comme il est livré en Cloudflare Worker, il n'y a pas de serveur à patcher, pas de conteneur à garder chaud et aucun coût à l'arrêt. Le déploiement tient en une commande make deploy et les mises à jour sont à un make update. L'offre gratuite de Cloudflare absorbe jusqu'à 100 000 requêtes par jour, bien au-delà de ce que consomme un raccourci personnel.
Conçu pour les Raccourcis d'Apple
Le projet est né comme renfort pour les raccourcis et le README vous renvoie au guide d'Apple pour passer des appels API dans Raccourcis. Il s'appuie sur l'action native Obtenir le contenu de l'URL, donc votre raccourci envoie la requête et lit la réponse sans app supplémentaire. L'étape d'IA reste ainsi dans les apps Apple que vous utilisez déjà.
Avantages et inconvénients
Avantages
- Open source sous Apache 2.0, donc vous pouvez lire, forker et modifier chaque ligne au lieu de faire confiance à une boîte noire.
- Tourne sur Cloudflare Workers sans serveur à maintenir et avec une offre gratuite qui couvre un usage personnel intensif.
- Un unique point de terminaison de complétion au format OpenAI gère texte et images, ce qui s'intègre aux raccourcis avec une configuration minimale.
- Choix du modèle à chaque requête, des rapides Flash-Lite au plus capable Gemini 2.5 Flash.
- Le jeton bearer et la clé API optionnelle par requête donnent un contrôle de base sur qui peut appeler l'endpoint.
Inconvénients
- Sans service hébergé, il faut un compte Cloudflare, une clé Google AI Studio et de l'aisance avec la ligne de commande pour démarrer.
- Le format de requête doit correspondre au schéma de l'API, et un data URL d'image mal formé fait échouer l'appel au lieu de se dégrader proprement.
- L'offre gratuite de Google AI Studio plafonne Gemini à 1 500 requêtes par jour, donc une automatisation intensive peut buter sur la limite et exiger une clé payante.
- Vous assurez la maintenance vous-même, ce qui veut dire surveiller les mises à jour de dépendances et redéployer quand les modèles Gemini changent.
Questions fréquentes
Non. Le worker tourne sur l'offre gratuite de Cloudflare et Google AI Studio offre un quota Gemini gratuit allant jusqu'à 1 500 requêtes par jour, donc une installation personnelle tourne sans frais. Vous payez seulement si votre volume dépasse ces limites ou si vous voulez l'offre payante Workers de Cloudflare.
Contenus associés
Découvrez des outils, des compétences et des articles liés à GenAI API for Apple Shortcuts.
Alternatives à GenAI API for Apple Shortcuts
Base Code
Base44 (Wix) · Programmation · ProductivitéBase Code est un environnement de développement cloud partagé signé Base44. Votre équipe décrit des modifications sur un dépôt GitHub dans le chat, les vérifie en aperçu et les renvoie sous forme de pull requests.
Google EmbeddingGemma 2
Google DeepMind · Rédaction · Image · ProgrammationGoogle EmbeddingGemma 2 est un modèle ouvert de 740 millions de paramètres qui transforme texte, code, images, audio et images vidéo en vecteurs d'un même espace de 768 dimensions, sur un téléphone ou un ordinateur portable.
GitGlow
GitGlow · Programmation · ProductivitéGitGlow est un client Git de bureau qui place votre code et les modifications de vos agents IA dans une même revue, pour savoir ce qui quitte votre machine avant de livrer.