Guia de Solução de Problemas da Rivya

Use este guia de solução de problemas quando chat, uploads, tarefas de geração, histórico, notificações, créditos ou estado de cobrança da Rivya não se comportarem como esperado.

Quando a Rivya parece quebrada, a correção mais rápida é decidir qual camada está realmente falhando.

A maioria dos problemas cai em um de cinco lugares:

• acesso e login
• incompatibilidade de modelo ou entrada
• estado de tarefa assíncrona
• estado da carteira ou pagamento
• busca de trabalho salvo

Essa divisão é muito mais útil do que tratar tudo como um "bug" genérico.

1. Chat Não Envia

Se o chat não roda de fato, confira primeiro as causas simples:

• você talvez ainda esteja em um fluxo público de landing page e precise fazer login antes de enviar
• a mensagem em rascunho pode estar vazia
• a sessão salva pode não ter carregado corretamente

Se o problema for específico da sessão, reabra a conversa pelo Histórico em vez de adivinhar em qual caminho você estava.

Se a tarefa for estreita e repetitiva, também pode ser mais limpo recomeçar por uma entrada de ferramenta em vez de continuar em uma thread ampla de chat simples.

2. Uma Geração Não Começa

Se geração de imagem, vídeo ou áudio falha antes de realmente começar, as causas comuns são:

• conteúdo obrigatório do prompt está ausente
• um formulário de áudio em estilo de diálogo está incompleto
• o modelo selecionado exige um arquivo de referência e nenhum foi fornecido
• a conta não tem créditos suficientes

Agora, créditos insuficientes podem fazer a execução falhar antes de o serviço upstream ser chamado. É por isso que a sensação de "nada aconteceu" ainda pode deixar um registro real de falha e uma notificação.

3. Uploads Falham

Uploads são guiados por modelo, não por categoria.

Isso significa:

• nem todo modelo de uma categoria aceita os mesmos tipos de referência
• nem todo modelo aceita o mesmo número de arquivos
• limites de tamanho e tipo são aplicados antes da solicitação real de geração

Se um upload falhar, confira:

• se o modelo oferece suporte a esse tipo de arquivo
• se você já atingiu o limite atual de arquivos de referência
• se o tipo ou tamanho do arquivo viola as regras atuais de upload

Se o fluxo for limpeza ou isolamento de áudio, lembre que caminhos de áudio enviado são estruturalmente diferentes de TTS ou geração de voz prompt-first.

4. Tarefa Travada Em Andamento

Execuções de imagem, vídeo e áudio são tarefas assíncronas na Rivya.

Os estados visíveis são:

• WAITING
• GENERATING
• SUCCESS
• FAILED

Se uma tarefa parecer travada, não observe apenas a página atual.

Confira também estas superfícies:

• o Studio ativo
• Histórico
• Central de Notificações
• gerações recentes em /dashboard

Algumas tarefas terminam por callback, outras por polling ou atualização. Então "ainda gerando" não significa por si só "perdida". Muitas vezes significa que a tarefa ainda espera o resultado upstream final ser liquidado.

5. Uma Tarefa Falhou

Falha na Rivya geralmente é preservada, não escondida.

Uma tarefa com falha pode manter:

• o próprio status de falha
• uma mensagem de erro
• estado de reembolso, quando os créditos reservados devem ser revertidos
• uma notificação de geração com falha

Isso significa que o próximo passo certo geralmente é:

1. ler o estado de falha
2. decidir se o problema foi créditos, prompt ou incompatibilidade de entrada
3. executar novamente somente depois de corrigir essa causa específica

Não trate toda falha como um problema transitório de UI.

6. Resultado Parece Ter Sumido

Normalmente o resultado não sumiu. Ele está apenas na superfície errada.

Use Histórico quando a pergunta for:

Use Central de Notificações quando a pergunta for:

A regra ampla é:

• chat retorna ao histórico de chat
• imagem, vídeo e áudio retornam ao histórico de gerações
• eventos de cobrança e créditos muitas vezes aparecem com mais clareza em notificações

7. Estado De Pagamento Parece Antigo

Se o checkout terminou, mas carteira ou estado de cobrança ainda parecem desatualizados, siga o caminho de cobrança antes de presumir que o pagamento foi perdido.

O fluxo atual do produto é:

1. concluir checkout
2. retornar por /payment
3. deixar o produto fazer polling e atualizar estado de cobrança ou carteira
4. verificar /settings/billing ou /settings/credits

Notificações também podem preservar resultados de cobrança, então vale verificá-las quando o estado da conta parece fora de sincronia.

8. Onde Conferir Primeiro

Use este atalho:

• Studio atual: trabalho ao vivo em andamento
• Histórico: saídas salvas e conversas salvas
• Central de Notificações: eventos operacionais que já aconteceram
• /settings/billing: estado da assinatura
• /settings/credits: saldo da carteira, pacotes, expiração e transações

A maior parte da confusão vem de verificar primeiro a camada errada.

Leia A Seguir

• Ciclo de Vida de Tarefas na Rivya
• Fluxos de Imagem na Rivya
• Fluxos de Vídeo na Rivya
• Fluxos de Áudio na Rivya
• Referências e Uploads na Rivya
• Créditos e Cobrança na Rivya

Checklist De Triagem De Solução De Problemas

Escolha o primeiro lugar para verificar antes de repetir a mesma ação:

• Chat não envia: confira login, estado da sessão, disponibilidade do modelo e comportamento de créditos.
• Uploads falham: confira tipo de arquivo, tamanho, suporte do modelo e se a tarefa realmente precisa de arquivo.
• Geração está travada: confira status da tarefa, callbacks de provedor, polling, histórico e notificações.
• Cobrança parece desatualizada: confira retorno do Checkout, liquidação de webhook, configurações de cobrança e configurações de créditos.
• Resultados parecem ausentes: confira o tipo correto de histórico e se a tarefa realmente foi concluída.

Reconfira Antes De Escalar

Escale apenas depois de conseguir nomear a área da conta, id da tarefa ou contexto de pagamento, resultado esperado, resultado real e o último estado visível. Isso transforma suporte em diagnóstico em vez de adivinhação.