GenAI API for Apple Shortcuts
Louis Brulé Naudet · 程式設計
GenAI API for Apple Shortcuts 是一套 TypeScript API，跑在 Cloudflare Workers 上，把 Google 的 Gemini 模型帶進你的 iPhone 捷徑，每天最多 1,500 次請求免費。
關於 GenAI API for Apple Shortcuts
What Is GenAI API for Apple Shortcuts
GenAI API for Apple Shortcuts 是一套無伺服器 AI API，把 Apple 的「捷徑」App 接到 Google 的 Gemini 模型。你只要在 Cloudflare Workers 部署一次，把 Google AI Studio 金鑰存成密鑰，之後捷徑就能把文字或圖片送給 Gemini 模型並取得回覆。專案以 TypeScript 搭配 Hono 框架撰寫，採 Apache 2.0 授權釋出。
它解決的是麻煩事。捷徑 App 內建傳送網頁請求的動作，卻沒有生成式 AI 的動作，想在捷徑裡加一段 AI，就得自己先把管線接好。這個專案就是幫你接好管線：身分驗證、模型路由，以及一個已經說好捷徑所需格式的 completion 端點。
最大的限制是沒有代管服務。你得自己跑，因此安裝要先有 Cloudflare 帳號、Google AI Studio 金鑰，還要會幾個終端機指令。Cloudflare Workers 免費方案每天可處理多達 100,000 次請求，而 Google AI Studio 免費方案把 Gemini 限制在每天 1,500 次請求，較輕量的模型在這上限內不收費。
Getting Started
- 複製專案並修改設定檔，主要是 wrangler.jsonc 檔，接著執行 make init 安裝相依套件。
- 用 wrangler secret put GOOGLE_AI_STUDIO_API_KEY 指令把你的 Google AI Studio 金鑰存成密鑰，再用 wrangler secret put BEARER_TOKEN 加上一組 bearer token。
- 用 make deploy 部署 worker，它會給你一個結尾為 /api/v1/completion 的 Cloudflare Workers 網址。
- 做一個捷徑，對該 completion 端點送出 POST 請求，在 Authorization 標頭帶上你的 bearer token，並在 JSON 內容放一則訊息。
- 用簡短的提示詞測試，再把回覆接進捷徑的其他部分，例如摘要文字或描述照片。
產品資訊
快速了解 GenAI API for Apple Shortcuts 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 捷徑重度使用者：平常就用 Apple 捷徑自動化打理一天大小事的人，多了一個能塞進任何捷徑的 Gemini 步驟，前提是願意做一次部署。對活在這個 App 裡的人來說，它是一個實用的 iPhone AI 捷徑來源。
- 測試 AI 功能的開發者：想用 Gemini 撐起一個 OpenAI 風格 completion 端點的獨立開發者，可以 fork 走，省下從零打造身分驗證與路由的功夫。
- 在意隱私的使用者：API 跑在你自己的 Cloudflare 帳號上，請求直接送到 Google，唯一留存你提示詞的第三方，就只有你選的模型供應商。
任務
- 在手機上摘要文字：把連結、信件或筆記丟進 completion 端點，取回一段可讀可分享的短摘要。
- 描述或讀取照片：由於 API 接受以 data URL 傳圖，捷徑可以送出照片，問模型畫面裡有什麼，或把文字抓出來。
- 草擬回覆：把一串訊息送給 Gemini，拿回一段建議回覆，送出前再自己修。
- 自動化重複書寫：把一個範本加上幾個欄位，變成完整段落，不必離開手機。
情境
- 語音優先的工作流：用 Siri 唸一句就啟動捷徑，助理透過部署好的 API 回答，不必開一個付費聊天 App。對寧願講話不想打字的人來說，這是好用的 iPhone AI 捷徑。
- 沒伺服器預算也能做：業餘玩家把 worker 部署在 Cloudflare 免費方案上，用量維持在 Google 的每日免費額度內。
- 驗證 App 點子：開發者把 App 指向 worker 網址，先看 Gemini 模型表現如何，再決定要不要做更大的東西。
主要功能
單一 completion 端點
整套 API 只開一條路由，POST /completion，接受 OpenAI 風格的 messages 陣列並回傳純文字。這個形狀讓你可以把它接到已經預期 OpenAI 格式的工具後面，不必重寫請求邏輯。文字回覆就是模型的 completion，沒有外層包裝要解析。
多模態輸入
請求可以在同一則訊息裡混搭文字與圖片。你把圖片以 data URL 附在文字提示詞旁送出去，就能做看圖答題、替圖片下標，或從照片裡抓文字。圖片必須是有效的 data URL，因此捷徑會先把檔案編碼再送出。
選擇 Gemini 模型
API 路由到 Google AI Studio，並讓你逐次請求挑模型。支援的陣容涵蓋 gemini-2.5-flash、gemini-2.5-flash-lite、gemini-2.0-flash 與 gemini-2.0-flash-lite，可依任務在速度與能力之間取捨。預設是 gemini-2.5-flash，是日常提示詞的穩妥中間值。
bearer token 安全把關
每次請求都要帶一組你設成 Cloudflare 密鑰的 bearer token，沒帶的請求一律失敗。你也可以送 X-API-Key 標頭，逐次請求使用供應商金鑰，這樣換金鑰不必重新部署 worker。網址若外流，端點也不至於變成任人進出的大門。
無伺服器部署
由於以 Cloudflare Worker 形式出貨，沒有伺服器要修補，沒有容器要保溫，待機也不花錢。部署就是一行 make deploy，更新則是一個 make update 之遙。Cloudflare 免費方案一天可吸收多達 100,000 次請求，遠高於個人捷徑設定的用量。
為 Apple 捷徑而生
專案一開始就是為了強化捷徑，README 也把你導向 Apple 官方在捷徑裡呼叫 API 的說明。它靠的是內建的「取得 URL 內容」動作，捷徑送出請求、讀取回覆都不必額外裝 App。整段 AI 步驟因此留在你本來就在用的 Apple App 裡。
優缺點
優點
- 以 Apache 2.0 開源釋出，每一行都能讀、能 fork、能改，不必信任黑盒子。
- 跑在 Cloudflare Workers 上，沒有伺服器要維護，免費方案足以應付吃重的個人使用。
- 單一 OpenAI 風格 completion 端點同時處理文字與圖片，設定不多就能接進捷徑。
- 可逐次請求挑模型，從快速的 Flash-Lite 系列到較強的 Gemini 2.5 Flash。
- bearer token 加上選用的逐請求 API 金鑰，讓你對誰能呼叫端點有基本控管。
缺點
- 沒有代管服務，起步需要 Cloudflare 帳號、Google AI Studio 金鑰，還要熟悉命令列。
- 請求格式必須對上 API 的規格，圖片 data URL 格式一錯，呼叫就直接失敗，不會自動降級。
- Google AI Studio 免費方案把 Gemini 限制在每天 1,500 次請求，重度自動化會撞到上限，得改用付費金鑰。
- 得自己維護，這意味著要盯著相依套件更新，Gemini 模型一改就得重新部署。
常見問題
不用。worker 跑在 Cloudflare 免費方案上，Google AI Studio 也提供每天最多 1,500 次請求的免費 Gemini 額度，個人設定可以零成本運作。只有用量超過這些上限，或你想要 Cloudflare 的付費 Workers 方案時才需要付費。
相關內容
探索與 GenAI API for Apple Shortcuts 相關的工具、技能與文章。
GenAI API for Apple Shortcuts 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改，看著預覽確認結果，再以 Pull Request 交回工程團隊。
Google EmbeddingGemma 2
Google DeepMind · 寫作 · 圖片 · 程式設計Google EmbeddingGemma 2 是 7.4 億參數的開源模型，能把文字、程式碼、圖片、音訊與影片畫面轉成同一個 768 維空間裡的向量，在手機與筆電上就能執行。
GitGlow
GitGlow · 程式設計 · 生產力GitGlow 是桌面版 Git 用戶端，把你自己的程式碼與 AI 代理程式的變更集中在同一份審查裡，讓你在交付前看清楚機器上究竟要送出什麼。