> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Usando o Ace Data Cloud no ChatBox > Platform API guide - Ace Data Cloud [ChatBox](https://chatboxai.app/) é um cliente de IA de código aberto compatível com Windows, macOS, Linux, iOS, Android e Web. Ele oferece suporte a provedores de serviços personalizados do tipo 「OpenAI API」, portanto pode integrar diretamente o Ace Data Cloud. Este artigo apresenta o processo de configuração. ## Processo de solicitação Para integrar o Ace Data Cloud no ChatBox, primeiro acesse o [Console do Ace Data Cloud](https://platform.acedata.cloud/console/applications), obtenha seu API Token e guarde-o para uso posterior. ![Obter a API Key do Ace Data Cloud](https://cdn.acedata.cloud/dvc3cg.jpg) Se você ainda não tiver feito login ou se registrado, será automaticamente redirecionado para a página de login, que o convidará a se registrar e fazer login; após o login e o registro, você retornará automaticamente à página atual. Na primeira solicitação, haverá uma cota gratuita oferecida, permitindo experimentar gratuitamente os serviços de modelos do Ace Data Cloud. ## Baixar o ChatBox Acesse o [site oficial do ChatBox](https://chatboxai.app/) para baixar conforme a plataforma, ou use diretamente a [versão Web](https://web.chatboxai.app/) que não requer instalação: * Desktop: Windows `.exe`, macOS `.dmg` (diferenciando Intel / Apple Silicon), Linux AppImage * Mobile: App Store, Google Play, link direto para Android no site oficial ## Configurar o Ace Data Cloud Inicie o ChatBox, entre em **Configurações → Modelo → Adicionar Provider personalizado**, defina **API Mode** como **OpenAI API Compatible**, e então preencha: | Campo | Valor | Descrição | | - | - | - | | Chave de API | Seu Token do Ace Data Cloud | Token copiado do console | | API Host | `https://api.acedata.cloud` | Preencha apenas o domínio raiz, **não inclua `/openai` ou `/v1`** | | API Path | `/v1/chat/completions` | O padrão do ChatBox é `/chat/completions`, é necessário alterá-lo manualmente para este | ![Interface de configuração do Provider Ace Data Cloud no ChatBox](https://cdn.acedata.cloud/3789c8e3dd4d.png) O caminho de requisição do ChatBox é `{API Host} + {API Path}`, portanto basta preencher o domínio raiz no Host: | API Host | Requisição final | Resultado | | - | - | - | | `https://api.acedata.cloud` | `https://api.acedata.cloud/v1/chat/completions` | Correto | | `https://api.acedata.cloud/openai` | `https://api.acedata.cloud/openai/v1/chat/completions` | 404 (não há `/v1` sob `/openai`) | | `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/v1/chat/completions` | 404 | O ChatBox não chama automaticamente `/v1/models`; é necessário preencher manualmente o ID do modelo (um por linha) na caixa de entrada 「Modelo personalizado」 na parte inferior da página de configurações de modelo. Após salvar, será possível selecioná-lo no menu suspenso de modelos da interface de conversa. Os interruptores de capacidade, a janela de contexto e o limite de saída devem ser preenchidos de acordo com o contrato atual do modelo selecionado, não copie os valores de outros modelos. ## Selecionar modelos O catálogo de modelos será atualizado continuamente. Priorize a lista de modelos carregada automaticamente pelo cliente; quando precisar preencher manualmente, primeiro solicite `GET https://api.acedata.cloud/v1/models` para obter o ID atual do modelo, e então escolha de acordo com as capacidades de contexto, imagens e chamadas de ferramentas suportadas pelo cliente. ## Verificar a integração Se não tiver certeza se o problema está no ChatBox ou na rede, você pode primeiro usar o curl para verificar diretamente o endpoint (substitua `{token}` pelo seu Token): ```bash theme={null} curl -X POST 'https://api.acedata.cloud/v1/chat/completions' \ -H 'Authorization: Bearer {token}' \ -H 'Content-Type: application/json' \ -d '{ "model": "MODEL_ID", "messages": [{"role": "user", "content": "ping"}] }' ``` O retorno de um objeto `chat.completion` compatível com OpenAI indica que tanto o Token quanto o endpoint estão prontos; se retornar `HTTP 403 used_up`, isso indica que o Token é válido, mas o saldo é insuficiente. Basta recarregar no [console](https://platform.acedata.cloud/console/applications). ## Perguntas frequentes ### Exibe 404 Not Found Normalmente, isso ocorre porque `/openai` ou `/v1` foi adicionado a mais no API Host. Preencha apenas `https://api.acedata.cloud` no Host e deixe o caminho para o padrão `/v1/chat/completions`. ### Exibe 401 / token\_mismatched Confirme que o que foi colado em 「Chave de API」 é o Token do Ace Data Cloud (sem o prefixo `Bearer`, sem espaços extras), e que o saldo da aplicação à qual ele pertence é suficiente. ### Não é possível ver modelos no menu suspenso de modelos O ChatBox não busca automaticamente a lista de modelos; é obrigatório preencher manualmente o ID do modelo na caixa 「Modelo personalizado」 e salvar. ### Quero gerar imagens no ChatBox A geração de imagens do Ace Data Cloud é uma Images API independente (`/openai/images/generations`), com um caminho diferente da interface de conversa, e a entrada de imagens do ChatBox não pode ser integrada diretamente. Se precisar gerar imagens, consulte a [documentação da API de geração de imagens](https://platform.acedata.cloud/documents/openai-images-generations) para chamar usando curl / SDK. ## Saiba mais * [Site oficial do ChatBox](https://chatboxai.app/) ｜ [GitHub do ChatBox](https://github.com/chatboxai/chatbox) * [Guia oficial do ChatBox para integrar serviços compatíveis com OpenAI (BYOK)](https://chatboxai.app/en/guide/byok/openai) * [Documentação da API OpenAI Chat Completions do Ace Data Cloud](https://platform.acedata.cloud/documents/openai-chat-completions) * [Documentação da API de geração de imagens do Ace Data Cloud](https://platform.acedata.cloud/documents/openai-images-generations) * [Lista de serviços do Ace Data Cloud](https://platform.acedata.cloud/documents) * [Console do Ace Data Cloud](https://platform.acedata.cloud/console) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.