GenAI API for Apple Shortcuts
Louis Brulé Naudet · Programação
O GenAI API for Apple Shortcuts é uma API em TypeScript que roda em Cloudflare Workers e coloca os modelos Gemini do Google nos seus atalhos do iPhone, de graça até 1.500 requisições por dia.
Sobre GenAI API for Apple Shortcuts
What Is GenAI API for Apple Shortcuts
O GenAI API for Apple Shortcuts é uma API de IA sem servidor que liga o app Atalhos da Apple aos modelos Gemini do Google. Você faz o deploy uma vez no Cloudflare Workers, guarda a sua chave do Google AI Studio como segredo e, a partir daí, seus atalhos podem enviar texto ou imagens a um modelo Gemini e receber uma resposta. O projeto é escrito em TypeScript com o framework Hono e é publicado sob a licença Apache 2.0.
O que ele resolve é o atrito. O app Atalhos tem uma ação nativa para requisições web, mas nenhuma para IA generativa, então quem quisesse um passo de IA em um atalho tinha de montar toda a encanação antes. Este repositório cuida dessa encanação: a autenticação, o roteamento de modelos e um único endpoint de conclusão que já fala o formato que o seu atalho precisa.
A maior limitação é que não existe serviço hospedado. Você roda por conta própria, então a configuração pede uma conta na Cloudflare, uma chave do Google AI Studio e alguns comandos no terminal. O plano gratuito do Cloudflare Workers cobre até 100.000 requisições por dia, enquanto o plano gratuito do Google AI Studio limita o Gemini a 1.500 requisições diárias, e os modelos mais leves não custam nada dentro desse teto.
Getting Started
- Clone o repositório e edite os arquivos de configuração, principalmente o arquivo wrangler.jsonc, e depois rode make init para instalar as dependências.
- Guarde a sua chave de API do Google AI Studio como segredo com o comando wrangler secret put GOOGLE_AI_STUDIO_API_KEY e adicione um token bearer com wrangler secret put BEARER_TOKEN.
- Faça o deploy do worker com make deploy, que devolve uma URL do Cloudflare Workers terminada em /api/v1/completion.
- Monte um atalho que envie uma requisição POST para esse endpoint de conclusão, com o seu token bearer no cabeçalho Authorization e uma mensagem no corpo JSON.
- Teste com um prompt curto e depois encaixe a resposta no restante do atalho, por exemplo para resumir um texto ou descrever uma foto.
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de GenAI API for Apple Shortcuts.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Usuários avançados de Atalhos
- Desenvolvedores testando recursos de IA
- Usuários atentos à privacidade
Tarefas
- Resumir texto no celular
- Descrever ou ler fotos
- Redigir respostas
- Automatizar escrita repetitiva
Cenários
- Fluxos comandados por voz
- Criar sem orçamento de servidor
- Prototipar uma ideia de app
Principais recursos
Um único endpoint de conclusão
Toda a API se resume a uma rota, POST /completion, que aceita um array de mensagens no estilo OpenAI e devolve texto puro. Esse formato significa que você pode colocá-la atrás de ferramentas que já esperam o padrão da OpenAI sem reescrever a lógica da requisição. As respostas de texto voltam como a conclusão do modelo, sem invólucro para processar.
Entrada multimodal
As requisições podem misturar texto e imagens em uma mesma mensagem. Você envia uma imagem como data URL junto de um prompt de texto, o que abre caminho para responder perguntas sobre uma imagem, legendar fotos ou extrair o texto de uma foto. A imagem precisa ser um data URL válido, então o seu atalho codifica o arquivo antes de enviar.
Escolha de modelo Gemini
A API roteia para o Google AI Studio e deixa você escolher o modelo em cada requisição. A lista disponível cobre gemini-2.5-flash, gemini-2.5-flash-lite, gemini-2.0-flash e gemini-2.0-flash-lite, então você troca velocidade por capacidade conforme a tarefa. O padrão é o gemini-2.5-flash, um meio-termo sólido para os prompts do dia a dia.
Segurança com token bearer
Cada requisição exige um token bearer que você define como segredo na Cloudflare, e as que não o trazem falham. Você também pode enviar um cabeçalho X-API-Key para usar uma chave de provedor por requisição, o que permite trocar de chave sem refazer o deploy do worker. Isso evita que o endpoint fique como uma porta aberta se a URL vazar.
Deploy sem servidor
Como é distribuído como Cloudflare Worker, não há servidor para aplicar patch, nem contêiner para manter aquecido, nem custo em repouso. O deploy é um único comando make deploy e as atualizações estão a um make update. O plano gratuito da Cloudflare absorve até 100.000 requisições por dia, bem acima do que um atalho pessoal consome.
Feito para os Atalhos da Apple
O projeto nasceu como reforço para atalhos e o README aponta para o guia da própria Apple sobre como fazer chamadas de API nos Atalhos. Ele se apoia na ação nativa Obter Conteúdo do URL, então o seu atalho envia a requisição e lê a resposta sem app extra. Isso mantém todo o passo de IA dentro dos apps da Apple que você já usa.
Prós e contras
Prós
- Código aberto sob Apache 2.0, então você pode ler, fazer fork e mudar cada linha em vez de confiar em uma caixa preta.
- Roda em Cloudflare Workers sem servidor para manter e com um plano gratuito que cobre um uso pessoal pesado.
- Um único endpoint de conclusão no estilo OpenAI dá conta de texto e imagens, o que encaixa nos atalhos com configuração mínima.
- Escolha de modelo por requisição, dos rápidos Flash-Lite ao mais capaz Gemini 2.5 Flash.
- O token bearer e a chave de API opcional por requisição dão um controle básico sobre quem pode chamar o endpoint.
Contras
- Sem serviço hospedado, você precisa de uma conta na Cloudflare, uma chave do Google AI Studio e familiaridade com a linha de comando para começar.
- O formato da requisição precisa bater com o esquema da API, e um data URL de imagem malformado faz a chamada falhar em vez de se degradar com elegância.
- O plano gratuito do Google AI Studio limita o Gemini a 1.500 requisições por dia, então uma automação pesada pode bater no teto e exigir uma chave paga.
- Você mesmo mantém o projeto, o que significa ficar de olho nas atualizações de dependências e refazer o deploy quando os modelos Gemini mudam.
Perguntas frequentes
Não. O worker roda no plano gratuito da Cloudflare e o Google AI Studio oferece uma cota gratuita de Gemini de até 1.500 requisições por dia, então uma instalação pessoal funciona sem custo. Você só paga se o seu volume passar esses limites ou se quiser o plano pago do Workers na Cloudflare.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a GenAI API for Apple Shortcuts.
Alternativas a GenAI API for Apple Shortcuts
Base Code
Base44 (Wix) · Programação · ProdutividadeO Base Code é um ambiente de desenvolvimento em nuvem compartilhado da Base44. O time descreve mudanças em um repositório do GitHub pelo chat, confere tudo na prévia e envia o resultado como pull request.
Google EmbeddingGemma 2
Google DeepMind · Escrita · Imagem · ProgramaçãoGoogle EmbeddingGemma 2 é um modelo aberto de 740 milhões de parâmetros que transforma texto, código, imagens, áudio e quadros de vídeo em vetores de um único espaço de 768 dimensões, rodando em celulares e notebooks.
GitGlow
GitGlow · Programação · ProdutividadeO GitGlow é um cliente Git de desktop que coloca seu código e as mudanças dos seus agentes de IA na mesma revisão, para você saber o que vai sair da máquina antes de publicar.