Tự động hóa
Tạo video và kết nối kết quả hoàn tất với quy trình làm việc của bạn thông qua các gói đăng ký hoàn tất của Reela CLI.
Tạo video và kết nối kết quả hoàn tất với quy trình làm việc của bạn thông qua các gói đăng ký hoàn tất của Reela CLI.
Reela cung cấp các lệnh sản xuất video và gói đăng ký hoàn tất cho video đã hoàn thành. Agent hoặc công cụ khác có thể gửi mô tả yêu cầu và nhận đầu ra thông qua CLI daemon mà không cần mở trang web Reela.
Từ mô tả yêu cầu đến video
create chuyển mô tả yêu cầu bằng văn bản và nội dung đa phương tiện tùy chọn thành tác vụ video. Bạn có thể nhập trực tiếp câu lệnh hoặc đọc từ tệp, chọn thời lượng và bố cục, thêm avatar, cũng như đính kèm hình ảnh tham chiếu, cảnh quay hoặc nhạc nền.
reela create --prompt-file brief.txt \
--visual ai-video --layout portrait --duration 30 \
--session "Product campaign" --output jsonTạo video là một tác vụ chạy trong thời gian dài. Hãy khởi động daemon và định cấu hình gói đăng ký hoàn tất trước khi gửi yêu cầu; Reela chạy quá trình tạo ở chế độ nền và gửi kết quả đã hoàn thành đến tập lệnh của bạn. Dùng lại tiêu đề phiên sẽ nhóm các video liên quan vào một dự án. Xem Tự động gửi bên dưới để biết cách thiết lập.
Trước khi gửi, hãy thêm --dry-run để xác thực yêu cầu và xem trước số tín dụng ước tính mà không tải tệp lên hoặc tạo tác vụ. Việc gửi tác vụ có thể tiêu tốn tín dụng.
Xem các tùy chọn tạo video để biết hình ảnh và nội dung đa phương tiện đầu vào được hỗ trợ.
Chọn chất lượng và chi phí bằng các bậc
Các bậc cho phép bạn chọn tùy chọn tạo cho từng yêu cầu. Reela cung cấp mô tả giúp bạn hoặc agent chọn tùy chọn phù hợp với kết quả mong muốn, sau đó ước tính số tín dụng cho yêu cầu đó trước khi gửi.
reela tiers list
reela tiers list --output jsonDanh sách hiển thị nhãn và mô tả của từng bậc, đồng thời cho biết bậc mặc định. Trong đầu ra JSON, tiers chứa các mục có label, content và is_default; default_tier nêu tên bậc mặc định. Đọc content để hiểu từng tùy chọn thay vì chọn dựa trên vị trí trong danh sách. Việc liệt kê các bậc không đảm bảo tài khoản của bạn có thể dùng mọi tùy chọn; Reela kiểm tra quyền truy cập khi xác thực hoặc gửi yêu cầu.
Truyền nhãn chính xác cho --tier. Thay <tier-label> bên dưới bằng một nhãn trong danh sách; giữ nguyên dấu ngoặc kép nếu nhãn có khoảng trắng:
reela create --prompt-file brief.txt --visual ai-video \
--tier "<tier-label>" --duration 30 --layout portrait \
--dry-run --output jsonBản xem trước trả về credits_cost và quota_after. Để gửi yêu cầu, hãy xóa --dry-run và giữ nguyên bậc đã chọn cùng các tùy chọn khác. Bậc mô tả lựa chọn tạo video; hãy dùng bản xem trước để ước tính chi phí cho yêu cầu thực tế của bạn.
Nếu bỏ qua --tier, Reela sẽ dùng mặc định hiện tại dành cho CLI. Nếu không có mặc định, hãy chạy reela tiers list để làm mới các lựa chọn hoặc chỉ định rõ một bậc. Việc chỉ định rõ bậc giúp lựa chọn trong quy trình của bạn không phụ thuộc vào những thay đổi của mặc định; tuy vậy, tình trạng khả dụng và giá vẫn có thể thay đổi. Hãy dùng cùng một hồ sơ để liệt kê, xem trước và gửi yêu cầu.
Xem tài liệu tham khảo lệnh tiers để biết chi tiết đầu ra và cách chọn.
Kết quả có cấu trúc dành cho agent và công cụ
--output json cung cấp kết quả lệnh dưới dạng dữ liệu có cấu trúc, bao gồm lựa chọn bậc, ước tính tín dụng và xác nhận gửi yêu cầu. Mã thoát 0 có nghĩa là lệnh đã thành công; lỗi sử dụng mã thoát khác 0 và văn bản thuần trên stderr, kể cả khi ở chế độ JSON.
Sau khi gửi thành công, daemon sẽ chờ hoàn tất và gọi tập lệnh đã đăng ký của bạn kèm kết quả. Phản hồi gửi yêu cầu và sự kiện hoàn tất có task_id để quy trình làm việc của bạn có thể liên kết video đã hoàn thành với mô tả yêu cầu ban đầu.
Tự động gửi
Reela CLI có thể chạy tệp thực thi của riêng bạn khi tác vụ video hoàn tất. Gói đăng ký hoàn tất này kết nối đầu ra của Reela với hành động tiếp theo của bạn: chuyển video cho công cụ xuất bản, cập nhật bản ghi hoặc thông báo cho hệ thống khác. Reela theo dõi trạng thái hoàn tất và cung cấp thông tin chi tiết về tác vụ cho tập lệnh của bạn.
Đăng ký tập lệnh
Cung cấp đường dẫn tuyệt đối đến một tệp thực thi trên máy đang chạy Reela CLI. Tệp có thể dùng bất kỳ ngôn ngữ nào, miễn là đọc sự kiện từ stdin và báo hiệu thành công thông qua mã thoát.
reela subscribe add script --path /absolute/path/on-video \
--timeout-seconds 300 --max-retries 3Mỗi hồ sơ có một gói đăng ký tập lệnh. Để thay đổi tệp thực thi của gói đăng ký hiện có, hãy dùng reela config set delivery.script.path /absolute/path/on-video. Khởi động lại daemon đang chạy sau khi thay đổi gói đăng ký hoặc cài đặt của gói, như mô tả bên dưới.
Nhận sự kiện hoàn tất
Reela khởi chạy tệp thực thi và ghi một đối tượng JSON vào stdin:
{
"event": "task.completed",
"task_id": "12345",
"status": "completed",
"status_label": "completed",
"title": "Product demo",
"description": "A short product introduction",
"download": {
"filename": "product-demo.mp4",
"download_url": "https://example.com/video.mp4"
}
}Dùng task_id để liên kết sự kiện với yêu cầu gửi ban đầu của bạn. title, description và download có thể là null. Khi có, download cung cấp tên tệp đề xuất và URL tải xuống của video đã hoàn thành để tập lệnh của bạn sử dụng trực tiếp. Hãy xử lý trường hợp thiếu giá trị download trước khi chạy hành động cần đến video.
Các liên kết download_url đã ký sẽ hết hạn 6 giờ sau khi được tạo. Hãy tải xuống hoặc sao chép video vào bộ nhớ của riêng bạn ngay sau khi nhận sự kiện hoàn tất. Giữ riêng tư các URL tải xuống và xem chúng là liên kết truy cập tạm thời, không phải địa chỉ video vĩnh viễn.
Gói đăng ký nhận các tác vụ đã hoàn tất của tài khoản được chọn, bao gồm cả video tạo bên ngoài CLI. Nếu hành động của bạn thuộc một quy trình cụ thể, hãy đối chiếu ID tác vụ trong sự kiện với các tác vụ bạn đã gửi. Hiện tại, gói đăng ký hoàn tất chỉ xử lý các tác vụ thành công; tác vụ thất bại, bị hủy hoặc hoàn tất một phần sẽ không kích hoạt sự kiện này.
Thực thi và thử lại
- Thành công: thoát với
0sau khi hành động của bạn thành công. Reela loại bỏ stdout của tập lệnh; đầu ra được in không được dùng làm kết quả. - Hết thời gian chờ:
--timeout-seconds 300cho phép mỗi lần gọi chạy tối đa 300 giây. Hết thời gian chờ hoặc thoát với mã khác 0 sẽ khiến việc gửi thất bại. - Thử lại: Reela thử gửi lại khi việc gửi thất bại. Khi chỉ phương thức tập lệnh gặp lỗi,
--max-retries 3cho phép tổng cộng ba lần thử, tính cả lần đầu tiên. Các lỗi liên quan đến những phương thức khác đang bật sử dụngdelivery.max_retries. - Gửi lặp lại: hãy đảm bảo các hành động có thể được thực hiện lại an toàn với cùng
task_id, để lần gọi khác không xuất bản cùng một video hoặc thêm cùng một bản ghi lần thứ hai.
Duy trì gói đăng ký hoạt động
CLI daemon xử lý các sự kiện hoàn tất và chạy những phương thức gửi mà bạn đã bật. Sau khi chọn phương thức, hãy khởi động daemon và kiểm tra trạng thái gửi:
reela daemon start
reela subscribe statusThêm một phương thức cũng sẽ thử khởi động daemon nếu daemon đang dừng. Nếu daemon đang chạy, hãy khởi động lại sau khi thay đổi cài đặt gửi để các cài đặt đó có hiệu lực. Với daemon được khởi động thủ công, hãy dùng reela daemon stop rồi đến reela daemon start.
Reela lưu tiến trình gửi và tiếp tục từ đó khi daemon khởi động lại. Nếu không có tiến trình đã lưu, theo mặc định daemon sẽ theo dõi các sự kiện mới. reela daemon start --keep-backlog cũng xử lý các sự kiện tác vụ đã hoàn tất trước đó còn khả dụng khi không có tiến trình đã lưu.
Dùng reela daemon install để bật khởi chạy khi đăng nhập. Nếu được cài đặt dưới dạng dịch vụ, hãy khởi động lại dịch vụ bằng trình quản lý dịch vụ của hệ điều hành sau khi thay đổi cấu hình. Kiểm tra reela daemon status hoặc reela daemon logs --tail 50 để xem thông tin gửi.
Để tự động gửi, máy chạy daemon phải luôn bật và được kết nối mạng. Hãy khởi động daemon trước khi gửi video mà bạn muốn kích hoạt tập lệnh khi hoàn tất.
daemon và subscribe có trên Linux và macOS. Windows x64 hỗ trợ các lệnh video, truy vấn trạng thái và tải xuống thủ công.
Tùy chọn tải xuống và gửi email
Bạn có thể bật tải xuống tự động hoặc email thông báo video đã hoàn thành bên cạnh tập lệnh. Tải xuống được bật trong cài đặt gửi mặc định; đặt thư mục đích bằng reela config set delivery.download ~/Videos/reela. Nếu tính năng này bị tắt, hãy bật bằng reela subscribe add download --dir ~/Videos/reela. Bật email bằng reela subscribe add email; bạn có thể thêm --address me@example.com để dùng địa chỉ khác với email tài khoản.
Có thể bật đồng thời nhiều phương thức và lỗi của một phương thức không ngăn các phương thức khác chạy. Mỗi lần gọi tập lệnh nhận payload hoàn tất riêng, bao gồm thông tin tải xuống nếu có. Xem tài liệu tham khảo lệnh delivery để biết tất cả các phương thức.
Tái sử dụng thiết lập sản xuất
Reela cung cấp thêm các khả năng có thể trở thành những bước trong quy trình làm việc của bạn:
- Thương hiệu nhất quán: liệt kê các bộ nhận diện thương hiệu hiện có bằng
brand listvà áp dụng một bộ cho tác vụ bằngbrand apply. Lệnh chờ đầu ra có áp dụng thương hiệu. Xem các lệnh brand. - Chỉnh sửa bằng chương trình: tải JSON chỉnh sửa xuống, xác thực các thay đổi, lưu bản nháp để xem trước và gửi yêu cầu kết xuất bằng
edit. Xem các lệnh chỉnh sửa. - Tài khoản và tùy chọn riêng biệt: chọn hồ sơ bằng
--profilehoặcREELA_PROFILE. Phương thức và cài đặt gửi áp dụng cho hồ sơ được chọn. Xem hồ sơ và cấu hình.
Ví dụ: quy trình tạo video sản phẩm có thể gửi mô tả yêu cầu kèm hình ảnh tham chiếu và dùng gói đăng ký hoàn tất của daemon để chuyển video đã hoàn thành cho công cụ xuất bản của bạn. Reela cung cấp khả năng tạo video nền và gửi khi hoàn tất; công cụ của bạn quyết định thời điểm gửi yêu cầu và hành động cần thực hiện khi nhận kết quả.
Xem tài liệu tham khảo lệnh delivery để biết tất cả tùy chọn gói đăng ký và daemon. Để cài đặt và ủy quyền tài khoản, hãy bắt đầu với Bắt đầu.