GenAI API for Apple Shortcuts
Louis Brulé Naudet · コーディング
GenAI API for Apple Shortcuts は Cloudflare Workers で動く TypeScript 製 API で、Google の Gemini モデルを iPhone のショートカットに組み込み、1 日 1,500 リクエストまで無料で使える。
GenAI API for Apple Shortcuts について
What Is GenAI API for Apple Shortcuts
GenAI API for Apple Shortcuts は Cloudflare Workers で動くサーバーレス AI API で、Apple のショートカット App を Google の Gemini モデルにつなぐ。Cloudflare Workers に一度デプロイし、Google AI Studio のキーをシークレットとして保存すれば、あとはショートカットからテキストや画像を Gemini モデルに送って答えを受け取れる。プロジェクトは TypeScript と Hono フレームワークで書かれ、Apache 2.0 ライセンスで公開されている。
これが解くのは手間だ。ショートカット App には Web リクエストを送るアクションが標準で用意されているが、生成 AI 用のアクションはない。だからショートカットに AI のステップを足したい人は、まず配管を自分で組む必要があった。このリポジトリがその配管を引き受ける。認証、モデルのルーティング、そしてショートカットが求める形式を最初から話す completion エンドポイントが一つ入っている。
最大の制約は、ホスト型サービスがないことだ。自分で動かすので、立ち上げには Cloudflare アカウント、Google AI Studio のキー、そしてターミナルのコマンドがいくつか要る。Cloudflare Workers の無料枠は 1 日 10 万リクエストまでさばける。一方 Google AI Studio の無料枠は Gemini を 1 日 1,500 リクエストに制限するが、軽いモデルならその範囲内で費用はかからない。
Getting Started
- リポジトリを clone し、設定ファイル、とくに wrangler.jsonc を編集したうえで make init を実行して依存関係を入れる。
- wrangler secret put GOOGLE_AI_STUDIO_API_KEY コマンドで Google AI Studio のキーをシークレットとして保存し、続いて wrangler secret put BEARER_TOKEN でベアラートークンを追加する。
- make deploy で worker をデプロイする。すると /api/v1/completion で終わる Cloudflare Workers の URL が手に入る。
- その completion エンドポイントに POST リクエストを送るショートカットを作る。Authorization ヘッダーにベアラートークン、JSON の本文にメッセージを入れる。
- 短いプロンプトで試したら、返ってきた答えをショートカットの残りの処理につなぐ。たとえばテキストの要約や写真の説明に使う。
AIツール情報
GenAI API for Apple Shortcutsの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- ショートカットを使い込む人：日々の作業をすでに Apple ショートカット自動化でこなしている人なら、どのショートカットにも差し込める Gemini のステップが手に入る。一度デプロイする手間を惜しまないことが条件だ。この App の中で暮らすような人にとって、実用的な iPhone AI ショートカットの入手先になる。
- AI 機能を試す開発者：Gemini を土台に OpenAI 形式の completion エンドポイントがほしい個人開発者なら、このリポジトリを fork して、認証とルーティングを一から組む手間を省ける。
- プライバシーを気にする人：API は自分の Cloudflare アカウントで動き、リクエストは Google へ直接渡る。プロンプトを保持する第三者は、自分が選んだモデル提供元だけだ。
タスク
- スマホでテキストを要約する：リンクやメール、メモを completion エンドポイントに流し込むと、読んだり共有したりできる短い要約が返る。
- 写真を説明したり文字を読んだりする：API は画像を data URL で受け取れるので、ショートカットから写真を送り、何が写っているかを尋ねたり、文字を取り出したりできる。
- 返信を下書きする：メッセージのやり取りを Gemini に送ると、送信前に手直しできる返信案が返る。
- 繰り返しの文章作成を自動化する：テンプレートと数個の項目から、スマホを離れずに一つの段落を作り上げる。
シーン
- 音声中心のワークフロー：Siri に頼んでショートカットを起動し、有料のチャット App ではなくデプロイ済みの API 経由で答えを受け取る。打ち込むより話す方がいい人にとって扱いやすい iPhone AI ショートカットだ。
- サーバー予算なしで作る：ホビー開発者が Cloudflare の無料枠に worker をデプロイし、Google の 1 日あたりの無料枠内に収める。
- App のアイデアを試作する：開発者が App を worker の URL に向け、大きな作り込みに入る前に 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 で、日常的なプロンプトにはちょうどいい中間だ。
ベアラートークンによる保護
すべてのリクエストには、Cloudflare のシークレットとして設定したベアラートークンが要る。付けていないリクエストは失敗する。X-API-Key ヘッダーを送ってリクエストごとに提供元のキーを使うこともでき、worker を再デプロイせずにキーを差し替えられる。URL が漏れても、エンドポイントが開けっ放しの扉にはならない。
サーバーレスでのデプロイ
Cloudflare Worker として配布されるので、パッチを当てるサーバーも、温め続けるコンテナも、待機中のコストもない。デプロイは make deploy の一行で、更新も make update 一発だ。Cloudflare の無料枠は 1 日 10 万リクエストまでさばける。個人のショートカット運用には十分すぎる。
Apple ショートカットのために作られている
プロジェクトはショートカットの強化から始まったもので、README はショートカットで API を呼ぶ手順を扱った Apple 公式のガイドへ読者を導く。標準の「URL の内容を取得」アクションに乗るので、ショートカットは追加の App なしにリクエストを送り、返答を読める。AI のステップは、すでに使っている Apple の App の中に収まる。
メリットとデメリット
メリット
- Apache 2.0 でオープンソースだから、黒い箱を信じる代わりに一行ずつ読んで fork し、書き換えられる。
- Cloudflare Workers 上で動き、面倒を見るサーバーがなく、無料枠でかなり重い個人利用もまかなえる。
- OpenAI 形式の単一 completion エンドポイントがテキストと画像の両方を扱い、わずかな設定でショートカットに収まる。
- 速い Flash-Lite 系から能力の高い Gemini 2.5 Flash まで、リクエストごとにモデルを選べる。
- ベアラートークンと任意のリクエスト単位 API キーで、誰がエンドポイントを呼べるかを最低限管理できる。
デメリット
- ホスト型サービスがないので、始めるには Cloudflare アカウント、Google AI Studio のキー、そしてコマンドラインへの慣れが要る。
- リクエストの形式は API のスキーマに合わせる必要があり、画像の data URL が壊れていると、呼び出しは優雅に劣化せずただ失敗する。
- Google AI Studio の無料枠は Gemini を 1 日 1,500 リクエストに制限するので、重い自動化は上限に当たり、有料キーが必要になることがある。
- 自分で保守するので、依存関係の更新を追いかけ、Gemini モデルが変わったら再デプロイすることになる。
よくある質問
必要ない。worker は Cloudflare の無料枠で動き、Google AI Studio は 1 日 1,500 リクエストまでの無料の Gemini 枠を用意しているので、個人利用なら費用はかからない。料金が発生するのは、利用量がこの上限を超えるか、Cloudflare の有料 Workers プランがほしいときだけだ。
関連コンテンツ
GenAI API for Apple Shortcutsに関連するツール、スキル、記事を探す。
GenAI API for Apple Shortcutsの代替ツール
Forefront
Forefront · コーディングForefrontはオープンソースAIで構築するためのウェブプラットフォームだ。主要なオープンソース言語モデルを自分のデータで微調整し、性能を評価し、API経由で実行したり、エクスポートして自分でホストしたりできる。クローズドなプラットフォームの手軽さを求めつつ、モデルとデータの所有権にはこだわる開発者が対象だ。
Startkit
StartKit.AI · コーディングStartkitは、AI SaaSとAIラッパー製品を作るためのボイラープレートだ。面倒な部分をあらかじめ配線済みにしたAIスタートアップボイラープレートと考えればいい。認証、StripeとLemon Squeezyの決済、利用制限、トランザクションメール、そしてOpenAI、Anthropic、Groq、Llamaと通信するAI APIスターターキットが含まれる。リポジトリをクローンして価格を設定し、ユーザーが実際にお金を払う部分に取りかかれる。ReactとTailwind上のNext.jsで作られているため、ボイラープレートコードの多くはすでに見慣れたものだ。
Testim
Tricentis · コーディングTestimは、Web・モバイル・Salesforceアプリ向けにエンドツーエンドテストを構築して実行するAIテスト自動化プラットフォームだ。機械学習を頼りに、インターフェースが変わってもテストを安定させ、チームが壊れたセレクターの修正に費やす時間を減らす。今日から使い始められる自動テストツールとしては悪くない。ブラウザで操作を録画してテストを作り、より細かい制御が必要なときはJavaScriptを足す。忙しいQAチームにとって堅実な選択肢である。