Skip to main content

Tiện ích nâng cao: Render Node Template, Troubleshoot Machine, Simulate Local Path, API access


cover
cover

Super Renders Farm cung cấp bốn tiện ích nâng cao cho các studio cần nhiều hơn luồng upload-nộp-tải về mặc định: Render Node Template (xác định stack phần mềm nhất quán cho các worker render job của bạn), Troubleshoot Machine (khởi động VM debug có thể kết nối RDP khớp với môi trường render node), Simulate Local Path (giữ nguyên đường dẫn tuyệt đối cho các dự án giải quyết asset bằng đường dẫn được mã hóa cứng), và giao diện API access (hiện còn hạn chế — xem §API access để biết thông tin hiện tại về nộp job theo chương trình). Trang này là tài liệu tham chiếu cho cả bốn — khi nào dùng từng loại, cơ chế hoạt động cơ bản trên render farm, các bước chính xác để cấu hình hoặc gọi từng tiện ích, và các lỗi phổ biến chúng tôi thấy trong hỗ trợ.

Nếu bạn mới dùng render farm và đang tìm luồng upload mặc định, là điểm khởi đầu phù hợp. Nếu bạn đang gỡ lỗi job thất bại, trang bao gồm các mẫu lỗi phổ biến nhất. Các tiện ích được ghi lại ở đây dành cho các trường hợp luồng mặc định không phù hợp — thường là studio lớn với pipeline đã thiết lập, dự án có yêu cầu đường dẫn asset bất thường, hoặc phiên debug một lần khi bạn cần thấy chính xác những gì render worker nhìn thấy.

Nên dùng tiện ích nào — bảng quyết định

Định hướng ngắn trước các phần theo từng tiện ích:

| Nếu bạn cần… | Dùng | |---|---| | Khóa phiên bản DCC, phiên bản plugin và giấy phép plugin nào chạy trên các worker được giao cho job của bạn | Render Node Template | | Kết nối đến render worker thực qua Microsoft Remote Desktop, sửa scene tại chỗ, rồi nộp nó như job thực sự | Troubleshoot Machine | | Render dự án dùng đường dẫn tuyệt đối (C:\projects\… hoặc D:\textures\…) và không thể chuyển sang đường dẫn tương đối | Simulate Local Path | | Nộp job theo chương trình từ script hoặc công cụ pipeline | API access (xem phần giữ chỗ — đường dẫn hiện tại là Client App hoặc plugin DCC) |

Bạn có thể kết hợp các tiện ích này. Render Node Template có thể được ghép với Simulate Local Path trên cùng một job. Troubleshoot Machine tôn trọng cả Render Node Template đang hoạt động và bất kỳ cấu hình Simulate Local Path nào, nên môi trường debug khớp với môi trường render sản xuất. Bốn tiện ích được thiết kế để kết hợp linh hoạt.

Render Node Template

Render Node Template là tiện ích mạnh nhất trong bốn và có lịch sử lâu đời nhất. Nó cho phép bạn chỉ định chính xác môi trường phần mềm mà các render worker của bạn nên có trước khi nhận job: phiên bản 3ds Max nào, bản dựng V-Ray nào, plugin nào được cài và có giấy phép, và bất kỳ file cấu hình tùy chỉnh nào cần có trên worker trước khi render bắt đầu. Sau khi được xác định, template có thể tái sử dụng qua các job — mỗi lần nộp bạn gắn thẻ với template đó sẽ chạy trên stack worker giống hệt nhau.

Vấn đề nó giải quyết

Theo mặc định, Super Renders Farm cài sẵn một stack phần mềm được quản lý trên mỗi render worker — các phiên bản DCC gần đây và các renderer, plugin phổ biến nhất, được tinh chỉnh cho các loại workload chúng tôi thấy thường xuyên nhất. Với 80% job, đây là mặc định đúng; worker đã có phần mềm mà scene của bạn cần. Nhưng có hai tình huống mà mặc định không đủ:

  • Ghim phiên bản. Studio của bạn chuẩn hóa trên 3ds Max 2024 + V-Ray 6.10.05 + một bản dựng Forest Pack cụ thể, và bạn không thể mạo hiểm để worker nhận phiên bản điểm mới hơn có thể gây ra sự khác biệt về sampling hoặc noise giữa các frame trong cùng một animation.
  • Plugin đặc biệt. Bạn dùng một plugin (hoặc phiên bản plugin) không có trong stack render farm mặc định — ví dụ, bản phát hành Phoenix FD ít phổ biến, cầu nối Pulze ZBrush, hoặc bản dựng tính năng Corona đặc biệt.

Render Node Template cho phép bạn khai báo stack một cách rõ ràng. Render farm sau đó hoặc định tuyến job của bạn đến các worker đã khớp với template được khai báo, hoặc cung cấp worker mới để khớp trước khi giao job. Dù bằng cách nào, cam kết ghim phiên bản là end-to-end.

Cơ chế hoạt động trên render farm

Render Node Template là một bản ghi cấu hình được đặt tên, gắn với tài khoản của bạn. Nó chứa:

  • DCC và phiên bản — ví dụ 3ds Max 2024.2.2.
  • Renderer và phiên bản — ví dụ V-Ray 6.10.05.
  • Danh sách plugin kèm phiên bản — ví dụ Forest Pack Pro 8.4.2, RailClone Pro 6.3, Phoenix FD 5.10.
  • Kênh giấy phép — giấy phép nào (Chaos, Maxon, Otoy, AXYZ Design) nên có sẵn cho worker qua hạ tầng cấp phép tập trung của chúng tôi. Hầu hết plugin được bao gồm ngay lập tức; nếu template của bạn tham chiếu plugin chúng tôi chưa host, hỗ trợ sẽ báo hiệu và bạn mang theo file giấy phép của mình.
  • File payload tùy chọn — file cấu hình, preset hoặc thư viện shader cần được đặt ở vị trí đã biết trên worker trước khi render bắt đầu.

Khi bạn nộp job và gắn thẻ với template, bộ lập lịch render farm khớp template với pool worker hiện tại. Nếu worker khớp đang rảnh, job được giao ngay lập tức. Nếu không có worker khớp, bộ lập lịch cung cấp worker mới theo template — thường mất thêm vài phút so với job stack mặc định, đó là sự đánh đổi chính.

Tạo Render Node Template

Trình chỉnh sửa template có thể truy cập từ dashboard tài khoản của bạn trong mục "Render Node Templates" (hoặc tương tự — nhãn UI chính xác có thể thay đổi giữa các phiên bản dashboard; nếu bạn không thấy mục đó, liên hệ hỗ trợ và chúng tôi sẽ hiển thị cho tài khoản của bạn).

Các bước:

  1. Đăng nhập vào superrendersfarm.com và mở phần Render Node Templates trong dashboard.
  2. Tạo template mới và đặt tên mô tả — thường là mã dự án hoặc nhãn tiêu chuẩn studio như studio-archviz-2024-vray6. Tên là của bạn; render farm chỉ dùng nó để khớp.
  3. Chọn DCC và phiên bản. Menu thả xuống liệt kê mọi phiên bản DCC chúng tôi hiện host. Nếu phiên bản bạn cần không có trong danh sách, template không thể được tạo cho nó mà không qua hỗ trợ — một số phiên bản cũ đã bị khai thác.
  4. Chọn renderer và phiên bản. Ràng buộc tương tự — menu thả xuống phản ánh stack render farm hiện tại.
  5. Thêm plugin từng cái một. Với mỗi plugin: chọn tên plugin từ danh mục, chọn phiên bản, và xác nhận kênh giấy phép. Plugin ngoài danh mục của chúng tôi cần một cuộc trò chuyện hỗ trợ để thêm — thường là nỗ lực một lần nếu plugin đủ phổ biến để chúng tôi có thể host giấy phép.
  6. Đính kèm file payload. Upload file cấu hình hoặc preset bạn cần trên worker. Render farm lưu chúng cùng template và sao chép vào thư mục làm việc của worker trước khi render bắt đầu.
  7. Lưu và xác thực. Dashboard chạy kiểm tra xác thực với pool worker hiện tại và báo cáo "matching workers available" (giao ngay lập tức khi có job đầu tiên) hoặc "no current matches — workers will be provisioned on first use" (chậm hơn một chút khi có job đầu tiên).

Template bây giờ có thể chọn cho bất kỳ lần nộp job tiếp theo nào.

Sử dụng template khi nộp job

Khi bạn nộp render job — qua web upload, Client App, hoặc plugin nộp job DCC — form nộp bao gồm menu thả xuống "Render Node Template". Chọn template bạn đã tạo. Job thừa hưởng toàn bộ khai báo stack; bạn không cần chỉ định lại DCC, renderer hay phiên bản plugin trên form nộp.

Hai lưu ý vận hành:

  • Template + Express priority kết hợp được. Bạn có thể nộp job có template với độ ưu tiên Express. Bộ lập lịch cố tìm worker rảnh khớp cả hai ràng buộc; nếu không có, nó cung cấp một worker. Job Express có template thường có cửa sổ giao việc dài hơn một chút so với job Express stack mặc định, nhưng chênh lệch giá là như nhau.
  • Template + Simulate Local Path kết hợp được. Nếu dự án của bạn cũng cần đường dẫn tuyệt đối, hãy cấu hình Simulate Local Path trên lần nộp như bình thường (xem §Simulate Local Path). Template kiểm soát môi trường phần mềm; Simulate Local Path kiểm soát bố cục filesystem. Chúng là các mối quan tâm độc lập.

Chỉnh sửa và quản lý phiên bản template

Template có thể chỉnh sửa — bạn có thể sửa ghim phiên bản, thêm hoặc xóa plugin, hoặc thay thế file payload. Nhưng chỉnh sửa template ảnh hưởng đến tất cả job tương lai dùng nó; các job đang xử lý đã được giao tiếp tục với phiên bản template được chụp lại lúc nộp.

Với các studio cần kiểm soát phiên bản chặt chẽ qua các lần sửa đổi template, một mẫu phổ biến là sao chép rồi chỉnh sửa: khi cần cập nhật phiên bản plugin, sao chép template hiện có thành studio-archviz-2024-vray6-r2, thực hiện thay đổi ở đó, và cập nhật script nộp job của dự án để trỏ đến template mới. Template cũ không bị ảnh hưởng với các dự án đang xử lý phụ thuộc vào stack chính xác của nó.

Các lỗi phổ biến

  • "No matching workers — provisioning takes 5-10 minutes." Đây không phải lỗi, chỉ là thông báo. Job có template đầu tiên sau khi thay đổi stack sẽ cung cấp worker mới. Các job tiếp theo theo cùng template được giao ngay lập tức vì worker đã được khởi động sẵn.
  • "Plugin licence unavailable for template." Plugin bạn chỉ định không có trong danh mục giấy phép được host của chúng tôi. Liên hệ hỗ trợ — với plugin phổ biến chúng tôi thường bổ sung giấy phép được host trong vài ngày làm việc; với plugin đặc biệt chúng tôi có thể onboard giấy phép hoặc bạn cung cấp file giấy phép cùng với lần nộp.
  • "Renderer version no longer supported." Các phiên bản DCC hoặc renderer cũ hơn bị loại khỏi stack hoạt động định kỳ. Trình chỉnh sửa template hiển thị điều này khi lưu; cách khắc phục là cập nhật template lên phiên bản được hỗ trợ hoặc sao chép rồi chỉnh sửa sang bản dựng hiện tại.
  • "Job dispatched but worker stack does not match template." Hiếm gặp, nhưng đáng biết. Nếu điều này xảy ra, job thất bại khi kiểm tra sự tỉnh táo trước render và render farm tự động xếp lại hàng đợi trên worker đã xác nhận khớp. Bạn không bị tính phí cho lần giao thất bại.

Troubleshoot Machine

Troubleshoot Machine là đối tác chẩn đoán cho đường dẫn render sản xuất. Thay vì nộp job thực và chờ nó thất bại với thông báo lỗi, bạn khởi động một Troubleshoot Machine — một VM Windows khớp với stack phần mềm render node — và kết nối đến nó qua Microsoft Remote Desktop Connection. Bạn thấy chính xác những gì render worker sẽ thấy, có thể mở file scene, xác định nguyên nhân thất bại, sửa tại chỗ, lưu scene đã sửa về storage của bạn, rồi nộp job sản xuất thực sự với sự tự tin.

Vấn đề nó giải quyết

Hầu hết lỗi render thuộc hai nhóm: vấn đề cấp scene (plugin thiếu, tham chiếu asset bị hỏng, cài đặt renderer không tương thích với phiên bản trên worker) và vấn đề cấp môi trường (giấy phép không có sẵn, plugin không tải được, đường dẫn không khớp). Cả hai đều khó chẩn đoán từ xa — tín hiệu duy nhất bạn nhận được từ job sản xuất thất bại là log render, thường ngắn gọn.

Troubleshoot Machine thu hẹp vòng lặp chẩn đoán. Thay vì nộp → thất bại → đọc log → đoán → nộp lại → thất bại → đoán → nộp lại, bạn khởi động Troubleshoot Machine, thấy lỗi thực trong GUI DCC, sửa một lần, và nộp job thực hoạt động được.

Cơ chế hoạt động trên render farm

Khi bạn yêu cầu Troubleshoot Machine, render farm cung cấp VM Windows mới khớp với stack render node hiện tại cho DCC bạn chỉ định (và bất kỳ Render Node Template đang hoạt động nào, nếu bạn có). VM gắn kết SRF Spaces storage của bạn như ổ đĩa S: — vì vậy các file dự án bạn đã upload xuất hiện chính xác như trên render worker sản xuất. Bạn kết nối qua RDP từ máy trạm cục bộ.

VM có ngân sách thời gian — thường được đo bằng phút, được tính theo credits render với mức giá được ghi lại (kiểm tra dashboard để biết mức giá hiện tại; điều này thay đổi đôi khi). Khi bạn hoàn tất, bạn ngắt kết nối và nộp job sản xuất từ cùng dự án hoặc giải phóng VM.

Bắt đầu phiên Troubleshoot Machine

Các bước:

  1. Từ dashboard, điều hướng đến "Troubleshoot Machine" (hoặc mục dashboard tương đương — tên có thể thay đổi giữa các phiên bản).
  2. Chọn DCC khớp với dự án của bạn. VM sẽ được cung cấp với DCC đó được cài sẵn và khớp với Render Node Template đã khai báo của bạn (nếu có).
  3. Xác nhận ngân sách thời gian. Dashboard hiển thị chi phí credit mỗi phút; bạn cam kết thời gian phiên tối đa và có thể gia hạn trong phiên nếu cần.
  4. Chờ cung cấp. Thường mất vài phút — một VM mới đang được chuẩn bị với stack phần mềm của bạn.
  5. Nhận thông tin kết nối RDP. Dashboard cung cấp hostname, tên người dùng và mật khẩu (hoặc file RDP có thể tải về). Trên Windows, nhấp đúp vào file RDP để kết nối; trên macOS, dùng Microsoft Remote Desktop từ App Store.
  6. Kết nối. Bạn đang ở trên worker. Ổ đĩa S: chứa các file dự án SRF Spaces của bạn.

Sử dụng phiên làm việc

Sau khi kết nối, quy trình làm việc của bạn giống như khi bạn ngồi trực tiếp tại render worker:

  • Mở file scene của bạn từ S:. DCC khởi động theo phiên bản được chỉ định bởi template hoặc mặc định render farm cho DCC đó.
  • Tái hiện lỗi. Bất kỳ điều gì thất bại trong sản xuất — preview render, lỗi script, tham chiếu asset — sẽ tái hiện ở đây. Điều tra bằng các công cụ chẩn đoán của DCC.
  • Sửa scene. Liên kết lại asset thiếu, thay đổi cài đặt render, sửa tham chiếu plugin, hoặc bất kỳ điều gì chẩn đoán yêu cầu.
  • Lưu về S:. Lưu scene đã sửa vào S:\SuperRendersOutput\ hoặc thư mục khác trong SRF Spaces của bạn. Việc lưu là bền vững — khi bạn kết thúc phiên Troubleshoot Machine, scene đã sửa vẫn còn trong storage của bạn.
  • (Tùy chọn) Nộp job thực từ bên trong VM. Plugin nộp job DCC của SuperRenders được cài bên trong Troubleshoot Machine; bạn có thể nộp render job sản xuất từ bên trong VM, rồi ngắt kết nối và để render farm render bình thường.

Khi hoàn tất, ngắt kết nối RDP và kết thúc phiên từ dashboard. VM bị hủy; bất kỳ file nào bạn lưu vào S: vẫn còn trong SRF Spaces của bạn.

Các lỗi phổ biến

  • "Cannot connect to RDP — connection timed out." Kiểm tra xem mạng cục bộ hoặc VPN của bạn có cho phép RDP đi ra (cổng 3389) không. Một số mạng doanh nghiệp chặn RDP đi ra. Nếu vậy, yêu cầu nhóm IT của bạn đưa vào whitelist hostname Troubleshoot Machine.
  • "RDP credentials rejected." Tải lại file RDP từ dashboard — thông tin xác thực là riêng cho phiên và có thể hết hạn nếu phiên bị tạm dừng quá lâu.
  • "Ổ đĩa S: trống hoặc thiếu file." Ổ đĩa ánh xạ đến SRF Spaces của bạn — nếu file không xuất hiện, có thể upload lên SRF Spaces chưa hoàn thành khi VM được cung cấp, hoặc bạn đang nhìn sai thư mục. Mount mặc định thường là S:\<account-id>\.
  • "Bản sửa của tôi hoạt động trong Troubleshoot Machine nhưng job sản xuất vẫn thất bại." Nguyên nhân phổ biến nhất là job sản xuất được nộp với Render Node Template khác (hoặc stack mặc định) so với phiên Troubleshoot Machine đã dùng. Xác minh lựa chọn template trên lần nộp sản xuất khớp với cấu hình Troubleshoot Machine.

Simulate Local Path

Simulate Local Path là tiện ích nhỏ nhất trong bốn về phạm vi nhưng là tiện ích giải quyết danh mục lỗi "không render được trên cloud" lớn nhất. Một số scene DCC giải quyết asset theo đường dẫn tuyệt đối được mã hóa cứng — ví dụ C:\projects\studio\my-scene\textures\wood_01.tx — thay vì đường dẫn tương đối. Khi scene đó upload lên render farm, renderer không thể tìm thấy texture vì đường dẫn tuyệt đối không tồn tại trên worker. Simulate Local Path làm cho đường dẫn tuyệt đối đó tồn tại.

Vấn đề nó giải quyết

Giải pháp đơn giản cho loại vấn đề này là đổi đường dẫn scene trước khi nộp — chuyển mọi tham chiếu asset từ tuyệt đối sang tương đối — nhưng với một số quy trình làm việc điều này không thực tế:

  • Scene Anima (plugin nhân vật hoạt hình của AXYZ Design) ghi đường dẫn tuyệt đối vào file cache nhân vật khi lưu scene; đổi đường dẫn thủ công sẽ phá vỡ liên kết cache.
  • Corona Image Editor 4K-cache rendering ghi đường dẫn tuyệt đối mà renderer dự kiến tìm lại ở cùng đường dẫn đó khi render.
  • Quy trình export Substance / Substance Painter có thể nhúng đường dẫn tuyệt đối đến nguồn texture.
  • Tham chiếu Alembic asset đôi khi ghi đường dẫn tuyệt đối tùy thuộc vào cài đặt export của DCC.
  • Dự án archive cũ nơi việc đổi đường dẫn mọi tham chiếu asset là không thực tế, và studio chỉ muốn dự án render như hiện trạng.

Với những trường hợp này, Simulate Local Path nói với render farm: khi job này chạy, hãy tái tạo đường dẫn tuyệt đối trên worker để renderer tìm thấy asset ở nơi scene mong đợi.

Cơ chế hoạt động trên render farm

Khi bạn upload dự án với Simulate Local Path được bật, SuperRenders Client App (hoặc web upload, với cài đặt đúng) giữ nguyên cấu trúc đường dẫn tuyệt đối gốc trong quá trình upload. Trên render worker, render farm tạo cây thư mục tương ứng ở cùng đường dẫn tuyệt đối trước khi render bắt đầu — vì vậy nếu file scene của bạn tham chiếu D:\studio-2024\project-x\textures\wood.tx, worker có D:\studio-2024\project-x\textures\wood.tx thực sự lúc render và scene giải quyết đúng.

Cơ chế đáng tin cậy nhất khi ghép với tùy chọn "Auto keep local path" của SuperRenders Client App, tự động giữ nguyên đường dẫn tuyệt đối khi upload. Với web upload, bạn cài đặt cấu trúc đường dẫn thủ công trong cấu trúc thư mục SRF Spaces trước khi upload file.

Cấu hình Simulate Local Path

Có hai cách vào tính năng này:

Qua SuperRenders Client App (được khuyến nghị):

  1. Trong Client App, trước khi thêm file vào upload, mở cài đặt upload.
  2. Bật "Auto keep local path" (nhãn chính xác có thể thay đổi nhẹ giữa các phiên bản Client App — tìm hộp kiểm giữ nguyên đường dẫn).
  3. Thêm file dự án của bạn. Client App đọc đường dẫn tuyệt đối của mỗi file khi được thêm và giữ nguyên trong cây upload.
  4. Xác nhận cây đường dẫn trong preview upload. Bạn sẽ thấy cấu trúc đường dẫn tuyệt đối đầy đủ được phản chiếu trong SRF Spaces của bạn.
  5. Upload bình thường. Cấu trúc đường dẫn được chuyển cùng với file.
  6. Khi nộp job, bật "Simulate Local Path" — form nộp job trên dashboard hoặc Client App có hộp kiểm hoặc menu thả xuống cho điều này. Render farm sẽ tái tạo đường dẫn tuyệt đối trên worker.

Qua web upload (thủ công):

  1. Trong SRF Spaces (trình duyệt file web bên trong dashboard tài khoản), dùng nút "Create Folder" để tái tạo cấu trúc đường dẫn tuyệt đối thủ công. Ví dụ, nếu dự án của bạn tham chiếu D:\studio-2024\project-x\, tạo thư mục D: (theo nghĩa đen, tên thư mục là "D:"), rồi thư mục con studio-2024, rồi project-x, v.v.
  2. Upload file vào cây đường dẫn đã tái tạo. Mỗi file kết thúc ở đường dẫn tuyệt đối khớp trong SRF Spaces.
  3. Khi nộp job, bật "Simulate Local Path". Render farm sẽ đọc cấu trúc đường dẫn từ SRF Spaces và nhân bản trên worker.

Đường dẫn web upload thủ công hơn nhưng hoạt động đúng khi được cấu hình. Client App nhanh hơn và ít xảy ra lỗi hơn với các studio thực hiện điều này thường xuyên.

Lưu ý vận hành

  • Ký tự ổ đĩa. Trên render worker, ổ đĩa được mô phỏng (ví dụ D: nếu dự án dùng D:\…) là một mount logic, không phải ổ đĩa vật lý. Mount được tạo khi bắt đầu job và xóa khi kết thúc job; nó không bền vững.
  • Giới hạn độ dài đường dẫn. Windows có giới hạn độ dài đường dẫn lịch sử (khoảng 260 ký tự cho các ứng dụng cũ). Nếu đường dẫn tuyệt đối của bạn rất dài, một số DCC có thể thất bại khi tải file dù Simulate Local Path đã được cấu hình. Cách khắc phục là rút ngắn đường dẫn ở cấp dự án hoặc bật hỗ trợ đường dẫn dài trong DCC, mà hầu hết phiên bản hiện tại đều hỗ trợ.
  • Kết hợp đa DCC. Simulate Local Path có thể kết hợp với Render Node Template và Troubleshoot Machine — cây đường dẫn được mô phỏng xuất hiện giống nhau trong cả ba ngữ cảnh.

Các lỗi phổ biến

  • "Asset vẫn thiếu sau khi bật Simulate Local Path." Nguyên nhân phổ biến nhất là upload thực sự không giữ nguyên đường dẫn. Mở SRF Spaces trong web dashboard và xác nhận cấu trúc đường dẫn tuyệt đối tồn tại ở đó. Nếu không, upload lại với "Auto keep local path" được bật trong Client App.
  • "Render bắt đầu nhưng texture sai được tải." Đôi khi scene có nhiều asset cùng tên file ở các đường dẫn khác nhau; nếu mô phỏng đường dẫn không hoàn chỉnh, renderer có thể fallback sang file khác cùng tên. Xác minh cấu trúc đường dẫn đầy đủ được giữ nguyên trong SRF Spaces.
  • "Renderer báo access denied tại đường dẫn được mô phỏng." Điều này thường có nghĩa là đường dẫn liên quan đến tên thư mục dành riêng của Windows (con, aux, prn, v.v.) không thể được tạo như thư mục thông thường. Đổi đường dẫn dự án để tránh tên dành riêng.

API access

Truy cập theo chương trình vào hệ thống nộp job của Super Renders Farm nằm trong lộ trình. Một REST API công khai cho nộp job, truy vấn trạng thái và truy xuất output đang được thiết kế; tại thời điểm này, chưa có endpoint API công khai nào có sẵn để tích hợp trực tiếp.

Với nhu cầu nộp job theo chương trình hiện tại, các đường dẫn được hỗ trợ là:

  • SuperRenders Client App — Client App desktop () có thể được điều khiển từ script trên Windows và macOS qua giao diện dòng lệnh (khi có) hoặc bằng tự động hóa file-drop trên thư mục upload. Với các studio có công cụ tự động hóa pipeline đã thiết lập, Client App là điểm tích hợp thực hành tốt nhất hiện tại.
  • Plugin nộp job DCC — plugin theo DCC (3ds Max, Maya, Cinema 4D) tích hợp với môi trường script của DCC (MAXScript, Python, v.v.) và có thể được điều khiển từ các script pipeline chạy bên trong DCC.

Khi API công khai ra mắt, phần này sẽ được thay thế bằng tài liệu tham chiếu API đầy đủ (xác thực, endpoint, giới hạn tốc độ, ví dụ SDK). Với các studio bị chặn bởi API công khai cho tích hợp pipeline, hãy liên hệ hỗ trợ để chia sẻ use case — lộ trình được định hướng bởi các yêu cầu pipeline thực tế.

Tham chiếu chéo

  • — luồng upload-nộp-tải về mặc định không cần các tiện ích này
  • — cài đặt và sử dụng ứng dụng desktop
  • — luồng nộp job qua trình duyệt
  • — đường dẫn chuyển dự án lớn
  • — cách credits render được tính, bao gồm giá phiên Troubleshoot Machine
  • — tài liệu tham chiếu khắc phục sự cố đa DCC
  • — so sánh các phương thức upload
  • , , — thiết lập nộp job theo DCC kết hợp với các tiện ích này

FAQ

Q: Tôi có cần Render Node Template cho mọi job không? A: Không. Hầu hết job chạy tốt trên stack phần mềm mặc định của render farm — các phiên bản DCC và renderer phổ biến nhất với các plugin phổ biến nhất. Render Node Template dành cho các trường hợp bạn cần ghim phiên bản qua một dự án dài hạn, hoặc khi bạn dùng plugin không có trong danh mục mặc định. Nếu bạn không chắc có cần hay không, stack mặc định hầu như luôn là lựa chọn đúng để bắt đầu.

Q: Phiên Troubleshoot Machine có giá bao nhiêu? A: Phiên Troubleshoot Machine được tính theo credits render với mức giá mỗi phút hiển thị trên dashboard khi bắt đầu phiên. Mức giá thay đổi đôi khi khi chúng tôi cập nhật hạ tầng VM; dashboard luôn là nguồn chính xác nhất. Với một phiên chẩn đoán 30 phút thông thường, dự kiến chi phí là một phần nhỏ so với chi phí của một job render đầy đủ.

Q: Tôi có thể dùng Simulate Local Path nếu dự án của tôi trên macOS hoặc Linux không? A: Môi trường render worker là Windows, nên đường dẫn tuyệt đối được mô phỏng dưới dạng đường dẫn Windows (dạng D:\…). Nếu dự án của bạn được tạo trên macOS hoặc Linux với đường dẫn tuyệt đối dạng /Users/… hoặc /home/…, mô phỏng đường dẫn vẫn có thể hoạt động — render farm tạo mount Windows logic khớp với chuỗi đường dẫn mà scene mong đợi — nhưng trong thực tế các dự án được tạo trên Mac/Linux thường dùng đường dẫn tương đối và không cần tiện ích này.

Q: Render Node Template có làm tăng thời gian render không? A: Job đầu tiên được nộp với template mới có thể mất thêm vài phút để giao trong khi render farm cung cấp worker khớp. Các job tiếp theo theo cùng template được giao với tốc độ stack mặc định vì các worker khớp đã được khởi động sẵn. Thời gian mỗi job thực tế sau khi template đã hoạt động là như nhau so với stack mặc định.

Q: Tôi có thể chỉnh sửa Render Node Template khi job đang xử lý không? A: Có, nhưng job đang xử lý tiếp tục với phiên bản template được chụp lại lúc nộp. Việc chỉnh sửa chỉ ảnh hưởng đến các lần nộp tương lai. Với các dự án cần kiểm soát phiên bản chặt chẽ hơn, hãy sao chép template sang tên mới và cập nhật script nộp job của bạn để trỏ đến bản sao mới thay vì chỉnh sửa template hiện có.

Q: Phiên bản DCC của tôi không có trong menu thả xuống Render Node Template. Phải làm gì? A: Liên hệ hỗ trợ và cho biết phiên bản bạn cần. Với DCC phổ biến chúng tôi thường host phiên bản hiện tại và một vài phiên bản trước; các phiên bản rất cũ có thể đã bị loại khỏi stack hoạt động. Chúng tôi thường có thể onboard phiên bản cũ trong vài ngày, hoặc hướng dẫn bạn đến phiên bản được hỗ trợ gần nhất tương thích với scene của bạn.

Q: Có API công khai để nộp job từ pipeline của tôi không? A: Chưa có. API REST công khai nằm trong lộ trình. Hiện tại, đường dẫn nộp job theo chương trình được khuyến nghị là SuperRenders Client App (được điều khiển từ script) hoặc plugin nộp job theo DCC (được điều khiển từ môi trường script gốc của DCC). Nếu use case tự động hóa pipeline của bạn bị chặn bởi API công khai cụ thể, hãy liên hệ hỗ trợ — lộ trình được định hướng bởi các yêu cầu pipeline thực tế, và ý kiến của bạn giúp ưu tiên.

Q: Tôi có thể chạy Troubleshoot Machine với Render Node Template không? A: Có — và đây là mẫu được khuyến nghị khi bạn đang gỡ lỗi job có template. Phiên Troubleshoot Machine đọc Render Node Template đang hoạt động khi cung cấp VM và cung cấp VM với stack phần mềm khớp. Bạn thấy chính xác những gì render worker sản xuất sẽ thấy, bao gồm các phiên bản plugin trong template.

Last updated: 13 tháng 5, 2026