Lưu ảnh tham chiếu cho video

Tạo bucket R2

1. Trong bảng điều khiển Cloudflare tiếng Anh, mở Storage & databases → R2 Object Storage ở thanh bên. Danh sách bucket và Create bucket sẽ xuất hiện ngay. Lần đầu sử dụng, hãy kích hoạt R2 và kiểm tra thông tin thanh toán; phí lưu trữ tách biệt với phí Orqra và phí mô hình.

   

2. Chọn Create bucket. Nhập orqra-video-inputs vào Bucket name, giữ Location là Automatic rồi chọn Standard trong Default Storage Class.

   

3. Chọn Create bucket và xác nhận orqra-video-inputs xuất hiện trong danh sách bucket. Giữ bucket ở chế độ riêng tư; không cần bật truy cập công khai r2.dev hoặc thêm tên miền tùy chỉnh.

• Mở bảng điều khiển R2
• Hướng dẫn kích hoạt Cloudflare R2
• Các bước tạo Bucket chính thức

Điền cấu hình cơ bản

1. Trên trang tổng quan R2 Object Storage, tìm Account Details và chọn biểu tượng sao chép ở bên phải dòng S3 API.

   Ví dụ: https://example-account-id.r2.cloudflarestorage.com. Đây chỉ là Endpoint của tài khoản minh họa, không chứa tên bucket. Hãy dùng nguyên địa chỉ bạn đã sao chép từ tài khoản của mình.

   

2. Trong Orqra Desktop, mở “Cài đặt → Dữ liệu và lưu trữ → Kho lưu trữ phương tiện HTTPS”, dán nguyên địa chỉ đã sao chép vào “Điểm cuối” và điền riêng tên bucket đã tạo vào “Nhóm lưu trữ”. Giữ các mục còn lại theo giá trị mặc định R2 trong bảng dưới. Tạm để trống “ID khóa truy cập” và “Khóa truy cập bí mật”, giữ trang cài đặt này mở rồi lưu tất cả sau khi lấy được khóa.

   Bảng cấu hình cơ bản

   Trường trong Orqra	Nội dung cần điền / nơi lấy
   Điểm cuối	Sao chép địa chỉ từ dòng S3 API trong Account Details và dán nguyên vào trường này. Không dùng URL bảng điều khiển hoặc địa chỉ r2.dev công khai.
   Khu vực	auto
   Nhóm lưu trữ	Điền riêng tên bucket đã tạo, ví dụ orqra-video-inputs.
   Tiền tố đối tượng tạm thời	orqra-transient/ — phải khớp với Prefix của quy tắc tự động xóa sẽ thiết lập ở phần sau.
   Mã thông báo phiên	Để trống khi thiết lập lần đầu với thông tin R2 thông thường trong hướng dẫn này.
   Thời hạn URL đã ký (giây)	21600 (6 giờ): thời hạn liên kết tải xuống, không phải thời gian xóa tệp.
   Sử dụng URL kiểu đường dẫn	Giữ bật.

• Hướng dẫn kết nối S3 chính thức

Tạo thông tin truy cập

1. Trên trang danh sách bucket của R2 Object Storage, tìm Account Details và chọn Manage API Tokens.

   

2. Trong mục User API Tokens của trang quản lý, chọn Create User API token. Tiêu đề biểu mẫu tiếp theo là Create User API Token.

   

3. Nhập orqra-video-inputs vào Token name. Trong Permissions, chọn Object Read & Write.

   Trong Specify bucket(s), chọn Apply to specific buckets only rồi chọn bucket orqra-video-inputs đã tạo ở bước trước.

   TTL mặc định là Forever; dùng mục này để chọn thời hạn khác cho thông tin xác thực nếu cần. Với thiết lập thông thường, để trống cả hai ô Include và Exclude trong Client IP Address Filtering.

   

4. Ở cuối biểu mẫu, chọn Create User API Token. Secret Access Key chỉ hiển thị một lần. Giữ trang kết quả mở, làm ngay theo phần tiếp theo để điền Access Key ID và Secret Access Key vào Orqra rồi lưu. Chỉ đóng trang kết quả sau khi xác nhận lưu thành công. Orqra cần hai thông tin xác thực S3 được tạo cùng lần này; không dùng giá trị API Token hoặc OpenRouter API Key.

• Lấy thông tin xác thực R2

Điền thêm khóa rồi lưu

1. Quay lại trang cài đặt Orqra vẫn đang mở. Giữ nguyên thông tin cơ bản đã điền và chỉ bổ sung hai khóa trong bảng dưới.

   Bảng điền khóa

   Trường trong Orqra	Nội dung cần điền / nơi lấy
   ID khóa truy cập	Sao chép Access Key ID từ trang kết quả Cloudflare vẫn đang mở và dán vào trường này.
   Khóa truy cập bí mật	Sao chép Secret Access Key từ cùng trang kết quả Cloudflare và dán vào trường này. Khóa chỉ hiển thị một lần; chỉ đóng trang sau khi lưu thành công trong Orqra.

   

2. Chọn “Lưu cấu hình” và đợi thông báo “Đã lưu cấu hình kho lưu trữ phương tiện HTTPS.” rồi mới đóng trang kết quả Cloudflare. Chỉ dán khóa chưa có nghĩa là đã lưu; việc lưu không tải tệp lên.

Thiết lập tự động xóa

1. Mở orqra-video-inputs → Settings → Object Lifecycle Rules rồi chọn Add.

2. Điền bốn mục trong bảng dưới, bật Object lifecycle rule is enabled rồi chọn Save changes.

   Thiết lập quy tắc vòng đời

   Trường trong Cloudflare	Nội dung cần nhập hoặc chọn
   Rule name	delete-orqra-transient. Đây là tên nhận diện quy tắc, không phải tiền tố đối tượng.
   Apply to objects with the following prefix (optional):	Nhập orqra-transient/. Không để trống; phải khớp với “Tiền tố đối tượng tạm thời” trong Orqra.
   Delete uploaded objects after:	Đánh dấu tùy chọn này, nhập 1 và chọn Days.
   Object lifecycle rule is enabled	Giữ công tắc ở trạng thái bật rồi chọn Save changes.

   

3. Trong danh sách quy tắc đã lưu, kiểm tra cả bốn cột: Rule Name là delete-orqra-transient, Prefix là orqra-transient/, Actions ghi Delete objects after 1 day(s) và Status là Enabled. Cloudflare xóa đối tượng ở chế độ nền nên việc xóa có thể diễn ra muộn hơn. Quy tắc mặc định hủy tải lên nhiều phần chưa hoàn tất sau 7 ngày không thay thế quy tắc này.

   

• Thiết lập xóa tự động

Kiểm tra rồi quay lại nút video

1. Sau khi lưu cấu hình và thiết lập quy tắc tự động xóa, quay lại Orqra và chọn “Kiểm tra đầu vào HTTPS”. Orqra tải lên, tải xuống, xác minh và xóa một đối tượng kiểm tra rất nhỏ. Có thể phát sinh một khoản phí yêu cầu lưu trữ nhỏ; thao tác này không gọi OpenRouter hay tạo tác vụ video.

2. Chờ thông báo “Kiểm tra tải lên và tải xuống qua HTTPS đã thành công.” Nếu có lỗi, hãy kiểm tra theo hướng dẫn bên dưới rồi thử lại. Kiểm tra lưu trữ thành công không bảo đảm mọi lần lấy dữ liệu sau đó của nhà cung cấp mô hình đều thành công.

   

3. Tự quay lại canvas, chọn ảnh trong nút video và chọn “Run” khi sẵn sàng. Lưu hoặc kiểm tra cấu hình lưu trữ không bắt đầu quá trình tạo.

Sửa lỗi kiểm tra lưu trữ