Configuração da API do Droid: como conectar modelos de IA personalizados

O Droid é compatível tanto com modelos de IA integrados quanto com modelos externos, oferecendo mais flexibilidade para tarefas de programação. Este guia mostra como conectar uma API externa, configurar seu ambiente, resolver problemas comuns e usar o Kimi para potencializar o desenvolvimento com IA. Observação: este guia é válido apenas para o Droid CLI. Modelos personalizados são atualmente compatíveis apenas na CLI e não estão disponíveis em outros produtos Droid.

Conectar o Droid com a API do Kimi

Tempo de leitura: 10 minutos2026-08-12

Quer usar seu próprio modelo de IA para programar sem uma configuração complicada? O Droid facilita isso ao dar suporte a APIs externas na sua CLI, permitindo conectar um modelo personalizado que se encaixe no seu fluxo de trabalho. Este guia mostra como configurar a API, resolver problemas comuns e usar o Kimi no Droid. Continue lendo para começar.

O que é o Droid?

O Droid é uma ferramenta de programação com IA que ajuda desenvolvedores a escrever código, resolver erros e lidar com tarefas de desenvolvimento com mais eficiência. Ele oferece suporte a modelos de IA integrados e também permite que os usuários conectem modelos personalizados pela sua CLI para mais flexibilidade. Isso o torna útil para diferentes fluxos de trabalho de programação, seja para uma ajuda rápida ou uma configuração mais personalizada.

Como usar modelos de IA integrados no Droid?

Os modelos de IA integrados facilitam começar a programar com o Droid, pois não é necessário conectar a nenhuma API externa primeiro. Depois de instalar o aplicativo, você pode escolher um modelo dentro da plataforma e começar a usar a ajuda da IA para análise de código, desenvolvimento de recursos, correção de bugs e revisões. Veja como começar com o Droid:

Passo 1: Instale e abra o Droid

Comece baixando o Factory App no seu dispositivo e concluindo a instalação. Depois, abra o aplicativo e faça login na sua conta. Isso dá acesso ao Droid e aos seus recursos de IA integrados dentro do aplicativo.

Passo 2: Conecte o Droid à pasta do seu projeto

Defina seu diretório de trabalho para a base de código com a qual deseja trabalhar. Isso vincula o Droid ao seu projeto local, permitindo que ele leia os arquivos, entenda a estrutura do código e apoie suas tarefas de desenvolvimento com mais contexto.

Passo 3: Escolha um modelo integrado e comece a enviar prompts

Abra o seletor de modelos e escolha um dos modelos de IA integrados disponíveis no Droid. Depois de selecionar o modelo, você pode começar a enviar prompts, como pedir que ele analise a base de código, corrija um bug, revise o código ou desenvolva um recurso.

Como conectar o Droid a uma API externa?

Conectar o Droid a uma API externa dá mais liberdade para trabalhar com o modelo que você prefere, em vez de ficar limitado às opções integradas. A configuração é feita dentro do Droid CLI, adicionando um modelo personalizado ao arquivo de configurações, e depois de salvo, o modelo fica disponível no menu /model. As etapas abaixo usam o Kimi como exemplo simples, para que você veja como funciona a configuração completa, desde a chave de API até a seleção do modelo:

Passo 1: Obtenha uma chave de API do Kimi na Moonshot AI

Comece criando ou copiando sua chave de API do Kimi na Moonshot AI. Você vai precisar dessa chave porque o Droid a usa para se conectar à API do Kimi e enviar solicitações pela sua própria conta. O ideal é salvar a chave como uma variável de ambiente, como MOONSHOT_API_KEY, para que ela possa ser usada com segurança dentro do arquivo de configurações.

Passo 2: Abra o arquivo de configurações do Droid

Em seguida, abra o arquivo de configurações onde os modelos personalizados são adicionados no Droid CLI. No macOS, o caminho do arquivo é ~/.factory/settings.json. No Windows PowerShell, use %USERPROFILE%\.factory\settings.json. Este é o arquivo principal onde o Droid lê a configuração do seu modelo personalizado.

Passo 3: Adicione o Kimi como modelo personalizado

Dentro de settings.json, adicione o Kimi no array customModels. Isso informa ao Droid qual modelo usar, qual endpoint de API deve chamar, qual formato de provedor ele segue e qual chave de API deve ser usada para autenticação. Se o arquivo já tiver outras configurações, não substitua tudo, apenas adicione esse objeto de modelo dentro do array customModels existente.

```json { "customModels": [ { "model": "kimi-k3", "displayName": "Kimi K3", "baseUrl": "https://api.moonshot.ai/v1", "apiKey": "${MOONSHOT_API_KEY}", "provider": "generic-chat-completion-api", "maxOutputTokens": 16384 } ] } ```

Passo 4: Salve o arquivo e reinicie o Droid

Depois de adicionar a configuração, salve o arquivo e reinicie o Droid CLI. Isso garante que o Droid recarregue as configurações atualizadas e reconheça corretamente o novo modelo personalizado.

Passo 5: Selecione o modelo Kimi usando /model dentro do Droid

Abra o Droid CLI e execute o comando /model. Sua configuração do Kimi agora deve aparecer na seção de modelos personalizados. Selecione-a na lista para tornar o Kimi o modelo ativo da sua sessão de codificação.

Passo 6: Execute uma tarefa

Depois de selecionar o Kimi, você pode começar a usá-lo para trabalho real no Droid. Experimente um prompt como revisar código, corrigir um bug ou explicar uma base de código. O Droid enviará a solicitação pela Kimi API e usará esse modelo para a tarefa.

Benefícios de usar a Kimi API

Depois de conectar o Kimi ao Droid, ele se torna muito mais do que apenas um modelo externo no CLI. Ele se transforma em um assistente de codificação prático que se encaixa no seu fluxo de trabalho diário de desenvolvimento e ajuda tanto em pequenas tarefas de código quanto em trabalhos de engenharia maiores. Aqui estão alguns benefícios de usar a Kimi API:

Aumente a eficiência de desenvolvimento

O Kimi pode ajudar você a avançar mais rápido nas tarefas de codificação do dia a dia, gerando código, explicando lógica e sugerindo correções enquanto você trabalha. Isso significa que você não precisa alternar entre várias ferramentas para obter suporte simples de desenvolvimento. Com o Kimi dentro do Droid, o trabalho de programação de rotina fica mais fácil de gerenciar.

Escreva código mais confiável

O Kimi pode revisar seu código, apontar possíveis problemas e ajudar a melhorar a estrutura antes que pequenos erros se transformem em problemas maiores. Esse tipo de feedback antecipado é útil quando você quer uma lógica mais limpa e melhor manutenibilidade. Com o tempo, isso pode ajudar você a construir um código mais fácil de testar, atualizar e entender.

Lide com diversas tarefas de desenvolvimento

O Kimi não se limita a escrever código do zero. Ele também pode ajudar com refatoração, documentação de código, compreensão de projetos desconhecidos e apoio ao desenvolvimento de funcionalidades em diferentes tarefas. Isso o torna uma opção flexível para desenvolvedores que querem um único modelo de IA para ajudar em várias partes do fluxo de trabalho.

Solucionando erros comuns ao conectar APIs

Conectar uma chave de API externa no Droid geralmente é simples, mas pequenos erros de configuração ainda podem causar problemas. A maioria dos problemas vem do arquivo de configurações, do nome do provedor, da chave de API ou da configuração do servidor do modelo, e não do próprio Droid. O lado bom é que esses erros costumam ser fáceis de corrigir depois que você sabe onde procurar.

Modelo não aparece no seletor

Verifique a sintaxe JSON em ~/.factory/settings.json ou config.json, caso esteja usando o formato legado
As alterações nas configurações são detectadas automaticamente por meio do monitoramento de arquivos
Verifique se todos os campos obrigatórios estão presentes na configuração do modelo personalizado

Erro "Invalid provider"

Certifique-se de que o valor do provedor seja exatamente anthropic, openai ou generic-chat-completion-api
Verifique se há erros de digitação e o uso correto de maiúsculas/minúsculas no campo do provedor

Erros de autenticação

Verifique se sua chave de API é válida e possui créditos disponíveis
Verifique se a chave de API tem as permissões corretas para o provedor
Confirme se a URL base corresponde ao endpoint de API na documentação do provedor

O modelo local não conecta

Certifique-se de que o servidor do seu modelo local esteja em execução, como ollama serve
Verifique se a URL base está correta e inclui /v1/, caso o provedor exija isso
Verifique se o modelo já foi baixado ou está disponível localmente

Erros de limite de taxa ou de cota

Verifique os limites de taxa de API e as cotas de uso do seu provedor
Monitore seu uso no painel do provedor para ver se os limites foram atingidos

Conclusão

Usar APIs personalizadas no Droid dá a você mais controle sobre como construir, testar e melhorar código com IA. Depois que a configuração estiver pronta, fica mais fácil moldar seu fluxo de trabalho de codificação em torno do modelo que atende às suas necessidades. Seja mantendo as opções integradas ou conectando um modelo externo, o Droid oferece uma maneira flexível de trazer IA para o desenvolvimento. Se você quiser um ponto de partida simples para uma configuração personalizada, vale a pena experimentar o Kimi no Droid. Ele pode ser uma escolha prática para tornar o trabalho de codificação do dia a dia mais fluido e rápido.

Conectar o Droid com a API do Kimi

Perguntas frequentes

Quais modelos de IA o Droid suporta?

O Droid é compatível tanto com modelos de IA integrados quanto com modelos personalizados adicionados pela CLI. A configuração externa funciona com tipos de provedor como Anthropic, OpenAI e APIs genéricas de conclusão de chat. Isso dá aos usuários a flexibilidade de trabalhar com APIs oficiais, alguns provedores de código aberto ou modelos locais, conforme sua configuração.

Quais informações são necessárias para configurar uma API externa?

Para configurar uma API externa no Droid, geralmente é necessário informar o ID do modelo, nome de exibição, URL base, chave de API e tipo de provedor. Algumas configurações também podem incluir campos opcionais, como número máximo de tokens de saída, argumentos extras ou cabeçalhos adicionais. Esses detalhes ajudam o Droid a se conectar corretamente ao modelo.

Posso alternar entre modelos de IA integrados e externos?

Sim, o Droid permite alternar entre modelos integrados e externos. Os modelos integrados podem ser selecionados no aplicativo, enquanto os modelos personalizados podem ser escolhidos no menu /model da CLI após a configuração. Isso facilita o uso de modelos diferentes para tarefas de programação diferentes.

Por que estou vendo um erro de limite de taxa ou cota?

Isso geralmente significa que seu provedor de API atingiu um limite de uso, um limite de requisições ou uma cota de cobrança. Verifique o painel do seu provedor para revisar créditos, uso e limites de taxa. Assim que o problema de limite for resolvido, o modelo deve voltar a funcionar no Droid sem necessidade de mais alterações na configuração.