Armazenar referências de vídeo

Criar um bucket R2

1. No painel da Cloudflare em inglês, abra Storage & databases → R2 Object Storage. A lista de buckets será aberta diretamente. No primeiro uso, ative o R2 e confira a cobrança; os custos de armazenamento são separados dos custos do Orqra e dos modelos.

   

2. Escolha Create bucket. Digite orqra-video-inputs em Bucket name, deixe Location em Automatic e escolha Standard em Default Storage Class.

   

3. Escolha Create bucket e confirme que orqra-video-inputs aparece na lista de buckets. Mantenha-o privado; não é necessário ativar o acesso público r2.dev nem adicionar um domínio personalizado.

• Abrir painel do R2
• Ativar R2 no Cloudflare
• Etapas oficiais para criar um Bucket

Preencher a configuração básica

1. Na página principal de R2 Object Storage, localize a linha S3 API em Account Details e clique no ícone de cópia à direita.

   Exemplo: https://example-account-id.r2.cloudflarestorage.com. Este é apenas um endereço de conta de exemplo e não contém o nome do bucket. Use o valor original que você copiou da sua própria conta.

   

2. No Orqra Desktop, abra Configurações → Dados e armazenamento → Armazenamento de mídia HTTPS. Cole o endereço copiado sem alterações em Endpoint e digite o nome do bucket criado separadamente em Bucket. Mantenha os demais valores padrão do R2 conforme a tabela. Deixe Access Key ID e Secret Access Key vazios por enquanto. Mantenha esta página de configurações aberta para adicionar as credenciais e salvar tudo junto quando obtê-las.

   Configuração básica do R2

   Campo no Orqra	O que preencher / onde encontrar
   Endpoint	Copie o endereço em Account Details → S3 API e cole aqui sem alterações. Não use a URL do painel nem um endereço público r2.dev.
   Região	auto
   Bucket	Digite apenas o nome do seu bucket, por exemplo orqra-video-inputs.
   Prefixo de objetos temporários	orqra-transient/ — deve corresponder ao prefixo da regra de exclusão automática que você configurará mais adiante.
   Session Token	Deixe vazio na primeira configuração com as credenciais R2 comuns deste guia.
   Validade da URL assinada (segundos)	21600 (6 horas): validade do link de download, não o momento de exclusão do arquivo.
   Usar URLs Path-Style	Mantenha ativado.

• Guia oficial de configuração S3

Criar credenciais de acesso

1. Na página R2 Object Storage, escolha Manage API Tokens em Account Details.

   

2. Na seção User API Tokens, escolha Create User API token.

   

3. No formulário Create User API Token, digite orqra-video-inputs em Token name. Em Permissions, selecione Object Read & Write.

   Em Specify bucket(s), selecione Apply to specific buckets only e escolha orqra-video-inputs, o mesmo bucket criado acima.

   TTL vem definido como Forever; use esse controle para escolher outra validade, se necessário. Em Client IP Address Filtering, deixe Include e Exclude vazios, a menos que precise restringir o acesso por IP.

   

4. Na parte inferior do formulário, escolha Create User API Token. A Secret Access Key é exibida apenas uma vez na página de resultado. Mantenha essa página aberta e adicione imediatamente as credenciais no Orqra conforme a próxima seção. Feche a página de resultado somente depois que o Orqra confirmar que a configuração foi salva. O Orqra precisa do Access Key ID e da Secret Access Key desta criação; não use o valor de API Token nem uma chave de API do OpenRouter.

• Obter credenciais do R2

Adicionar as chaves e salvar

1. Volte à página de configurações do Orqra que você deixou aberta. Mantenha os dados básicos já preenchidos e adicione apenas as duas credenciais abaixo.

   Credenciais da mesma página de resultado da Cloudflare

   Campo no Orqra	O que preencher / onde encontrar
   Access Key ID	Copie Access Key ID da página de resultado da Cloudflare e cole aqui.
   Secret Access Key	Copie Secret Access Key dessa mesma página de resultado da Cloudflare e cole aqui. Ela é exibida apenas uma vez.

   

2. Escolha Salvar configuração e aguarde a mensagem “Configuração do armazenamento de mídia HTTPS salva.” antes de fechar a página de resultado da Cloudflare. Apenas colar as credenciais não salva a configuração. Salvar não envia arquivos.

Configurar exclusão automática

1. Abra orqra-video-inputs → Settings → Object Lifecycle Rules e escolha Add.

2. Preencha o formulário conforme a tabela abaixo, ative Object lifecycle rule is enabled e escolha Save changes.

   Configurações da regra de ciclo de vida

   Campo na Cloudflare	O que preencher ou selecionar
   Rule name	delete-orqra-transient. Identifica a regra; não é o prefixo dos objetos.
   Apply to objects with the following prefix (optional):	orqra-transient/. Não deixe este campo vazio; ele deve corresponder a Prefixo de objetos temporários no Orqra.
   Delete uploaded objects after:	Selecione esta opção, digite 1 e escolha Days.
   Object lifecycle rule is enabled	Ative este interruptor e escolha Save changes.

   

3. Confira as quatro colunas na lista de regras salvas: Rule Name deve ser delete-orqra-transient, Prefix deve ser orqra-transient/, Actions deve mostrar Delete objects after 1 day(s) e Status deve ser Enabled. A Cloudflare exclui objetos em segundo plano, então a exclusão pode ocorrer mais tarde. A regra padrão que cancela uploads multipartes incompletos após 7 dias não substitui esta regra.

   

• Configurar exclusão automática

Testar e voltar ao nó de vídeo

1. Depois de salvar e configurar a regra de exclusão, volte ao Orqra e escolha Testar entrada HTTPS. O Orqra envia, baixa, verifica e exclui um pequeno objeto de teste. Isso pode gerar um pequeno custo de solicitações de armazenamento; não chama o OpenRouter nem cria uma tarefa de vídeo.

2. Aguarde a mensagem “O teste de envio e download por HTTPS foi concluído com sucesso.”. Se aparecer um erro, faça as verificações abaixo e teste novamente. Um teste de armazenamento bem-sucedido não garante todas as buscas posteriores do provedor do modelo.

   

3. Volte por conta própria ao canvas, selecione as imagens no nó de vídeo e escolha Executar quando estiver pronto. Salvar ou testar o armazenamento não inicia a geração.

Resolver erros do armazenamento