Khi bạn tạo tài sản 3D thông qua Meshy API, kết quả của mỗi tác vụ sẽ được lưu trữ tạm thời trên máy chủ của Meshy. Việc hiểu rõ khoảng thời gian lưu trữ giúp bạn lập kế hoạch tích hợp và đảm bảo tải xuống các kết quả trước khi chúng hết hạn.
Thời gian lưu trữ tài sản theo loại tác vụ
Thời gian lưu trữ thay đổi tùy theo loại tác vụ:
Loại tác vụ | Thời gian lưu trữ |
Text to 3D | 3 ngày sau khi tác vụ hoàn tất |
Image to 3D | 3 ngày sau khi tác vụ hoàn tất |
Rigging | 2 tháng sau khi tác vụ hoàn tất |
Text to 3D và Image to 3D
Các tác vụ và kết quả của chúng — tệp mô hình, hình ảnh xem trước và texture — được lưu trữ trong 3 ngày kể từ thời điểm tác vụ hoàn tất. Sau khoảng thời gian này, tác vụ và tất cả các URL tải xuống liên quan sẽ không còn truy cập được.
Mỗi phản hồi tác vụ API đều bao gồm trường expires_at (dấu thời gian Unix tính bằng mili giây) cho biết chính xác thời điểm tác vụ sẽ bị xóa:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Theo dõi giá trị này trong quá trình tích hợp của bạn và kích hoạt tải xuống trước khi nó hết hạn.
Các tác vụ Rigging
Các tác vụ Rigging được lưu trữ trong 2 tháng sau khi hoàn tất. Khoảng thời gian kéo dài này cho phép bạn tiếp tục thêm hoạt ảnh mới vào cùng một nhân vật đã rig bằng cách sử dụng rig task ID ban đầu — mà không cần phải rig lại mesh.
Để tạo hoạt ảnh cho một rig hiện có, hãy tham chiếu rig task ID trong yêu cầu hoạt ảnh của bạn tại bất kỳ thời điểm nào trong khoảng thời gian lưu trữ 2 tháng.
Truy xuất tài sản của bạn
Để truy cập các tài sản được tạo qua API trước khi chúng hết hạn:
Tải xuống ngay lập tức. Ngay khi tác vụ đạt trạng thái
SUCCEEDED, hãy tải các tệp kết quả (GLB, FBX, OBJ, v.v.) về kho lưu trữ của riêng bạn.Sử dụng endpoint danh sách tác vụ. Truy xuất các rig task ID gần đây và URL kết quả thông qua các endpoint API danh sách Text to 3D hoặc Image to 3D.
FAQ
1.Tại sao mô hình được tạo qua API của tôi không xuất hiện trong workspace?
Đây là hành vi được thiết kế. Các tài sản được tạo qua API không xuất hiện trong giao diện Meshy Workspace. Đây là chủ ý — API và Workspace có vòng đời tài sản riêng biệt với các quy tắc hết hạn khác nhau.
2.Tại sao URL tác vụ của tôi trả về 404?
Nếu dấu thời gian expires_at của tác vụ đã qua, tài sản đã bị xóa khỏi máy chủ của Meshy. Bạn sẽ cần gửi lại tác vụ tạo. Để tránh điều này trong tương lai, hãy thiết lập tải xuống tự động về kho lưu trữ của riêng bạn ngay khi các tác vụ hoàn tất thành công.
3.Tôi có thể thêm hoạt ảnh mới cho nhân vật sau khi tác vụ rig hết hạn không?
Các tác vụ Rigging có sẵn trong 2 tháng, cho bạn khoảng thời gian dồi dào để tiếp tục thêm hoạt ảnh. Nếu tác vụ rig đã hết hạn (cũ hơn 2 tháng), bạn sẽ cần rig lại mesh ban đầu.
Lưu ý: Meshy không đảm bảo khả năng tương thích của bộ xương giữa các lần rig riêng biệt.