> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrações de IA no Base44

> Conecte seu app Base44 a serviços populares de IA como OpenAI, Claude, Groq, Mistral ou qualquer outra plataforma de IA que use uma chave de API.

<Info>
  <u>Nota</u>: As integrações de IA estão disponíveis no nível Builder e superiores. Se você está no nível Free, precisa atualizar seu app para usar funções de backend e recursos de pagamento.
</Info>

# Configuração passo a passo

## Parte 1: O lado do provedor de IA

Se você já tem seus segredos ou chaves de API, pode pular para a configuração "O lado do Base44"

<Steps>
  <Step title="Visite o portal de desenvolvedor do seu provedor de IA">
    1. Abra o portal de desenvolvedor do seu provedor em uma nova aba do navegador

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/OpenAI-APIkeys.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=1a25b7103ea07de0048ab5e0bbba8721" alt="Open AI AP Ikeys Pn" width="2780" height="1338" data-path="images/OpenAI-APIkeys.png" />

           <Info>
             Estamos usando a OpenAI para este exemplo e o portal de desenvolvedores deles está em: [https://platform.openai.com](https://platform.openai.com)
           </Info>
    2. Faça login ou crie uma nova conta
    3. Vá até a seção **API keys**
  </Step>

  <Step title="Habilite o acesso à API, se necessário">
    1. Vá até a seção **billing** ou **payment** do seu provedor.

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/OpenAI-billing.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=61ecfca5a6bc9179076bc82e5e9d688f" alt="Open AI Billing Pn" width="2796" height="1336" data-path="images/OpenAI-billing.png" />

           <Warning>
             Para obter e utilizar uma chave de API da OpenAI, uma conta paga é necessária. Embora criar uma conta OpenAI seja grátis, o uso da API exige que você financie a conta com saldo de crédito ou tenha um método de cobrança registrado. A OpenAI opera em um modelo de pagamento por uso para seus serviços de API, onde as cobranças são feitas com base no uso real dos modelos.
           </Warning>
    2. Adicione um método de pagamento válido, como cartão de crédito ou PayPal.
    3. (Opcional) Configure um limite de gastos para controlar custos.

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/OpenAI-usage.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=e887dcc59aebda2141cd454b28047467" alt="Open AI Usage Pn" width="2808" height="1348" data-path="images/OpenAI-usage.png" />
    4. Verifique se sua conta tem créditos ativos, caso seu provedor exija.
  </Step>

  <Step title="Crie uma nova chave de API">
    1. Na seção de chaves de API do seu provedor, clique em **Create new API key**

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/OpenAI-createsecretkey.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=0b30844f4622e85c9ef1388d634eb009" alt="Open AI Createsecretkey Pn" width="2788" height="1332" data-path="images/OpenAI-createsecretkey.png" />

           <Info>
             <u>Nota</u>: O texto do botão pode ser diferente entre provedores. Às vezes pode ser chamado de "Create new secret"
           </Info>
    2. Copie a chave gerada imediatamente porque você pode não conseguir vê-la novamente.
  </Step>
</Steps>

## Parte 2: O lado do Base44

<Steps>
  <Step title="Acesse o catálogo de integrações do Base44">
    Acesse a Base44 e clique em **Integrations**

    <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=16ac71b185167177ef260be7c92b0339" alt="Integrations Pn" width="1570" height="652" data-path="images/Integrations.png" />

    <Info>
      Certifique-se de estar logado na Base44 para visualizar a [página do catálogo de Integrações](https://app.base44.com/integrations-catalog)
    </Info>

    2. Use a barra de pesquisa ou role para encontrar seu **provedor de IA**
    3. Selecione seu **provedor de IA** e clique em **"Use this integration"** \
       (neste exemplo, estamos usando OpenAI)

           <img src="https://mintcdn.com/base44/UsrMcs9B3MEl2R91/images/Base44-OpenAI-integration.png?fit=max&auto=format&n=UsrMcs9B3MEl2R91&q=85&s=8520105d22c0414d2fa69905b8b8e4b4" alt="Base44 Open AI Integration Pn" width="2768" height="1326" data-path="images/Base44-OpenAI-integration.png" />
  </Step>

  <Step title="Adicione sua chave de API ao Base44">
    1. Digite a ideia do seu app na caixa de chat de IA
    2. Cole a chave quando solicitado

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations-pasteAPIkey.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=d26fd8ef2d13ba31923157049b9b4249" alt="Integrations Paste AP Ikey Pn" width="1501" height="738" data-path="images/Integrations-pasteAPIkey.png" />

       Exemplo: Para OpenAI você pode ver: OPENAI\_API\_KEY

    <Tip>
      Opcional: Você pode salvar sua chave com segurança em **Dashboard → Secrets** para reutilizá-la depois.
    </Tip>

    <Warning>
      Importante: Nunca cole chaves de API em código público, componentes visíveis ou prompts.
    </Warning>
  </Step>

  <Step title="Diga à IA o que fazer">
    1. Depois que seu app for criado, no chat do Base44, descreva a tarefa que você quer que a IA execute

           <img src="https://mintcdn.com/base44/oUaRpzSyJvMVshj9/images/Integrations-imagegen1.png?fit=max&auto=format&n=oUaRpzSyJvMVshj9&q=85&s=06229c9da7abb8460c5b93771c066258" alt="Integrations Imagegen1 Pn" width="2824" height="1378" data-path="images/Integrations-imagegen1.png" />
    2. A Base44 criará os componentes de backend e frontend para você.
    3. Você pode melhorar o comportamento da IA com prompts adicionais.
  </Step>

  <Step title="Teste sua integração de IA">
    1. Experimente seu recurso de IA com entradas de teste ou prompts de exemplo.

           <img src="https://mintcdn.com/base44/-Vklow6W-uVvNnvR/images/learnlink-imagegen.png?fit=max&auto=format&n=-Vklow6W-uVvNnvR&q=85&s=63ffd932e9812443ea118aa13f6f92a6" alt="Learnlink Imagegen Pn" width="1000" height="494" data-path="images/learnlink-imagegen.png" />
    2. Verifique a saída da IA.
    3. Experimente diferentes estilos, tons ou exemplos até que funcione do jeito que você quer.

    <Info>
      Ao executar testes, não cole dados reais de clientes. Use conteúdo de amostra ou fictício.
    </Info>
  </Step>

  <Step title="Coloque no ar">
    Quando tudo estiver funcionando:

    * Pré-visualize seu app em diferentes dispositivos
    * Implante e compartilhe com outras pessoas
    * Monitore o **uso da API** no painel do seu provedor
  </Step>
</Steps>

## **Recapitulando**

O que você fez (sem necessidade de programação)

* Selecionou um provedor de IA para seu caso de uso.
* Conectou com segurança usando uma chave de API.
* Deixou a Base44 cuidar da configuração de backend.
* Usou prompts para projetar o comportamento da sua IA.
* Testou e lançou seu app com IA.

Agora você tem uma integração de IA funcionando. Você pode repetir esses passos para qualquer provedor que use chaves de API, não apenas OpenAI.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="E se meu provedor não estiver listado no catálogo">
    Você ainda pode conectá-lo com a ajuda da IA do Base44. O processo é um pouco mais manual, mas a IA vai te guiar passo a passo.

    Diga: `"Use o provedor "[nome do provedor]". Tenho uma chave de API. Me ajude a conectá-lo e a criar um teste simples. Me peça os detalhes que precisar."`

    Mantenha sua chave de API em um local seguro até a IA pedi-la. Você também precisará de alguns detalhes da documentação do seu provedor.

    <Info>
      **Alguns requisitos importantes para configuração manual**\
      Seu provedor precisa oferecer uma API online padrão que funcione por https (geralmente chamada de "REST API"). Isso significa:

      * Um endereço web (URL) onde a Base44 pode enviar requisições.
      * Uma chave de API para autenticação.\
        Instruções do provedor sobre quais informações enviar e como elas devem ser formatadas.
      * Detalhes sobre como o provedor enviará as respostas, idealmente em um formato como JSON (uma forma comum de enviar texto estruturado).
    </Info>
  </Accordion>

  <Accordion title="Como mantenho minha chave de API segura?">
    Armazene-a na seção **Secrets** do Base44 ou em um gerenciador de senhas. Nunca a compartilhe em código público, capturas de tela ou mensagens de chat.
  </Accordion>

  <Accordion title="O que acontece se eu ficar sem créditos com meu provedor?">
    Sua integração de IA vai parar de funcionar até você adicionar mais créditos ou atualizar as configurações de cobrança com o provedor.
  </Accordion>

  <Accordion title="Preciso saber programar para usar IA no Base44?">
    Não. Você pode configurar tudo seguindo os passos do guia e escrevendo prompts em linguagem natural.
  </Accordion>

  <Accordion title="Posso mudar meu provedor de IA depois?">
    Sim. Você pode se conectar a um provedor diferente a qualquer momento. Será necessário adicionar a nova chave de API no Base44 e talvez atualizar seus prompts ou componentes para que funcionem com a API do novo provedor.
  </Accordion>

  <Accordion title="Como posso limitar custos?">
    A maioria dos provedores de IA permite definir limites de gastos ou limites de uso nas configurações de cobrança da sua conta. Você também pode monitorar seu uso no painel deles. Para testes, tente prompts mais curtos ou requisições menores para manter os custos baixos. Lembre-se de que o controle de custos de cada provedor funciona de forma um pouco diferente, então é uma boa ideia consultar a documentação de ajuda.
  </Accordion>

  <Accordion title="Por que minha IA está dando respostas inesperadas?">
    Torne seu prompt mais específico. Inclua instruções claras, contexto importante e exemplos do que você quer. Se possível, diga à IA o que *não* incluir. Você também pode tentar mudar para um modelo diferente se seu provedor oferecer um mais focado em precisão. Se o problema continuar, compartilhe o prompt e a resposta com a IA do Base44 e peça ajuda para solucionar o problema passo a passo.

    "Se você ficar travado, cole seu prompt e a resposta da IA no chat do Base44 e diga 'me ajude a solucionar isso passo a passo.'"
  </Accordion>

  <Accordion title="Posso usar mais de um provedor de IA ao mesmo tempo?">
    Sim. Você pode adicionar várias integrações no Base44, basta especificar qual provedor será usado para cada função.
  </Accordion>
</AccordionGroup>

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>