Automação

Crie vídeos e conecte os resultados finalizados ao seu fluxo de trabalho por meio das assinaturas de conclusão do Reela CLI.

O Reela oferece comandos para produção de vídeos e assinaturas de conclusão para vídeos finalizados. Um agente ou outra ferramenta pode enviar um briefing e receber o resultado pelo daemon do CLI sem manter o site do Reela aberto.

Do briefing ao vídeoCopiar link da âncora

create transforma um briefing em texto e mídia opcional em uma tarefa de vídeo. Você pode fornecer um prompt diretamente ou lê-lo de um arquivo, escolher a duração e o formato, incluir avatares e anexar imagens de referência, filmagens ou música de fundo.

reela create --prompt-file brief.txt \
  --visual ai-video --layout portrait --duration 30 \
  --session "Product campaign" --output json

A geração de vídeo é uma tarefa de longa duração. Inicie o daemon e configure uma assinatura de conclusão antes de enviar a solicitação; o Reela executa a geração em segundo plano e entrega o resultado finalizado ao seu script. Reutilizar o título de uma sessão agrupa vídeos relacionados em um projeto. Consulte Entrega automática abaixo para ver como configurar.

Antes de enviar a solicitação, adicione --dry-run para validá-la e visualizar a estimativa de créditos, sem enviar arquivos nem criar uma tarefa. O envio de uma tarefa pode consumir créditos.

Consulte opções de criação de vídeos para ver os recursos visuais e as entradas de mídia compatíveis.

Escolha qualidade e custo com os níveisCopiar link da âncora

Os níveis permitem escolher a opção de geração para cada solicitação. O Reela fornece descrições que ajudam você ou um agente a selecionar uma opção adequada ao resultado desejado e, em seguida, estima os créditos dessa solicitação antes do envio.

reela tiers list
reela tiers list --output json

A lista mostra o rótulo e a descrição de cada nível e identifica o padrão. Na saída JSON, tiers contém entradas com label, content e is_default; default_tier indica o padrão. Leia content para entender cada opção, em vez de escolher com base na posição dela na lista. A listagem dos níveis não garante que sua conta possa usar todas as opções; o Reela verifica o acesso ao validar ou enviar uma solicitação.

Passe o rótulo exato para --tier. Substitua <tier-label> abaixo por um rótulo da sua lista, mantendo as aspas caso ele contenha espaços:

reela create --prompt-file brief.txt --visual ai-video \
  --tier "<tier-label>" --duration 30 --layout portrait \
  --dry-run --output json

A pré-visualização retorna credits_cost e quota_after. Para enviar a solicitação, remova --dry-run e mantenha o nível selecionado e as outras opções. Um nível descreve uma opção de geração; use a pré-visualização para estimar o custo da sua solicitação específica.

Se você omitir --tier, o Reela usará o padrão atual disponível para o CLI. Se nenhum padrão estiver disponível, execute reela tiers list para atualizar as opções ou informe um nível explicitamente. Selecionar um nível explicitamente mantém a escolha do seu fluxo de trabalho independente de alterações no padrão; a disponibilidade e os preços ainda podem mudar. Use o mesmo perfil para listar, pré-visualizar e enviar a solicitação.

Consulte a referência do comando de níveis para detalhes sobre a saída e o comportamento da seleção.

Resultados estruturados para agentes e ferramentasCopiar link da âncora

--output json disponibiliza os resultados dos comandos como dados estruturados, incluindo opções de níveis, estimativas de créditos e confirmações de envio. O código de saída 0 significa que o comando foi concluído com sucesso; erros usam códigos de saída diferentes de zero e texto simples em stderr, inclusive no modo JSON.

Após o envio bem-sucedido, o daemon aguarda a conclusão e invoca o script inscrito com o resultado. A resposta de envio e o evento de conclusão incluem um task_id para que seu fluxo de trabalho possa associar o vídeo finalizado ao briefing original.

Entrega automáticaCopiar link da âncora

O Reela CLI pode executar um programa seu quando uma tarefa de vídeo for concluída. Essa assinatura de conclusão conecta o resultado do Reela à sua próxima ação: encaminhar um vídeo para uma ferramenta de publicação, atualizar um registro ou notificar outro sistema. O Reela monitora a conclusão e fornece os detalhes da tarefa ao seu script.

Registre seu scriptCopiar link da âncora

Forneça um caminho absoluto para um executável na máquina que executa o Reela CLI. Ele pode usar qualquer linguagem, desde que leia o evento de stdin e indique sucesso por meio do código de saída.

reela subscribe add script --path /absolute/path/on-video \
  --timeout-seconds 300 --max-retries 3

Cada perfil tem uma assinatura de script. Para alterar o executável de uma assinatura existente, use reela config set delivery.script.path /absolute/path/on-video. Reinicie um daemon que já esteja em execução após alterar a assinatura ou suas configurações, conforme descrito abaixo.

Receba o evento de conclusãoCopiar link da âncora

O Reela inicia o executável e grava um objeto JSON em stdin:

{
  "event": "task.completed",
  "task_id": "12345",
  "status": "completed",
  "status_label": "completed",
  "title": "Product demo",
  "description": "A short product introduction",
  "download": {
    "filename": "product-demo.mp4",
    "download_url": "https://example.com/video.mp4"
  }
}

Use task_id para associar o evento ao envio original. title, description e download podem ser null. Quando presente, download fornece ao seu script o nome de arquivo sugerido e o URL de download do vídeo finalizado, para que ele possa consumi-los diretamente. Trate um valor download ausente antes de executar uma ação que exija o vídeo.

Os links download_url assinados expiram 6 horas após serem gerados. Baixe o vídeo ou copie-o para seu próprio armazenamento logo após receber o evento de conclusão. Mantenha os URLs de download privados e trate-os como links de acesso temporário, não como endereços permanentes do vídeo.

A assinatura recebe as tarefas concluídas da conta selecionada, incluindo vídeos criados fora do CLI. Se sua ação pertencer a um fluxo de trabalho específico, associe o ID da tarefa do evento às tarefas enviadas por você. No momento, as assinaturas de conclusão processam tarefas concluídas com sucesso; tarefas com falha, canceladas ou parciais não acionam esse evento.

Execução e novas tentativasCopiar link da âncora

• Sucesso: encerre com 0 após a conclusão bem-sucedida da ação. O Reela descarta o stdout do script; a saída impressa não é usada como resultado.
• Tempo limite: --timeout-seconds 300 permite até 300 segundos para cada execução. Um tempo limite ou uma saída diferente de zero faz a entrega falhar.
• Novas tentativas: o Reela tenta novamente entregar quando há uma falha. Quando apenas o método de script falha, --max-retries 3 permite três tentativas no total, incluindo a primeira. Falhas que envolvam outros métodos habilitados usam delivery.max_retries.
• Entrega repetida: torne as ações seguras para repetição para o mesmo task_id, para que outra execução não publique o mesmo vídeo nem acrescente o mesmo registro duas vezes.

Mantenha a assinatura em execuçãoCopiar link da âncora

O daemon do CLI processa os eventos de conclusão e executa os métodos de entrega habilitados. Depois de escolher os métodos, inicie o daemon e confira o status da entrega:

reela daemon start
reela subscribe status

Adicionar um método também tenta iniciar um daemon parado. Se ele já estiver em execução, reinicie-o após alterar as configurações de entrega para que elas entrem em vigor. Para um daemon iniciado manualmente, use reela daemon stop seguido de reela daemon start.

O Reela salva o progresso da entrega e retoma a partir dele quando o daemon é reiniciado. Sem progresso salvo, ele processa novos eventos por padrão. reela daemon start --keep-backlog também processa eventos de tarefas concluídas anteriormente que ainda estejam disponíveis quando não houver progresso salvo.

Use reela daemon install para habilitar a inicialização ao entrar na sessão. Se estiver instalado como serviço, reinicie-o pelo gerenciador de serviços do seu sistema operacional após alterações na configuração. Consulte reela daemon status ou reela daemon logs --tail 50 para inspecionar a entrega.

A entrega automática exige que a máquina que executa o daemon permaneça ligada e conectada. Inicie-o antes de enviar vídeos cuja conclusão deva acionar seu script.

daemon e subscribe estão disponíveis no Linux e no macOS. O Windows x64 é compatível com comandos de vídeo, consultas de status e downloads manuais.

Entrega opcional de downloads e e-mailsCopiar link da âncora

Você pode habilitar downloads automáticos ou e-mails com vídeos concluídos junto com seu script. Os downloads estão habilitados nas configurações de entrega padrão; defina o destino com reela config set delivery.download ~/Videos/reela. Se estiverem desabilitados, habilite-os com reela subscribe add download --dir ~/Videos/reela. Habilite o e-mail com reela subscribe add email e, opcionalmente, adicione --address me@example.com para usar um endereço diferente do e-mail da sua conta.

Vários métodos podem estar ativos ao mesmo tempo, e a falha de um método não impede a execução dos outros. Cada execução do script recebe sua própria carga de conclusão, incluindo informações de download quando disponíveis. Consulte a referência do comando de entrega para ver todos os métodos.

Reutilize sua configuração de produçãoCopiar link da âncora

O Reela oferece recursos adicionais que podem se tornar etapas do seu fluxo de trabalho:

• Identidade visual consistente: liste os pacotes de marca existentes com brand list e aplique um deles a uma tarefa com brand apply. O comando aguarda a saída com a marca aplicada. Consulte os comandos de marca.
• Edição programática: baixe o JSON de edição, valide as alterações, salve um rascunho para pré-visualização e envie uma renderização com edit. Consulte os comandos de edição.
• Contas e preferências separadas: selecione um perfil com --profile ou REELA_PROFILE. Os métodos e as configurações de entrega se aplicam ao perfil selecionado. Consulte perfis e configuração.

Por exemplo, um fluxo de trabalho de vídeo de produto pode enviar um briefing com imagens de referência e usar uma assinatura de conclusão do daemon para encaminhar o vídeo finalizado à sua ferramenta de publicação. O Reela oferece geração em segundo plano e entrega na conclusão; sua ferramenta decide quando enviar a solicitação e que ação executar quando o resultado chegar.

Consulte a referência do comando de entrega para ver todas as opções de assinatura e daemon. Para instalação e autorização da conta, comece por Primeiros passos.