Perguntas Frequentes

Este documento foi traduzido do chinês por IA e ainda não foi revisado.

Perguntas Frequentes

Códigos de Erro Comuns

• 4xx (Códigos de status de erro do cliente): Geralmente indicam erros de sintaxe na solicitação, falha de autenticação ou problemas que impedem o processamento da requisição.

• 5xx (Códigos de status de erro do servidor): Geralmente indicam problemas no lado do servidor, como servidor indisponível, tempo limite de processamento, etc.

Código de Erro	Possíveis Causas	Soluções
400	Formato incorreto do corpo da solicitação, entre outros	Verifique o conteúdo do erro na resposta da conversa ou no console para ver detalhes do erro e siga as instruções. [Caso comum 1]: Para modelos Gemini, pode ser necessário vincular um cartão; [Caso comum 2]: Dados excedem o limite de tamanho, comum em modelos visuais. Imagens maiores que o limite superior retornam este erro; [Caso comum 3]: Parâmetros não suportados ou incorretos. Teste com um novo assistente limpo; [Caso comum 4]: Contexto excede o limite. Limpe o histórico ou inicie uma nova conversa.
401	Autenticação falhou: modelo não suportado ou conta suspensa no servidor	Entre em contato com o provedor de serviços ou verifique o status da conta
403	Sem permissão para a operação solicitada	Execute ações conforme o erro na resposta da conversa ou informações do console
404	Recurso não encontrado	Verifique o caminho da solicitação
422	Sintaxe correta, mas erro semântico	Erros processáveis mas não executáveis. Comum em erros de semântica JSON (ex: valor nulo; esperado string, mas número/booleano fornecido).
429	Limite de taxa de solicitação excedido	Taxa (TPM/RPM) atingiu o limite máximo. Aguarde antes de tentar novamente
500	Erro interno do servidor, solicitação não processada	Contate o provedor se persistir
501	Funcionalidade não implementada pelo servidor
502	Resposta inválida recebida de servidor remoto pelo gateway/proxy
503	Serviço indisponível (sobrecarga/manutenção). O cabeçalho Retry-After indica tempo de espera.
504	Gateway/proxy não obteve resposta do servidor remoto a tempo

---

Como Verificar Erros no Console

• Clique na janela do cliente Cherry Studio e pressione Ctrl + Shift + I (Mac: Command + Option + I)

• A janela ativa deve ser a do cliente Cherry Studio para abrir o console;

• Abra o console ANTES de testar ou iniciar solicitações para coletar informações.

• Na janela do console: Clique em Network → Selecione a última entrada com × vermelho em ② (completions para diálogo/tradução/erros de modelo ou generations para pintura) → Clique em Response para ver o conteúdo completo (área ④).

Se não conseguir identificar o erro, envie um print desta tela para o Grupo oficial.

Este método funciona para diálogos, testes de modelo, criação de bases de conhecimento, pintura, etc. Sempre abra o console ANTES de realizar a operação.

Nomes diferentes em "Name" (área ②):

Diálogo/Tradução/Verificação: completions Pintura: generations Criação de Base: embeddings

---

Fórmula Não Renderizada/Erro na Renderização

• Fórmulas exibidas como código? Verifique delimitadores:

Uso de Delimitadores

Fórmula em linha

• Cifrão simples: $fórmula$

• Ou \(fórmula\)

Bloco de fórmula

• Cifrão duplo: $$fórmula$$

• Ou \[fórmula\]

• Exemplo: $$\sum_{i=1}^n x_i$$ $\sum_{i=1}^n x_i$

• Erros de renderização com caracteres chineses? Troque o mecanismo para KateX.

---

Falha ao Criar Base de Conhecimento/Dimensão de Embedding

1. Modelo indisponível

Confirme suporte do provedor ou status do serviço.

1. Uso de modelo não compatível com embedding

---

Modelo Não Reconhece Imagens/Falha no Upload/Seleção

Verifique suporte à visão: modelos compatíveis têm ícone de olho 👁️ após o nome.

Modelos visuais permitem upload de imagens. Se a função não estiver ativada:

• Acesse os modelos do provedor

• Clique no ícone de configuração

• Marque a opção de imagem

Modelos sem suporte visual não processarão imagens, mesmo com a opção ativada. Consulte informações específicas com seu provedor.