Ative o acesso pelo celular.
Abra o Chrome no Android ou o Safari no iPhone. Tenha em mãos o código de ativação (CDK) recebido no pedido. Ative o acesso e crie a chave no portal do provedor.
- Ative o seu CDK.
Abra api.mwapi.dev/usage e informe o código recebido.
- Crie a API Key.
Entre em api.mwapi.dev/keys, crie a chave e copie o valor completo.
- Confira seu saldo.
Consulte api.mwapi.dev/reseller e informe sua chave para ver o saldo restante de tokens.
https://api.mwapi.devCDK ativa o acesso; API Key conecta o aplicativo. Se você já ativou o acesso, use uma chave válida da sua conta. Nos exemplos, YOUR_API_KEY representa a sua chave. Substitua pelo valor completo, sem espaços extras. Sua chave é uma credencial: oculte-a em capturas de tela.
Configure no Android.
Instale o Chatbox oficial e escolha o uso com sua própria API Key, também chamado BYOK.
Instalar na Google Play- Abra o aplicativo.
Na primeira abertura, escolha Skip guide (Pular guia), caso essa opção apareça, para seguir pela configuração manual.
- Abra os provedores de modelos.
Toque no menu do canto superior esquerdo e entre em Settings → Model Provider (Configurações → Provedor de modelos).
- Adicione a sua conexão.
Toque em Add ou Add Provider. Nomeie como SNOOZE API e selecione OpenAI API compatible ou Custom OpenAI, no formato Chat Completions.
- Preencha os campos e adicione o modelo.
Use os dados da conexão abaixo. Busque um Model ID liberado no MWAPI ou adicione o ID manualmente. Salve e use Check, quando disponível.
- Abra uma nova conversa.
Selecione o provedor SNOOZE API e o modelo configurado. Envie uma mensagem curta para testar.
Na loja, procure Chatbox AI: Powerful AI Client. Os nomes dos menus podem variar conforme a versão instalada.
Configure no iPhone.
Use o Chatbox para configurar sua chave e conversar pelo celular. A versão consultada exige iOS 16 ou posterior.
Instalar na App Store- Instale e abra o Chatbox.
Toque em Obter na App Store. Ao abrir, escolha Skip guide, se exibido, para usar a configuração manual com API Key própria.
- Entre nas configurações de modelos.
Abra o menu do canto superior esquerdo e siga Settings → Model Provider. Toque em Add ou Add Provider.
- Crie o provedor SNOOZE API.
Escolha OpenAI API compatible ou Custom OpenAI para Chat Completions. Preencha a URL, o caminho e a chave conforme a próxima seção.
- Adicione um Model ID disponível.
Use o ID liberado para a sua chave no painel do MWAPI. Salve e toque em Check, quando o botão estiver disponível.
- Selecione a conexão no novo chat.
Volte à tela de conversa, escolha SNOOZE API e o modelo configurado. Envie “Olá, responda em português.” e aguarde.
Na App Store, o nome é Chatbox - Powerful AI Client. O link acima leva ao aplicativo indicado pelo site oficial.
Preencha a conexão.
Use o formato de Chat Completions indicado no guia. Quando houver campos separados para host e caminho, preencha assim:
- Nome do provedor
- SNOOZE API
- Tipo de API
- OpenAI API compatible / Custom OpenAI — Chat Completions
https://api.mwapi.dev/v1/chat/completions- API Key
- Cole a chave completa criada no portal do MWAPI.
- Model ID
- Copie um ID liberado para a sua chave. O guia de origem usa
claude-sonnet-5como exemplo; confirme a disponibilidade no seu painel.
Se houver uma opção separada chamada Responses, mantenha Chat Completions para seguir este tutorial. Sua API Key deve ser inserida diretamente no Chatbox.
Minha versão mostra apenas Base URL
Use a URL base terminada em /v1 e mantenha o caminho padrão /chat/completions, quando exibido.
https://api.mwapi.dev/v1O endereço final deve conter /v1 apenas uma vez:
https://api.mwapi.dev/v1/chat/completionsEnvie sua primeira mensagem.
Abra um novo chat, selecione SNOOZE API e escolha o modelo cadastrado. Você pode começar com:
Olá, responda em português e me ajude a escrever uma resposta educada para um cliente.A resposta confirma o funcionamento da chave, do modelo e da conexão em conjunto. O uso segue o saldo e as condições do acesso contratado.
Depois, use na sua rotina
- Escrever e revisar mensagens para clientes.
- Resumir textos e organizar ideias.
- Preparar descrições de produtos e respostas de atendimento.
Se aparecer um erro.
Chave inválida ou erro 401
Copie a API Key completa novamente, confira espaços extras e confirme a ativação. O CDK é usado no portal; o aplicativo precisa da API Key.
Endereço não encontrado ou erro 404
Confira o endereço final da conexão. O trecho /v1 deve aparecer uma única vez. Revise a combinação de API Host e API Path.
Modelo inexistente ou sem permissão
Use um Model ID liberado para a sua chave. Se a mensagem informar restrição a um cliente específico, entre em contato com o suporte do provedor.
Saldo insuficiente ou limite de uso
Consulte seu saldo no portal do MWAPI. Se o erro informar limite de frequência, aguarde antes de enviar novamente.
Documentação consultada
- Configuração de provedores personalizados no Chatbox
- Configuração manual e chave própria no celular
- Downloads oficiais do Chatbox
Precisa de ajuda?
Envie o aplicativo, a versão instalada e a mensagem de erro, com a API Key ocultada. Se comprou com um revendedor, fale com ele pela página do pedido.