Como conectar uma API de modelo de IA no Android com a FoneClaw
Configure provedor, URL base, chave e ID do modelo na FoneClaw. Teste texto, imagens e ferramentas Android separadamente e identifique a camada que falha.
- Você pode usar o modelo padrão gratuito da FoneClaw ou configurar um provedor on-line compatível. Assinatura de um chatbot e acesso à API são serviços distintos.
- Predefinição de provedor, URL base, chave e ID do modelo precisam corresponder ao endpoint escolhido. Os controles de imagens e ferramentas devem refletir capacidades reais do modelo.
- Valide uma resposta textual, uma imagem selecionada e uma consulta Android de baixo risco em testes separados. Texto funcionando não comprova suporte visual nem chamadas de ferramentas.
- Modelo descontinuado, credencial inválida e permissão Android ausente são problemas diferentes. Após mudar a configuração, confira resultados anteriores antes de repetir uma ação.
Use o modelo padrão ou conecte sua própria API
Para conectar uma API de modelo de IA no Android, você pode configurar um provedor on-line compatível dentro da FoneClaw. Também oferecemos um modelo padrão gratuito, sem exigir uma chave externa para começar. Na configuração personalizada, o endereço do serviço, a credencial e o identificador do modelo precisam funcionar juntos no formato de API aceito.
O modelo padrão simplifica o primeiro teste do agente. A configuração personalizada é útil quando você já tem acesso à API de um provedor ou quer usar um modelo específico. Uma assinatura no aplicativo de um chatbot não concede automaticamente chave, saldo ou acesso à API; confirme essas condições na conta do provedor.
| Caminho | Quando usar | Como a tarefa funciona |
|---|---|---|
| Modelo padrão gratuito | Primeiro teste e uso sem credencial externa | O modelo interpreta o pedido; ferramentas habilitadas executam etapas suportadas |
| Modelo on-line compatível | Quando você tem endpoint, chave e modelo disponíveis na sua conta | O modelo selecionado interpreta e planeja; a execução segue permissões e política de aprovação |
A configuração acontece dentro da FoneClaw. O modelo fornece compreensão e planejamento, enquanto nossas ferramentas Android executam as ações aplicáveis ao aparelho e ao estado do aplicativo. Se você selecionar um modelo on-line, ele pode receber o contexto que você fornecer.
Entenda provedor, URL base, chave e ID do modelo
Os campos têm funções diferentes. Uma predefinição facilita preencher a configuração, mas não comprova que a conta tem acesso ao modelo ou que todas as capacidades estão disponíveis.
| Campo ou controle | Função | O que conferir |
|---|---|---|
| Predefinição de provedor | Facilita a configuração do serviço escolhido | Valores atuais e compatibilidade do endpoint |
| URL base da API | Indica o serviço que recebe as chamadas | Endereço, caminho e formato documentados pelo provedor |
| Chave de API | Autentica as chamadas | Validade, escopo e conta à qual pertence |
| ID do modelo | Seleciona o modelo usado pelo agente | Identificador exato disponível nesse endpoint e nessa conta |
| Suporte a imagens e ferramentas | Declara capacidades usadas pela configuração | Suporte real do modelo e do serviço |
Alguns provedores oferecem formatos compatíveis com clientes no estilo OpenAI, como explica a documentação de compatibilidade da Gemini API. Isso não torna intercambiáveis todos os endereços, protocolos ou identificadores. Um nome comercial de modelo também pode ser diferente do ID aceito pela API.
Trate a chave como segredo: use o campo próprio e oculte-a em capturas compartilhadas. A referência de autenticação da OpenAI descreve suas regras; outros provedores podem ter exigências próprias. Antes de trocar a credencial, confira se o erro aponta para autenticação, endpoint ou modelo.
Configure o provedor e as capacidades do modelo
Na FoneClaw, as predefinições de provedores on-line e os controles de suporte a imagens e ferramentas ajudam a configurar o modelo. Reúna a URL base, a chave e o ID disponíveis no provedor antes de alterar os campos.
- Abra as configurações de modelo na FoneClaw e escolha o caminho padrão ou personalizado.
- Use uma predefinição pertinente, quando disponível, e confira os valores.
- Informe a URL base compatível e a chave no campo próprio.
- Copie o ID exato do modelo aceito pela sua conta.
- Ajuste os controles de imagens e ferramentas conforme o suporte documentado.
- Salve e selecione o modelo que será usado.
- Valide texto, imagem e ferramenta nos testes separados abaixo.
Ativar suporte a imagens não transforma um modelo textual em modelo visual. Da mesma forma, marcar suporte a ferramentas não cria capacidade de chamadas de ferramentas no endpoint. Se você usa um gateway, confirme que ele encaminha as credenciais, o modelo e o formato das solicitações corretamente.
As capacidades da FoneClaw apresentam os recursos de configuração e execução. O projeto Android da FoneClaw também é uma referência pública do produto; para concluir a configuração, o essencial é validar o modelo e as ferramentas que você pretende usar.
Teste texto, imagem e ferramenta separadamente
Primeiro, teste apenas texto. Peça uma resposta curta e inofensiva, sem dados privados nem ação no telefone. Uma resposta confirma que aquela chamada chegou ao modelo e retornou conteúdo. Se falhar, investigue URL, credencial, ID, rede, acesso da conta e formato da API antes de alterar permissões Android.
Depois, teste uma imagem selecionada. Use uma foto não sensível com um detalhe verificável e peça uma descrição curta. Esse passo exige um modelo visual compatível e suporte a imagens configurado corretamente. A FoneClaw otimiza imagens grandes selecionadas e corrige sua orientação, mas o entendimento do conteúdo depende do modelo. Compare a resposta com a imagem original.
Por fim, teste uma ferramenta habilitada. Peça uma consulta de baixo risco, como verificar o volume de mídia ou o estado do Bluetooth. Confira se a ferramenta foi acionada e se o resultado corresponde ao Android. Uma resposta explicando como consultar volume não equivale à consulta executada.
O modelo selecionado interpreta o pedido; as ferramentas executam etapas suportadas conforme permissões, estado do app e política de aprovação efetiva. Para entender essa passagem, consulte Controlar telefone Android com agente de IA: da intenção à ação. Comece por leitura de estado antes de envio, exclusão ou alteração externa.
Identifique a camada que falha antes de tentar novamente
O erro da API e a falha de execução no telefone precisam de correções diferentes. Use a mensagem retornada pelo provedor e o resultado da ferramenta para localizar a etapa.
| Sintoma | Camada provável | Próxima verificação |
|---|---|---|
| 401 ou não autorizado | Credencial ou acesso da conta | Confira chave, validade e escopo sem expô-la |
| 404 | Endpoint, caminho ou ID do modelo | Compare a configuração com a documentação do serviço |
| Modelo indisponível ou retirado | Acesso ou ciclo de vida do modelo | Confira o ID disponível e o calendário do provedor |
| Tempo limite excedido | Rede ou serviço | Teste uma solicitação curta e confira a conexão |
| Texto funciona, imagem falha | Capacidade visual, formato ou configuração | Confira suporte do modelo e teste uma imagem simples |
| Texto funciona, ferramenta não é chamada | Chamadas de ferramentas ou ferramenta desabilitada | Confira suporte do endpoint e ferramentas habilitadas |
| Ferramenta é chamada, mas a ação falha | Permissão, estado do app ou alvo | Confira o requisito Android e o destino solicitado |
| A execução aguarda aprovação | Política configurada | Revise o alvo e o conteúdo antes de decidir |
Os códigos variam entre provedores e gateways. Uma chave válida não concede acesso a contatos, calendário ou notificações do telefone. Da mesma forma, conceder uma permissão Android não corrige um modelo que o endpoint deixou de oferecer.
Se a configuração já funcionava e o serviço está temporariamente indisponível, Falha do modelo do assistente de IA no Android: nova tentativa, modelo alternativo e retomada segura trata da recuperação desse cenário. Para exemplos de modelos e execução no telefone, os guias DeepSeek no Android: ele consegue controlar o celular de verdade? e O Grok pode controlar um celular Android? Chamadas, assistente e FoneClaw aprofundam essa distinção.
Confira o ciclo de vida do modelo antes de migrar
IDs de API precisam de manutenção. Na tabela oficial de descontinuação de modelos da Anthropic, claude-sonnet-4-5-20250929 foi marcado como descontinuado em 30 de setembro de 2026, com retirada prevista para 30 de novembro de 2026. A substituição recomendada é claude-sonnet-5-5. Descontinuado ainda significa funcional durante o período informado; após a retirada, solicitações ao modelo falham.
Essas datas se aplicam às plataformas operadas pela Anthropic. Parceiros podem seguir calendários próprios. Antes de trocar o ID, confira o modelo disponível na conta e o protocolo do endpoint configurado. A recomendação de Sonnet 5.5 não comprova que a API nativa Messages da Anthropic seja compatível com uma configuração que exige formato OpenAI.
Depois da mudança, repita os testes de texto, imagem e ferramenta que forem pertinentes. Para uma comparação mais ampla de critérios de escolha, Melhor modelo para agente de telefone: Kimi K3, DeepSeek V4 e GLM-5.2 trata do roteamento. Aqui, o objetivo é confirmar compatibilidade e continuidade da configuração, sem atribuir à troca de modelo novas permissões no Android.
Valide a configuração e retome ações pendentes
Com a configuração validada, faça primeiro uma consulta simples do estado do telefone. Depois retome a tarefa desejada, conferindo o alvo e o destino. O modelo interpreta e planeja; as ferramentas habilitadas executam dentro das permissões e da política de aprovação atual.
Se uma tarefa foi interrompida antes da migração, procure seu resultado antes de repetir. Uma mensagem pode ter sido enviada ou um evento criado mesmo que a resposta final não tenha chegado. O guia Como depurar e recuperar falhas de agentes de IA no celular Android ajuda a retomar somente a etapa pendente.
Use os recursos da FoneClaw para conferir o escopo suportado e a página de download da FoneClaw quando precisar instalar o produto. Uma configuração bem validada deixa claros três resultados: o modelo responde, interpreta a imagem quando compatível e consegue solicitar uma ferramenta cujo resultado você verifica no Android.