Cloudflare Developers: construir aplicações web e de IA

Guias oficiais para conectar código, modelos de IA, agentes e serviços de nuvem.

Ir para o site ↗developers.cloudflare.com
developers.cloudflare.com
Cloudflare Developers screenshot

Cloudflare Developers reúne documentação técnica, referências de API e tutoriais da Cloudflare. O portal ajuda desenvolvedores a publicar aplicações, conectar modelos de IA e escolher serviços para dados, segurança e operação.

Em linguagem simples: para que serve este site?

Pense nele como o manual de um conjunto de peças de nuvem. Se você precisa colocar uma API no ar, guardar arquivos ou adicionar respostas de IA a um aplicativo, pode descobrir qual serviço usar e como conectá-lo ao código. Ler a documentação não cria recursos: isso é feito pela conta Cloudflare, pelo painel, pela linha de comando ou pelas APIs.

É útil para desenvolvedores, empreendedores técnicos e equipes de operação. Um exemplo pequeno ajuda quem está começando, mas um serviço real exige programação, permissões, testes e acompanhamento de custos.

Colocar um primeiro Worker no ar

O guia oficial pela CLI usa uma conta Cloudflare e um ambiente Node.js compatível.

  1. Execute npm create cloudflare@latest -- my-first-worker e escolha um exemplo simples de Worker.
  2. Entre na pasta do projeto, rode npx wrangler dev e abra o endereço local informado no terminal.
  3. Altere o texto retornado no código, salve e recarregue para conferir a mudança.
  4. Rode npx wrangler deploy, conclua a autorização e verifique a URL workers.dev recebida.

Para experimentar apenas um modelo, siga o início com REST do Workers AI: obtenha Account ID e token, envie a requisição autenticada do modelo escolhido e confira o JSON e os erros. Guarde o token no servidor. Chamadas de inferência durante o desenvolvimento local também podem consumir os limites do serviço.

Separar execução de modelos, gestão e agentes

Workers AI executa modelos na infraestrutura GPU da Cloudflare. Você pode chamar o serviço de um Worker ou de um backend externo via REST. Geração de texto, embeddings e tarefas com imagens usam entradas e saídas diferentes conforme o modelo.

AI Gateway controla requisições para provedores compatíveis. Análises, logs, cache, limitação de frequência, novas tentativas e modelos alternativos ajudam a acompanhar erros e consumo.

Agents oferece estado persistente, conexões em tempo real, tarefas agendadas e ferramentas como MCP para aplicativos com agentes. O desenvolvedor continua responsável pela lógica, pelas permissões e pela validação das ações.

Armazenar arquivos, registros e vetores

R2 guarda objetos e arquivos; D1, dados relacionais consultados com SQL; KV, pares de chave e valor. Durable Objects coordena estado, enquanto Vectorize armazena embeddings e faz buscas por similaridade.

Um assistente documental pode combinar originais no R2, registros no D1 e vetores no Vectorize. A ingestão, o controle de acesso e a avaliação das respostas precisam ser implementados. O guia de escolha de armazenamento explica os usos de cada componente.

Entender a franquia gratuita e os custos separados

A documentação é pública. Os serviços têm cobrança própria. Em 7 de outubro de 2026, a tabela do Workers AI informa 10.000 Neurons gratuitos por dia, renovados às 00:00 UTC. Para exceder a franquia é necessário Workers Paid; alguns modelos exigem uma forma de cobrança paga.

Análises básicas, cache e limitação de requisições do Gateway são gratuitos, mas inferência, logs e outros recursos podem gerar cobrança. As regras do Gateway também diferenciam logs pela data de criação do primeiro gateway. Valores oficiais em dólares não representam um preço final em reais, com impostos, para todos os produtos.

Cuidar da proteção depois da publicação

O portal também cobre DNS, cache, TLS, WAF e Turnstile. Turnstile pode ser incorporado sem encaminhar todo o tráfego do site pela Cloudflare. Publicar um Worker não configura automaticamente essas proteções; escolha cada serviço para uma necessidade concreta.

Conferir dados, logs e licença do modelo

A política do Workers AI afirma que o conteúdo do cliente não é usado para treinar modelos nem melhorar serviços sem consentimento explícito. Serviços de armazenamento conectados podem guardar esse conteúdo. Provedores externos possuem condições próprias.

Os logs do AI Gateway vêm habilitados e podem incluir prompts e respostas. Confira a coleta antes de processar informações sensíveis e leia a licença individual do modelo para o uso comercial pretendido.

Perguntas frequentes

A franquia gratuita permite usar qualquer modelo?

Não necessariamente. A disponibilidade depende dos requisitos de pagamento de cada modelo, da franquia diária e dos limites de frequência. Neurons não equivalem a um número fixo de chamadas.

Posso chamar a IA do meu backend atual?

Sim. A API REST aceita chamadas autenticadas com Account ID, token autorizado e o corpo exigido pelo modelo, sem uma migração completa para Workers.

O AI Gateway gratuito inclui a inferência?

Os controles básicos gratuitos não tornam o consumo dos provedores gratuito. Confira o modelo, a forma de cobrança e os logs separadamente.

Recursos oficiais e comunidade