Apple 단축어 밖에서도 되나?

된다. 단축어에 AI를 더하려고 시작했지만, README는 HTTP 요청을 보낼 수 있는 어떤 애플리케이션도 강화할 수 있다고 적는다. worker URL에 닿아 베어러 토큰을 넘길 수 있는 앱이나 스크립트, 서비스면 무엇이든 쓸 수 있다.

API 키는 어떻게 지키나?

Google 키와 베어러 토큰을 wrangler secret put으로 Cloudflare 시크릿에 저장하므로 코드나 설정 파일에 남지 않는다. worker는 실행 시점에 읽고, 베어러 토큰이 없는 요청은 거부된다.

텍스트뿐 아니라 이미지도 읽나?

읽는다. 요청은 텍스트와 함께 이미지를 data URL로 받으므로, 사진에 설명 달기, 사진에 대한 질문 답하기, 인쇄된 글자 뽑아내기 같은 작업이 가능하다. 이미지는 유효한 data URL이어야 하므로 단축어 쪽에서 파일을 먼저 인코딩한다.

GenAI API for Apple Shortcuts는 무료이고 오픈소스인가?

직접 호스팅하는 건 무료이며 Apache 2.0 라이선스로 공개돼 TypeScript 코드를 살펴보고 고칠 수 있다. 상시 비용은 Cloudflare와 Google의 무료 등급을 넘길 때 그들이 부과하는 몫뿐이다.

배포 전에 무엇이 필요한가?

Workers를 켠 Cloudflare 계정, Google AI Studio API 키, 그리고 Wrangler CLI를 설치한 Node.js 환경이 필요하다. 공개한 뒤 엔드포인트를 잠글 직접 정한 베어러 토큰도 있어야 한다.

GenAI API for Apple Shortcuts

Q: 어떤 Gemini 모델을 지원하나?

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가 기본이 된다.

Louis Brulé Naudet · 코딩

GenAI API for Apple Shortcuts는 Cloudflare Workers에서 돌아가는 TypeScript API로, Google Gemini 모델을 iPhone 단축어에 넣어 주며 하루 1,500건까지 무료로 쓸 수 있다.

도구 방문

GenAI API for Apple Shortcuts 소개

What Is GenAI API for Apple Shortcuts

GenAI API for Apple Shortcuts는 Cloudflare Workers에서 돌아가는 서버리스 AI API로, Apple 단축어 앱을 Google Gemini 모델에 연결한다. Cloudflare Workers에 한 번 배포하고 Google AI Studio 키를 시크릿으로 저장하면, 이후 단축어에서 텍스트나 이미지를 Gemini 모델에 보내 답을 받을 수 있다. 프로젝트는 TypeScript와 Hono 프레임워크로 작성됐고 Apache 2.0 라이선스로 공개됐다.

이 API가 해결하는 건 번거로움이다. 단축어 앱에는 웹 요청을 보내는 기본 동작이 있지만 생성형 AI용 동작은 없다. 그래서 단축어에 AI 단계를 넣으려던 사람은 배관부터 직접 깔아야 했다. 이 저장소가 그 배관을 맡는다. 인증, 모델 라우팅, 그리고 단축어가 필요로 하는 형식을 이미 말하는 완결성 엔드포인트 하나다.

가장 큰 제약은 호스팅 서비스가 없다는 점이다. 직접 돌려야 하므로 설정에 Cloudflare 계정, Google AI Studio 키, 터미널 명령 몇 줄이 필요하다. Cloudflaare 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으로 베어러 토큰을 추가한다.
make deploy로 worker를 배포하면 /api/v1/completion으로 끝나는 Cloudflare Workers URL을 받는다.
그 완결성 엔드포인트에 POST 요청을 보내는 단축어를 만든다. Authorization 헤더에 베어러 토큰을 넣고 JSON 본문에 메시지를 담는다.
짧은 프롬프트로 시험한 뒤, 돌아온 답을 단축어의 나머지 동작에 연결한다. 예컨대 텍스트를 요약하거나 사진을 설명하는 식이다.

제품 정보

GenAI API for Apple Shortcuts의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.

무료 플랜예

유료 플랜$0 - $25/mo (Cloudflare Workers paid tier; Google Gemini has paid tiers)

플랫폼Cloudflare Workers, iOS Shortcuts, macOS Shortcuts, iPadOS Shortcuts

개발사Louis Brulé Naudet

카테고리코딩

출시일Aug 2025

최근 업데이트Apr 2026

웹사이트 방문 수649.3M

웹사이트 글로벌 순위50

API 제공 여부예

주요 기능

단일 완결성 엔드포인트

API 전체가 POST /completion 한 경로로 모인다. OpenAI 형식 messages 배열을 받아 순수 텍스트를 돌려준다. 이 형태 덕분에 OpenAI 형식을 이미 전제하는 도구 뒤에 그대로 둘 수 있다. 요청 로직을 다시 짤 필요가 없다. 텍스트 응답은 모델의 완결성 그대로 오고, 겉을 감싼 포장을 해석할 일도 없다.

멀티모달 입력

요청은 한 메시지 안에서 텍스트와 이미지를 섞을 수 있다. 이미지를 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 무료 등급은 하루 최대 100,000건을 감당한다. 개인 단축어 운영에는 차고 넘친다.

Apple 단축어를 위해 만들어짐

이 프로젝트는 단축어 강화에서 시작됐고, README는 단축어에서 API를 호출하는 Apple 공식 안내로 독자를 보낸다. 기본 동작인 'URL 콘텐츠 가져오기'에 기대므로, 단축어는 별도 앱 없이 요청을 보내고 응답을 읽는다. AI 단계가 이미 쓰던 Apple 앱 안에 머문다.

장단점

장점

Apache 2.0 오픈소스라 블랙박스를 믿는 대신 한 줄 한 줄 읽고 포크해 고칠 수 있다.
Cloudflare Workers에서 돌아 관리할 서버가 없고, 무료 등급으로 상당히 무거운 개인 사용도 감당한다.
OpenAI 형식의 단일 완결성 엔드포인트가 텍스트와 이미지를 함께 처리해, 설정을 조금만 하고 단축어에 붙일 수 있다.
빠른 Flash-Lite 계열부터 성능이 높은 Gemini 2.5 Flash까지 요청마다 모델을 고른다.
베어러 토큰과 선택적 요청별 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 등급을 원할 때만 발생한다.