Guia do Ciclo de Vida de Tarefas da Rivya

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

Leia A Seguir

• Fluxos de Imagem na Rivya

• Fluxos de Vídeo na Rivya

• Fluxos de Áudio na Rivya

• Créditos e Cobrança

• Solução de Problemas na Rivya

• Histórico

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.