Khi bạn tạo tài nguyên 3D thông qua Meshy API, mỗi tác vụ và kết quả đầu ra của nó được lưu trữ trên máy chủ của Meshy trong một khoảng thời gian giới hạn. Thời gian lưu trữ phụ thuộc vào gói tài khoản của bạn — không phụ thuộc vào loại tác vụ. Hãy tải kết quả đầu ra của bạn xuống trước khi chúng hết hạn.
Thời Gian Lưu Trữ Tài Nguyên Theo Gói
Gói | Thời gian lưu trữ |
Pro, Premium, Ultra | 3 ngày |
Studio | 14 ngày |
Enterprise | Lưu trữ vĩnh viễn |
Thời gian lưu trữ áp dụng cho mọi loại tác vụ API, bao gồm cả kết quả đầu ra của tác vụ — tệp mô hình, hình ảnh xem trước và texture. Sau khi thời gian này kết thúc, tác vụ và tất cả URL tải xuống của tác vụ sẽ bị xóa và không thể khôi phục.
Bạn có thể so sánh các gói trên trang giá của chúng tôi.
Kiểm Tra Thời Điểm Hết Hạn Của Tác Vụ
Mọi phản hồi của 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": { ... }
}
}Hãy theo dõi giá trị này trong tích hợp của bạn và tải xuống các kết quả đầu ra trước khi mốc thời gian đó qua đi.
Truy Xuất Tài Nguyên Của Bạ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 đầu ra (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 ID tác vụ gần đây và URL đầu ra bằng endpoint danh sách tương ứng với từng loại tác vụ.
Câu Hỏi Thường Gặp
1. Tại sao tôi không tìm thấy tài nguyên mình đã tạo?
Nếu bạn không tải xuống kịp, tài nguyên đã bị xóa khi hết thời hạn lưu trữ. Tài nguyên đã xóa không thể khôi phục — bạn sẽ cần gửi lại tác vụ.
2. Nếu tôi gọi DELETE trên một tác vụ, các hình ảnh và mô hình tôi đã tải lên có bị xóa luôn không?
Xóa một tác vụ sẽ xóa vĩnh viễn tác vụ đó, bao gồm cả mô hình và dữ liệu của tác vụ. Bạn không thể hoàn tác thao tác xóa, vì vậy hãy tải xuống mọi thứ bạn cần trước.
3. Tại sao mô hình do API tạo của tôi không hiển thị trong không gian làm việc?
Đây là điều bình thường. Tài nguyên do API tạo không xuất hiện trong Không gian làm việc Meshy — API và Không gian làm việc có vòng đời tài nguyên riêng.
4. Tại sao URL tác vụ của tôi trả về 404?
Thời điểm expires_at của tác vụ đã qua, nên tài nguyên đã bị xóa. Hãy gửi lại tác vụ và thiết lập tải xuống tự động về kho lưu trữ của riêng bạn ngay khi tác vụ thành công.