> ## 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 NextChat

> Platform API guide - Ace Data Cloud

[NextChat](https://github.com/ChatGPTNextWeb/NextChat) (anteriormente ChatGPT-Next-Web) é um cliente de IA de código aberto que pode ser implantado no Vercel, Cloudflare ou Docker. Ele oferece suporte a endpoints personalizados compatíveis com OpenAI, portanto pode ser integrado ao Ace Data Cloud. Este artigo apresenta o processo de configuração.

## Processo de solicitação

Para integrar o Ace Data Cloud no NextChat, 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 estiver conectado ou registrado, será redirecionado automaticamente para a página de login, convidando você a se registrar e entrar. Após fazer login ou se registrar, 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 NextChat

Você pode usar a versão para desktop (baixe `.exe` / `.dmg` / AppImage na [página de Releases](https://github.com/ChatGPTNextWeb/NextChat/releases)), a [versão Web online](https://app.nextchat.club/), ou fazer a implantação por conta própria no Vercel / Cloudflare / Docker (consulte a seção avançada abaixo).

## Configurar o Ace Data Cloud

Inicie o NextChat e acesse **Configurações → Serviço de modelos**:

| Campo | Valor | Descrição |
| - | - | - |
| Provedor de serviço de modelos | `OpenAI` | Usa o protocolo compatível com OpenAI |
| Endereço da API OpenAI | `https://api.acedata.cloud` | Preencha apenas o domínio raiz, **sem `/openai`, sem `/v1`** |
| API Key | Seu Token do Ace Data Cloud | Token copiado do console |

![Interface de configuração do Ace Data Cloud no NextChat](https://cdn.acedata.cloud/47e0aed34570.png)

O NextChat adicionará automaticamente `/v1/chat/completions` após o endereço da API, portanto basta preencher o domínio raiz:

| Endereço da API | Solicitação real | 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` em `/openai`) |
| `https://api.acedata.cloud/openai/v1` | `https://api.acedata.cloud/openai/v1/v1/chat/completions` | 404 |

Na caixa «Nome do modelo personalizado», preencha os modelos separados por vírgulas em inglês. O NextChat oferece suporte a sintaxe especial: `+nome_do_modelo` para adicionar, `-nome_do_modelo` para ocultar, `nome_do_modelo=nome_de_exibição` para personalizar o nome de exibição, e `-all` para ocultar todos primeiro. A forma mais limpa recomendada é:

```text theme={null}
-all,+MODEL_ID=显示名称
```

## Selecionar modelos

O catálogo de modelos será atualizado continuamente. Dê prioridade à lista de modelos carregada automaticamente pelo cliente; quando precisar preencher manualmente, primeiro faça uma solicitação a `GET https://api.acedata.cloud/v1/models` para obter o ID atual do modelo e, em seguida, escolha conforme os recursos de contexto, imagens e chamadas de ferramentas suportados pelo cliente.

## Verificar a integração

Se não tiver certeza se o problema está no NextChat ou na rede, você pode primeiro usar 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).

## Avançado: implantação com um clique no seu próprio domínio

O NextChat oferece suporte à implantação de um site de IA próprio. Usando Docker como exemplo (substitua `{token}` pelo seu Token):

```bash theme={null}
docker run -d \
  --name nextchat \
  -p 3000:3000 \
  -e OPENAI_API_KEY={token} \
  -e BASE_URL=https://api.acedata.cloud \
  -e CODE=your-password \
  -e CUSTOM_MODELS="-all,+MODEL_ID=显示名称" \
  yidadaa/chatgpt-next-web
```

Ao implantar no Vercel / Cloudflare, basta configurar as mesmas variáveis de ambiente `OPENAI_API_KEY`, `BASE_URL`, `CODE` e `CUSTOM_MODELS` no projeto. `CODE` oferece suporte a várias senhas de acesso separadas por vírgulas em inglês, facilitando a contagem de uso por pessoa. Para a descrição completa das variáveis de ambiente acima (o padrão de `BASE_URL` é `https://api.openai.com`, e a sintaxe `+/-/=/-all/+all` de `CUSTOM_MODELS`), consulte o [README oficial do NextChat](https://github.com/ChatGPTNextWeb/NextChat#environment-variables).

## Perguntas frequentes

### Exibe 404 Not Found

Normalmente, o endereço da API foi escrito como `.../openai` ou `.../openai/v1`. Altere para `https://api.acedata.cloud` e deixe o NextChat adicionar `/v1/chat/completions` por conta própria.

### O modelo adicionado não aparece na lista suspensa de modelos

Verifique o formato de `CUSTOM_MODELS`: cada modelo deve ter um `+` antes dele; se você usou `-all`, certifique-se de adicionar novamente os modelos necessários com `+` depois.

### Exibe 401 Unauthorized

Confirme que a API Key contém o Token do Ace Data Cloud (sem o prefixo `Bearer` e sem espaços extras) e que o saldo do aplicativo correspondente é suficiente.

## Saiba mais

* [NextChat GitHub](https://github.com/ChatGPTNextWeb/NextChat) ｜ [Versão online do NextChat](https://app.nextchat.club/)
* [Descrição oficial das variáveis de ambiente do NextChat (README)](https://github.com/ChatGPTNextWeb/NextChat#environment-variables)
* [Documentação da API OpenAI Chat Completions do Ace Data Cloud](https://platform.acedata.cloud/documents/openai-chat-completions)
* [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.