A Cloudflare executa modelos abertos em sua própria rede com o nome Workers AI e oferece uma cota gratuita diária. Ela é um pouco diferente dos outros provedores: um aplicativo precisa de dois valores seus, um token de API e o seu Account ID. A maioria dos problemas de configuração vem de informar só o primeiro.
Crie o token de API
- Faça login no painel da Cloudflare e abra a página Workers AI.
- Selecione Use REST API.
- Selecione Create a Workers AI API Token e revise os dados já preenchidos.
- Selecione Create API Token.
- Selecione Copy API Token e guarde o valor em um lugar privado.
O modelo já preenchido é o caminho fácil. Se você criar um token personalizado, ele precisa das permissões Workers AI - Read e Workers AI - Edit.
Encontre o seu Account ID
Na mesma página do Workers AI, a etapa Get Account ID mostra o seu Account ID: uma sequência de 32 letras e dígitos. Copie-o também. Ele não é secreto como o token, mas sem ele um aplicativo não consegue acessar o Workers AI.
O que a cota gratuita significa
A Cloudflare mede o uso em Neurons, uma unidade do trabalho de computação que uma solicitação exige, e não em número de solicitações.
- Você tem 10.000 Neurons por dia sem custo.
- A cota é redefinida às 00:00 UTC.
- No plano Workers Free, as solicitações falham quando a cota acaba, até a redefinição.
- No Workers Paid, o uso acima da cota custa US$ 0,011 por 1.000 Neurons.
Quantas perguntas isso representa depende do modelo e do tamanho da pergunta e da resposta. A Cloudflare publica um preço em Neurons para cada modelo:
| Modelo | Neurons por milhão de tokens de entrada | Neurons por milhão de tokens de saída |
|---|---|---|
| Gemma 4 26B | 9.091 | 27.273 |
| GLM 4.7 Flash | 5.500 | 36.400 |
Como exemplo aproximado, uma pergunta de texto de uns 1.000 tokens com uma resposta de 500 custa cerca de 23 Neurons no Gemma 4 26B, então os 10.000 gratuitos cobrem algumas centenas de perguntas assim por dia. Perguntas com imagem enviam mais tokens de entrada e gastam mais. O painel mostra o que você usou hoje.
Qual modelo escolher
- Gemma 4 26B aceita imagens e lida bem com texto. Uma boa opção padrão.
- GLM 4.7 Flash é um modelo de texto rápido.
Usando o token no LuciQA
O LuciQA é um aplicativo de desktop que responde perguntas sobre o que está na sua tela. Abra Configurações, escolha Cloudflare, cole o token de API e o Account ID, selecione um modelo e salve. Se você escolher o GLM e depois enviar uma imagem, o LuciQA muda para o Gemma naquela solicitação, porque o GLM só lê texto.
Se o salvamento falhar com uma mensagem sobre a conta, confira se o Account ID tem exatamente 32 caracteres e nenhum espaço. O guia de configuração da Cloudflare repete esses passos, e a comparação de APIs de IA gratuitas mostra como os outros provedores gratuitos contam o uso.