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. Na primeira utilização, ative o R2 e consulte a faturação; os custos de armazenamento são separados dos custos do Orqra e dos modelos.

   

2. Escolha Create bucket. Introduza 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. Utilize o valor original que copiou da sua própria conta.

   

2. No Orqra Desktop, abra Definições → Dados e armazenamento → Armazenamento de multimédia HTTPS. Cole o endereço copiado sem alterações em Endpoint e introduza o nome do bucket criado separadamente em Bucket. Mantenha os restantes valores predefinidos do R2 conforme a tabela. Deixe Access Key ID e Secret Access Key vazios por enquanto. Mantenha esta página de definições aberta para adicionar as credenciais e guardar tudo em conjunto quando as obtiver.

   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 utilize o URL do painel nem um endereço público r2.dev.
   Região	auto
   Bucket	Introduza 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 eliminação automática que irá configurar mais adiante.
   Session Token	Deixe vazio na primeira configuração com as credenciais R2 comuns deste guia.
   Validade do URL assinado (segundos)	21600 (6 horas): validade do link de download, não o momento de exclusão do ficheiro.
   Utilizar 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 secção User API Tokens, escolha Create User API token.

   

3. No formulário Create User API Token, introduza 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 este controlo 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 é apresentada apenas uma vez na página de resultado. Mantenha essa página aberta e adicione imediatamente as credenciais no Orqra conforme a secção seguinte. Feche a página de resultado apenas depois de o Orqra confirmar que a configuração foi guardada. O Orqra precisa do Access Key ID e da Secret Access Key desta criação; não utilize o valor de API Token nem uma chave de API do OpenRouter.

• Obter credenciais do R2

Adicionar as chaves e guardar

1. Regresse à página de definições do Orqra que 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. É apresentada apenas uma vez.

   

2. Escolha Guardar configuração e aguarde a mensagem «A configuração do armazenamento de multimédia HTTPS foi guardada.» antes de fechar a página de resultado da Cloudflare. Colar as credenciais, por si só, não guarda a configuração. Guardar não envia ficheiros.

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.

   Definiçõ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, introduza 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 guardadas: 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 elimina objetos em segundo plano, então a eliminação pode ocorrer mais tarde. A regra predefinida 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 guardar e configurar a regra de eliminação, regresse ao Orqra e escolha Testar entrada HTTPS. O Orqra envia, transfere, verifica e elimina um pequeno objeto de teste. Isso pode gerar um pequeno custo de pedidos de armazenamento; não chama o OpenRouter nem cria uma tarefa de vídeo.

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

   

3. Regresse por si ao canvas, selecione as imagens no nó de vídeo e escolha Executar quando estiver pronto. Guardar ou testar o armazenamento não inicia a geração.

Resolver erros do armazenamento