---
title: "Importação e configuração do Chatbox em um clique"
description: "Importe o Chatbox pela página da Chave de API e verifique o API Host, caminho, modelo e chave."
headingIds: {"Importação em um clique":"section-1","Área de transferência e configuração manual":"section-2","Solução de problemas":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
A partir do Chatbox 1.15.1, há suporte a JSON de provedor e `chatbox://provider/import`. A versão desktop precisa ser instalada e iniciada uma vez antes. Para a versão web ou sistemas sem registro de protocolo, use a importação pela área de transferência.

## Importação em um clique

1. Abra **Chave de API** no console, encontre a chave que deseja usar e acesse **Ferramentas de uso → Chatbox**.
2. Selecione o modelo de chat disponível para esta chave e clique em **Abrir Chatbox**, permitindo que o navegador abra o aplicativo.
3. Confirme a importação no Chatbox e verifique o endereço do provedor e o modelo. Se já existir uma configuração com o mesmo nome, confirme primeiro o escopo da substituição.
4. Envie uma mensagem curta e confirme o modelo e o horário da solicitação nos registros de chamadas deste site.

## Área de transferência e configuração manual

Se o aplicativo não for aberto, copie o **Chatbox JSON** no mesmo painel e, na gestão de provedores das configurações do Chatbox, escolha importar pela área de transferência. Antes de compartilhar com outras pessoas, é obrigatório remover `settings.apiKey`.

| Campo | Valor |
| --- | --- |
| Tipo | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | chave atual |
| Model ID | modelo de chat disponível para a chave atual |

Preencha Host e Path separadamente; não adicione `/v1` aos dois campos ao mesmo tempo. Se não houver modelo, obtenha primeiro a lista de modelos ou adicione manualmente; capacidades como imagens, embeddings e chamadas de ferramentas devem ser verificadas separadamente; não trate qualquer modelo como modelo de chat.

## Solução de problemas

- O aplicativo não abre: confirme que foi instalado e iniciado, desbloqueie este protocolo no navegador ou use a importação pela área de transferência.
- 401 após a importação: verifique se a chave é válida e se não há espaços.
- 404: confirme que o caminho final é `/v1/chat/completions` e que não houve concatenação duplicada.
- Modelo inexistente: use o ID exato da lista de modelos; não deduza pelo apelido de exibição.

Oficial: [protocolo de importação de configuração](https://docs.chatboxai.app/guides/providers/import-config), [código-fonte do cliente](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).

<Note> verificado com o protocolo e materiais oficiais em 2026-10-19. Este site já implementou a geração de configuração e testes de regressão no frontend; não concluiu a verificação de inferência real em todos os clientes, sistemas e modelos. Após atualizar o cliente, verifique novamente. A integração personalizada não representa parceria oficial nem recomendação incorporada. </Note>

Mais: [Chave de API](/pt/docs/api-keys/), [lista de modelos](/pt/docs/models/), [registros de chamadas](/pt/docs/usage-logs/), [explicação de endereços](/pt/docs/base-url/).