Como Usar Suas Próprias Chaves de API (BYOK) com KiwiClaw

Introdução

O plano BYOK (Bring Your Own Keys - Traga Suas Próprias Chaves) do KiwiClaw custa US$ 15/mês e permite que você use suas próprias chaves de API de qualquer provedor de LLM compatível. Isso lhe dá controle direto sobre quais modelos você usa, quanto você gasta em chamadas de API e garante que seu tráfego de API vá diretamente para o provedor, sem passar pelo proxy LLM do KiwiClaw.

Pré-requisitos

• Uma conta KiwiClaw
• Chaves de API de um ou mais provedores compatíveis: OpenAI, Anthropic, Google (Gemini), Mistral ou outros
• Um método de pagamento para a taxa de hospedagem de US$ 15/mês

Instruções Passo a Passo

Passo 1: Inscreva-se e Escolha BYOK

Crie sua conta em app.kiwiclaw.app e selecione o plano BYOK (US$ 15/mês) durante o onboarding.

Passo 2: Insira Suas Chaves de API

Nas configurações do agente, insira suas chaves de API. A configuração do seu agente aponta diretamente para as APIs do provedor upstream -- suas chaves são injetadas como variáveis de ambiente em sua máquina dedicada.

Passo 3: Selecione Seu Modelo Padrão

Escolha qual modelo seu agente usa por padrão. Você pode configurar o modelo nas configurações do seu agente. As opções populares incluem GPT-4o, Claude Opus, Gemini Pro e Mistral Large.

Passo 4: Teste a Conexão

Envie uma mensagem de teste para verificar se suas chaves de API funcionam corretamente. Se você receber um erro, verifique se suas chaves são válidas e têm créditos suficientes com o provedor.

Passo 5: Monitore Seu Uso da API

Acompanhe o uso da sua API através do painel do seu provedor (OpenAI, Anthropic, etc.). A página de uso do KiwiClaw mostra a contagem de mensagens, mas os custos da API são cobrados diretamente pelo seu provedor.

Dicas Profissionais

• Defina limites de gastos -- Configure limites de gastos em sua conta de provedor para evitar contas inesperadas.
• Use modelos diferentes para tarefas diferentes -- Use modelos mais baratos para tarefas simples e modelos premium para tarefas complexas.
• Compare com o Standard -- Se você gastar mais de US$ 24/mês em chamadas de API, o plano Standard (US$ 39/mês com LLM incluído) pode ser mais econômico.
• Vários provedores -- Você pode configurar várias chaves de API e alternar entre os provedores conforme necessário.

Perguntas Frequentes

Quais provedores de LLM o BYOK suporta?

O BYOK suporta OpenAI, Anthropic, Google (Gemini), Mistral e qualquer provedor compatível com o formato da API OpenAI. Seu tráfego de API vai diretamente para o provedor -- o KiwiClaw não faz proxy ou intercepta chamadas de API BYOK.

O BYOK é mais barato que o plano Standard?

Depende do seu uso. O BYOK custa US$ 15/mês pela hospedagem mais o que você gasta em chamadas de API. Se seus custos mensais de API forem inferiores a US$ 24, o BYOK é mais barato. Se excederem US$ 24, o plano Standard de US$ 39/mês (LLM incluído) pode ser mais econômico.

Posso mudar do BYOK para o Standard mais tarde?

Sim. Você pode mudar de plano a qualquer momento nas configurações da sua conta. Quando você muda para o Standard, seu agente começa a usar o acesso LLM gerenciado do KiwiClaw em vez de suas chaves de API. Nenhum dado é perdido durante a mudança.