동영상 참조 이미지 저장소

R2 버킷 만들기

1. Cloudflare 영어 대시보드 왼쪽에서 Storage & databases → R2 Object Storage를 열면 버킷 목록과 Create bucket이 바로 표시됩니다. 처음 사용하는 경우 R2를 활성화하고 과금 정보를 확인합니다. 저장소 요금은 Orqra 및 모델 요금과 별도입니다.

   

2. Create bucket을 선택합니다. Bucket name에 orqra-video-inputs를 입력하고 Location은 Automatic으로 유지한 뒤 Default Storage Class에서 Standard를 선택합니다.

   

3. Create bucket을 선택하고 버킷 목록에 orqra-video-inputs가 표시되는지 확인합니다. 비공개로 유지하세요. r2.dev 공개 액세스를 켜거나 사용자 지정 도메인을 추가할 필요가 없습니다.

• R2 대시보드 열기
• Cloudflare 활성화 안내
• 공식 Bucket 생성 방법

기본 설정 입력

1. R2 Object Storage 개요 페이지에서 Account Details를 찾고 S3 API 행 오른쪽의 복사 아이콘을 선택합니다.

   예: https://example-account-id.r2.cloudflarestorage.com. 예시 계정의 Endpoint이며 버킷 이름은 포함되지 않습니다. 본인 계정에서 복사한 원래 주소를 사용하세요.

   

2. Orqra 데스크톱에서 “설정 → 데이터 및 저장소 → HTTPS 미디어 스토리지”를 열고 복사한 주소를 “엔드포인트”에 그대로 붙여 넣습니다. 만든 버킷 이름은 별도의 “버킷” 필드에 입력합니다. 나머지 항목은 아래 표에 따라 R2 기본값을 유지합니다. “액세스 키 ID” 및 “비밀 액세스 키”는 일단 비워 두고 이 설정 페이지를 열어 두세요. 키를 얻은 후 함께 저장합니다.

   기본 설정 입력 안내

   Orqra 필드	입력할 내용 / 확인 위치
   엔드포인트	Account Details의 S3 API 행에서 주소를 복사하여 이 필드에 그대로 붙여 넣습니다. 대시보드 URL이나 공개 r2.dev 주소는 사용하지 않습니다.
   리전	auto
   버킷	만든 버킷의 이름을 따로 입력합니다. 예: orqra-video-inputs.
   임시 객체 접두사	orqra-transient/. 다음 단계에서 설정할 자동 삭제 규칙의 Prefix와 같아야 합니다.
   세션 토큰	이 안내의 일반 R2 자격 증명으로 처음 설정할 때는 비워 둡니다.
   서명된 URL 유효 시간(초)	21600(6시간). 다운로드 링크 유효 기간이며 파일 삭제 시간이 아닙니다.
   경로 스타일 URL 사용	켜진 상태로 유지합니다.

• 공식 S3 연결 가이드

접근 자격 증명 만들기

1. R2 Object Storage의 버킷 목록 페이지에서 Account Details를 찾고 Manage API Tokens를 선택합니다.

   

2. 관리 페이지의 User API Tokens 영역에서 Create User API token을 선택합니다. 다음 양식의 제목은 Create User API Token입니다.

   

3. Token name에 orqra-video-inputs를 입력하고 Permissions에서 Object Read & Write를 선택합니다.

   Specify bucket(s)에서 Apply to specific buckets only를 선택하고 앞서 만든 orqra-video-inputs 버킷을 지정합니다.

   TTL의 기본값은 Forever이며 필요에 맞게 자격 증명의 유효 기간을 선택할 수 있습니다. 일반적인 설정에서는 Client IP Address Filtering의 Include와 Exclude 두 입력란을 비워 둡니다.

   

4. 양식 하단에서 Create User API Token을 선택합니다. Secret Access Key는 한 번만 표시됩니다. 결과 페이지를 열어 둔 채 다음 절에 따라 Access Key ID와 Secret Access Key를 즉시 Orqra에 입력하고 저장하세요. 저장 성공을 확인한 후 결과 페이지를 닫습니다. Orqra에는 같은 생성 작업에서 받은 이 두 S3 자격 증명이 필요하며 API Token 값이나 OpenRouter API Key를 사용하면 안 됩니다.

• R2 자격 증명 받기

키를 추가로 입력하고 저장

1. 열어 둔 Orqra 설정 페이지로 돌아갑니다. 이미 입력한 기본 정보는 유지하고 아래 표의 키 두 개만 추가로 입력하세요.

   키 입력 안내

   Orqra 필드	입력할 내용 / 확인 위치
   액세스 키 ID	열어 둔 Cloudflare 결과 페이지에서 Access Key ID를 복사하여 이 필드에 붙여 넣습니다.
   비밀 액세스 키	같은 Cloudflare 결과 페이지에서 Secret Access Key를 복사하여 이 필드에 붙여 넣습니다. 한 번만 표시되므로 Orqra에서 저장 성공을 확인한 후 결과 페이지를 닫으세요.

   

2. “구성 저장”을 선택하고 “HTTPS 미디어 스토리지 구성을 저장했습니다.” 메시지를 확인한 후 Cloudflare 결과 페이지를 닫습니다. 키를 붙여 넣기만 하면 저장되지 않습니다. 저장만으로 파일이 업로드되지는 않습니다.

자동 삭제 설정

1. orqra-video-inputs → Settings → Object Lifecycle Rules를 열고 Add를 선택합니다.

2. 아래 네 항목을 설정하고 Object lifecycle rule is enabled를 켠 뒤 Save changes를 선택합니다.

   수명 주기 규칙 설정

   Cloudflare 필드	입력하거나 선택할 값
   Rule name	delete-orqra-transient. 규칙을 구분하는 이름이며 객체 접두사가 아닙니다.
   Apply to objects with the following prefix (optional):	orqra-transient/를 입력합니다. 비워 두지 마세요. Orqra의 “임시 객체 접두사”와 같아야 합니다.
   Delete uploaded objects after:	이 옵션을 체크하고 1을 입력한 뒤 Days를 선택합니다.
   Object lifecycle rule is enabled	스위치를 켠 상태에서 Save changes를 선택합니다.

   

3. 저장된 규칙 목록의 네 열을 확인합니다. Rule Name은 delete-orqra-transient, Prefix는 orqra-transient/, Actions는 Delete objects after 1 day(s), Status는 Enabled여야 합니다. Cloudflare는 백그라운드에서 삭제하므로 삭제가 늦어질 수 있습니다. 미완료 멀티파트 업로드를 7일 후 중단하는 기본 규칙으로 이 규칙을 대신할 수 없습니다.

   

• 자동 삭제 설정

테스트 후 동영상 노드로 돌아가기

1. 설정을 저장하고 자동 삭제 규칙을 설정한 후 Orqra로 돌아가 “HTTPS 입력 테스트”를 선택합니다. Orqra가 작은 확인용 객체를 업로드, 다운로드, 검증하고 삭제합니다. 소액의 저장소 요청 요금이 발생할 수 있지만 OpenRouter를 호출하거나 동영상 작업을 만들지 않습니다.

2. “HTTPS 업로드 및 다운로드 테스트에 성공했습니다.” 메시지를 기다립니다. 오류가 나오면 아래 항목을 확인하고 다시 테스트하세요. 저장소 테스트가 성공해도 이후 모델 공급자의 모든 다운로드가 성공한다고 보장되지는 않습니다.

   

3. 직접 캔버스로 돌아가 동영상 노드에서 이미지를 선택하고 준비되면 “Run”을 선택합니다. 저장소 설정을 저장하거나 테스트해도 생성은 시작되지 않습니다.

저장소 테스트 오류 해결