配置視頻參考圖存儲

創建 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 素材儲存」，將複製的位址原樣貼入「Endpoint」，在「Bucket」單獨填寫建立的儲存桶名稱。其餘項目依下表保留 R2 預設值。「Access Key ID」和「Secret Access Key」暫時留空，保持此設定頁開啟，取得金鑰後再一起儲存。

   基本設定填寫對照

   Orqra 中的欄位	填寫內容 / 取得位置
   Endpoint	從 Account Details 的 S3 API 行複製位址，原樣貼入此欄位。請勿使用控制台網址或 r2.dev 公開位址。
   Region	auto
   Bucket	單獨填寫建立的儲存桶名稱，例如 orqra-video-inputs。
   臨時物件前綴	orqra-transient/，必須與稍後設定的自動刪除規則中的 Prefix 一致。
   Session Token	首次使用本教程建立的一般 R2 憑證時留空。
   簽章 URL 有效期（秒）	21600（6 小時），是下載連結有效期，不是檔案刪除時間。
   使用 Path-Style 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 中的欄位	填寫內容 / 取得位置
   Access Key ID	從剛才保持開啟的 Cloudflare 結果頁複製 Access Key ID，貼入此欄位。
   Secret Access Key	從同一個 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」。儲存或測試設定都不會開始生成。

存儲測試失敗怎麼辦