GenAI API for Apple Shortcuts
Louis Brulé Naudet · Coding
GenAI API for Apple Shortcuts ist eine TypeScript-API, die auf Cloudflare Workers läuft und Googles Gemini-Modelle in deine iPhone-Kurzbefehle bringt, kostenlos bis zu 1.500 Anfragen pro Tag.
Über GenAI API for Apple Shortcuts
What Is GenAI API for Apple Shortcuts
GenAI API for Apple Shortcuts ist eine serverlose KI-API, die Apples Kurzbefehle-App mit Googles Gemini-Modellen verbindet. Du stellst sie einmal auf Cloudflare Workers bereit, legst deinen Google-AI-Studio-Schlüssel als Secret ab und ab dann können deine Kurzbefehle Text oder Bilder an ein Gemini-Modell schicken und eine Antwort erhalten. Das Projekt ist in TypeScript mit dem Hono-Framework geschrieben und steht unter der Apache-2.0-Lizenz.
Was es löst, ist Reibung. Die Kurzbefehle-App hat eine native Aktion für Webanfragen, aber keine für generative KI, wer also einen KI-Schritt in einem Kurzbefehl wollte, musste erst die Verkabelung bauen. Dieses Repository kümmert sich um die Verkabelung: die Authentifizierung, das Routing der Modelle und einen einzigen Completion-Endpunkt, der schon das Format spricht, das dein Kurzbefehl braucht.
Die größte Einschränkung ist, dass es keinen gehosteten Dienst gibt. Du betreibst ihn selbst, also verlangt das Setup ein Cloudflare-Konto, einen Google-AI-Studio-Schlüssel und ein paar Terminal-Befehle. Der kostenlose Tarif von Cloudflare Workers deckt bis zu 100.000 Anfragen pro Tag ab, während Google AI Studio Gemini im kostenlosen Tarif auf 1.500 Anfragen täglich begrenzt, und die leichteren Modelle kosten innerhalb dieses Limits nichts.
Getting Started
- Klone das Repository und passe die Konfigurationsdateien an, vor allem die Datei wrangler.jsonc, und führe dann make init aus, um die Abhängigkeiten zu installieren.
- Lege deinen Google-AI-Studio-Schlüssel mit dem Befehl wrangler secret put GOOGLE_AI_STUDIO_API_KEY als Secret ab und füge danach ein Bearer-Token mit wrangler secret put BEARER_TOKEN hinzu.
- Stelle den Worker mit make deploy bereit, was dir eine Cloudflare-Workers-URL liefert, die auf /api/v1/completion endet.
- Baue einen Kurzbefehl, der eine POST-Anfrage an diesen Completion-Endpunkt schickt, mit deinem Bearer-Token im Authorization-Header und einer Nachricht im JSON-Body.
- Teste mit einem kurzen Prompt und verdrahte die Antwort dann mit dem Rest deines Kurzbefehls, etwa um Text zusammenzufassen oder ein Foto zu beschreiben.
Produktinformationen
Ein kurzer Überblick über Preise, unterstützte Plattformen und die Leistung von GenAI API for Apple Shortcuts.
Am besten für
Die Nutzer, Aufgaben und Szenarien, für die dieses Tool am besten passt.
Nutzer
- Kurzbefehle-Power-User
- Entwickler, die KI-Funktionen testen
- Datenschutzbewusste Nutzer
Aufgaben
- Text auf dem Handy zusammenfassen
- Fotos beschreiben oder lesen
- Antworten entwerfen
- Wiederkehrendes Schreiben automatisieren
Szenarien
- Sprachgesteuerte Abläufe
- Bauen ohne Serverbudget
- Eine App-Idee prototypen
Wichtigste Funktionen
Ein einziger Completion-Endpunkt
Die ganze API läuft auf eine Route hinaus, POST /completion, die ein Nachrichten-Array im OpenAI-Stil annimmt und reinen Text zurückgibt. Diese Form bedeutet, dass du sie hinter Werkzeuge legen kannst, die das OpenAI-Format schon erwarten, ohne die Anfragelogik umzuschreiben. Textantworten kommen als Completion des Modells zurück, ohne Verpackung zum Auslesen.
Multimodale Eingabe
Anfragen können Text und Bilder in einer Nachricht mischen. Du schickst ein Bild als Data-URL neben einem Text-Prompt, was Fragen zu einem Bild, Bildunterschriften und das Herausziehen von Text aus einem Foto ermöglicht. Das Bild muss eine gültige Data-URL sein, also kodiert dein Kurzbefehl die Datei vor dem Senden.
Auswahl des Gemini-Modells
Die API routet zu Google AI Studio und lässt dich das Modell pro Anfrage wählen. Die unterstützte Auswahl umfasst gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.0-flash und gemini-2.0-flash-lite, du tauschst also je nach Aufgabe Geschwindigkeit gegen Leistung. Standard ist gemini-2.5-flash, ein solider Mittelweg für alltägliche Prompts.
Sicherheit per Bearer-Token
Jede Anfrage braucht ein Bearer-Token, das du als Cloudflare-Secret setzt, und Anfragen ohne es scheitern. Du kannst außerdem einen X-API-Key-Header senden, um pro Anfrage einen Anbieterschlüssel zu nutzen, was dir erlaubt, Schlüssel zu wechseln, ohne den Worker neu bereitzustellen. So bleibt der Endpunkt keine offene Tür, falls die URL durchsickert.
Serverloses Deployment
Weil er als Cloudflare Worker ausgeliefert wird, gibt es keinen Server zu patchen, keinen Container warm zu halten und keine Leerlaufkosten. Das Deployment ist ein einziger make deploy-Befehl, und Updates sind ein make update entfernt. Der kostenlose Tarif von Cloudflare verkraftet bis zu 100.000 Anfragen pro Tag, weit über dem, was ein persönliches Kurzbefehle-Setup verbraucht.
Gebaut für Apples Kurzbefehle
Das Projekt begann als Verstärkung für Kurzbefehle, und das README verweist auf Apples eigene Anleitung für API-Aufrufe in Kurzbefehlen. Es stützt sich auf die native Aktion Inhalte der URL abrufen, also schickt dein Kurzbefehl die Anfrage und liest die Antwort ohne zusätzliche App. So bleibt der ganze KI-Schritt in den Apple-Apps, die du schon nutzt.
Vor- und Nachteile
Vorteile
- Open Source unter Apache 2.0, du kannst also jede Zeile lesen, forken und ändern, statt einer Blackbox zu vertrauen.
- Läuft auf Cloudflare Workers ohne Server zum Warten und mit einem kostenlosen Tarif, der intensiven persönlichen Gebrauch abdeckt.
- Ein einziger Completion-Endpunkt im OpenAI-Stil erledigt Text und Bilder, was mit minimaler Einrichtung in Kurzbefehle passt.
- Modellwahl pro Anfrage, von den schnellen Flash-Lite-Modellen bis zum stärkeren Gemini 2.5 Flash.
- Bearer-Token und optionaler API-Schlüssel pro Anfrage geben dir grundlegende Kontrolle darüber, wer den Endpunkt aufrufen darf.
Nachteile
- Ohne gehosteten Dienst brauchst du ein Cloudflare-Konto, einen Google-AI-Studio-Schlüssel und Sicherheit auf der Kommandozeile, um loszulegen.
- Das Anfrageformat muss zum Schema der API passen, und eine fehlerhafte Bild-Data-URL lässt den Aufruf scheitern, statt sich sauber zu verhalten.
- Der kostenlose Tarif von Google AI Studio begrenzt Gemini auf 1.500 Anfragen pro Tag, also kann eine starke Automatisierung an die Grenze stoßen und einen bezahlten Schlüssel nötig machen.
- Du wartest es selbst, was heißt, auf Abhängigkeits-Updates zu achten und neu bereitzustellen, wenn die Gemini-Modelle sich ändern.
Häufige Fragen
Nein. Der Worker läuft im kostenlosen Tarif von Cloudflare, und Google AI Studio bietet ein kostenloses Gemini-Kontingent von bis zu 1.500 Anfragen pro Tag, also läuft ein persönliches Setup ohne Kosten. Du zahlst nur, wenn dein Volumen diese Grenzen übersteigt oder du Cloudflares bezahlten Workers-Tarif willst.
Ähnliche Inhalte
Entdecke passende Tools, Skills und Artikel zu GenAI API for Apple Shortcuts.
Alternativen zu GenAI API for Apple Shortcuts
Udon
Udon · Coding · ProduktivitätUdon macht aus einem Apple-Silicon-Mac einen Heimserver, den Sie im Browser steuern, mit Containern, Dateifreigaben und einem optionalen KI-Systemadministrator.
offstage
offstage cloud · Coding · Produktivitätoffstage gibt KI-Agenten und CI-Jobs einen echten Mac: ein frisches macOS-27-Konto auf Apple Silicon, per API gesteuert und sekundengenau abgerechnet.
BotBus
Chengdu Tuyang Tusen Technology Co., Ltd. · Coding · ProduktivitätMit BotBus lassen sich KI-Agenten vom Smartphone steuern, auch wenn der Rechner im Büro steht: Befehle freigeben, Aufgaben starten, Ergebnisse lesen.