Chaves de provedor

As chaves de provedor são as chaves de API que permitem que um Nodaro self-hosted chame modelos de IA. Você pode colá-las no app ou defini-las no ambiente, e as duas formas valem ao mesmo tempo. Em vez de chaves, ou junto com elas, você também pode conectar a instalação a uma conta do Nodaro Cloud: veja Conectar ao Nodaro Cloud.

Duas formas de adicionar uma chave

Clicar em Executar logo depois de colar uma chave funciona: um nó que não encontra um provedor lê as chaves de novo, uma vez, antes de falhar.

Colar uma chave sempre exige uma sessão logada no app. Um token de API ou um token de app nunca pode alterar uma chave. Os cartões de integridade de /setup não exigem login, mas salvar uma chave ali exige: conclua primeiro a etapa 1, Crie seu login do servidor.

Qual chave prevalece

O ambiente prevalece. Uma chave definida no ambiente fica somente leitura na tela: o bloco dela mostra set (env) e indica a variável a remover. Uma chave colada só é usada quando o ambiente não tem nenhuma chave para aquele provedor.

Gerenciar uma chave no bloco dela

Todo bloco de provedor pode ser gerenciado em tempo de execução, inclusive as chaves que vêm do .env. As alterações passam a valer sem reinicialização.

• Uma chave colada mostra set (app), ou key set (app) no bloco nodaro.ai. Clique em Alterar chave ou em Remover a qualquer momento.
• Uma chave do .env não pode ser editada ali mesmo. Substituir chave do .env salva no app uma chave que sobrepõe a do ambiente, sem editar o arquivo. Ou remova a chave do .env e reinicie.
• Desativar interrompe um provedor até você ativá-lo de novo, quer a chave dele venha do .env, quer tenha sido colada. Use essa opção para mover a geração para outro provedor, por exemplo para a sua conexão com o Nodaro Cloud.
• missing (ausente) significa que o provedor não tem chave. disabled (desativado) significa que você o desligou.

Cada bloco diz o que a chave dele habilita e onde conseguir uma.

Todas as chaves de provedor

Chaves usadas por nós específicos

Deixe estas chaves vazias, a menos que você use o nó que elas indicam. Em uma instalação conectada, esses nós são executados pelo Nodaro Cloud quando a chave deles está vazia.

GEMINI_API_KEY não é o mesmo que GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET. Essas duas variáveis pertencem a um app OAuth do Google, por exemplo para publicar no YouTube. Veja Apps das redes sociais.

As chaves e a conexão com o Nodaro Cloud

• Uma conexão cobre todos os blocos. Em uma instalação conectada, os modelos de imagem, vídeo, fala e texto, os avatares, o Reiluminar e trocar e a extração de dados da web são executados pela sua conta do Nodaro Cloud. Cole uma chave só para chamar aquele provedor diretamente.
• Você escolhe quem tem prioridade. Quando você se conecta, uma caixa de diálogo pergunta se o Nodaro Cloud executa tudo primeiro ou se as suas próprias chaves vêm primeiro. Veja Escolher como a conexão é usada.
• A conexão OAuth prevalece sobre a NODARO_API_KEY. Quando uma instalação tem as duas, ela usa a conexão e ignora a chave.

Modelos Gemini

Os modelos Gemini podem rodar de duas formas. Sem a GEMINI_API_KEY, eles rodam com a KIE_API_KEY. Com ela:

• O Gemini 3.1 Pro roda primeiro diretamente no Google, com a KIE_API_KEY como alternativa.
• Os modelos Gemini Flash continuam na KIE_API_KEY e só usam a GEMINI_API_KEY quando essa rota falha.

Duas coisas para saber antes de defini-la:

• Custo. O Google cobra a rota direta pelos próprios preços por token, que podem ser mais altos que os do mesmo modelo na KIE_API_KEY. Confira os preços atuais do Google antes de mover um modelo de alto volume.
• Mídia. A API do Google não consegue buscar URLs arbitrárias. O Nodaro baixa cada referência de imagem, vídeo ou áudio e a envia como dados inline, quando ela é pequena, ou pela Gemini Files API, quando ela é grande. A Files API guarda os arquivos por 48 horas.

Passar o tráfego dos provedores pelo seu próprio proxy

Dois provedores permitem mudar o host, e não só a chave:

Deixe as duas sem definir, e nada muda. Defina uma, e o Nodaro passa a se comunicar com o seu host. Os motivos comuns são a custódia das chaves, em que a chave real fica só no proxy, um log de auditoria de cada geração que sai da instalação e o roteamento regional.

O seu proxy precisa ser transparente: os mesmos caminhos e os mesmos corpos de requisição e de resposta, porque o Nodaro só troca a origem. As barras finais são removidas, então https://proxy.example.com/models/ e https://proxy.example.com/models se comportam da mesma forma.

ANTHROPIC_API_KEY e GEMINI_API_KEY não são afetadas pelo proxy. Com elas, esses modelos chamam a Anthropic e o Google diretamente.

Verificar se uma chave funciona

• No editor. Abra o workflow Welcome Demo e clique em Executar no nó Imagem da cena (Scene Image) dele.
• Pela linha de comando. Rode o teste com --keyed. Ele gasta uma geração real no modelo mais barato para a sua KIE_API_KEY ou o seu REPLICATE_API_TOKEN e verifica se a mídia chega ao seu próprio armazenamento:

node tools/community-smoke.mjs http://localhost:3000 --keyed

Um nó que falha com Missing API key chama um provedor que não tem chave. Adicione a chave desse provedor em /setup ou no .env.

A chave de criptografia

As chaves coladas precisam da chave de criptografia da instância, NODARO_ENCRYPTION_KEY. A stack do Compose incluída a gera na primeira inicialização. Sem ela, os blocos mostram missing (ausente), e /setup mostra um cartão Criptografia vermelho com a correção. As chaves definidas no ambiente continuam funcionando. Veja Instalação.