Entenda status de tarefas da Rivya, reserva de créditos, envio a provedores, callbacks, polling, histórico, notificações, falhas e créditos.

Use este guia quando precisar entender o que acontece depois de enviar uma tarefa de geração de imagem, vídeo ou áudio na Rivya.

Ele explica estados de tarefa, reserva de créditos, conclusão por provedor, histórico, notificações e tratamento de tarefas com falha em um só lugar.

Os Estados Reais Da Tarefa

O ciclo de vida atual de geração assíncrona usa quatro estados visíveis:

WAITING
GENERATING
SUCCESS
FAILED

Esses estados são armazenados em ai_task e reutilizados nos fluxos de Studio, histórico, dashboard e notificações.

O Que Acontece Quando Você Envia

1. A Rivya valida a solicitação

Antes de qualquer coisa chegar a um provedor, a Rivya verifica:

se o modelo existe
se geração direta está habilitada para esse modelo
se o runtime é baseado em async-task
se o tamanho do prompt é válido
se os parâmetros do formulário são normalizados
se os arquivos de referência combinam com o que o modelo aceita

Alguns modelos têm regras extras. Por exemplo, isolamento de áudio exige um arquivo de áudio enviado mais verificação de duração.

2. A Rivya cria o registro da tarefa

A Rivya cria primeiro uma entrada ai_task, com status WAITING.

Esse registro armazena o modelo, categoria, prompt, params, créditos reservados, tipo de cobrança e depois o resultado ou estado de falha.

3. Créditos são consumidos antes do envio ao provedor

Isto é importante: para geração assíncrona, a Rivya gasta os créditos da tarefa antes de enviar o trabalho upstream.

Se os créditos forem baixos demais:

a tarefa é marcada como falha
o serviço upstream nunca é chamado
uma notificação de créditos insuficientes pode ser criada

4. O trabalho do provedor é criado

Se houver créditos disponíveis, a Rivya envia a tarefa ao serviço upstream correspondente e armazena o ID da tarefa upstream.

Nesse ponto, o status passa para GENERATING.

Como A Rivya Descobre O Resultado

A Rivya oferece suporte a dois caminhos de conclusão:

callback do provedor em ambientes com callback habilitado
atualização de status e polling quando conclusão por callback não está disponível

O caminho de callback também verifica a assinatura do webhook antes de finalizar uma tarefa.

Se um callback chegar antes de o resultado do provedor estar totalmente pronto, a Rivya pode adiar e tentar novamente verificando o status upstream.

Caminho De Sucesso

Em caso de sucesso, a Rivya:

armazena URLs de resultado
define o status como SUCCESS
liquida a tarefa
disponibiliza a saída no histórico de gerações
cria uma notificação de sucesso de geração

É por isso que uma imagem ou vídeo concluído continua visível depois que você sai da página.

Caminho De Falha

Em caso de falha, a Rivya:

armazena a mensagem de erro
define o status como FAILED
reembolsa créditos quando a falha aconteceu depois da reserva e deve ser revertida
cria uma notificação de falha de geração para revisão durável

Isso é diferente de um toast temporário. A falha se torna parte do registro da conta.

Onde Você Vê O Estado Da Tarefa

A mesma tarefa pode aparecer em vários lugares:

o Studio ativo enquanto ela está em execução
Histórico depois que ela é liquidada
Central de Notificações para resultados importantes
/dashboard em gerações recentes

Esse estado compartilhado é um dos motivos pelos quais o produto parece coerente em vez de descartável.

Como Chat Difere

Chat também é cobrável, mas não usa o mesmo registro de tarefa assíncrona. Turnos de chat são armazenados como:

sessões de chat
mensagens de chat

Para modelos de chat baseados em tokens, a Rivya pode reservar créditos primeiro e depois liquidar o valor final após o retorno do uso. Se o valor final for menor, a diferença é reembolsada.

Então a regra ampla é:

geração de imagem, vídeo e áudio usa ai_task
chat usa sessões salvas e liquidação no nível de mensagem

Checklist De Estado Da Tarefa

Quando uma geração estiver confusa, lenta, com falha ou ausente, confira:

Identifique primeiro o tipo de tarefa: liquidação de chat, imagem, vídeo, áudio ou chat apoiado por ferramenta.
Confira se créditos foram reservados antes do envio ao provedor ou liquidados após uso.
Procure callback do provedor, resultado de polling, item de histórico e notificação antes de presumir que o resultado foi perdido.
Separe falhas corrigíveis pelo usuário de falhas de provedor ou infraestrutura.
Confirme se uma tarefa com falha deve reverter créditos antes de executar novamente o mesmo prompt.

Reconfira Antes De Executar Novamente

Reconfira quando o mesmo prompt continuar falhando, uma tarefa ficar em andamento por tempo demais, créditos parecerem consumidos sem saída ou você estiver prestes a enviar uma execução duplicada mais pesada.

Guia do Ciclo de Vida de Tarefas da Rivya