Hướng dẫn cốt lõi
Lưu giữ dữ liệu
Thời hạn bạn có thể truy cập chi tiết yêu cầu và phương tiện, cũng như cách lưu giữ các kết quả quan trọng
Chi tiết về yêu cầu và phản hồi, cùng các kết quả phương tiện được lưu tự động, sẽ khả dụng trong 30 ngày. Lịch sử trò chuyện, hồ sơ thanh toán, Media Assets đã lưu và các tệp bạn tải xuống được xử lý riêng biệt.
Xem Lưu giữ dữ liệu TokenLab để biết giải thích đầy đủ.
Chi tiết yêu cầu và phản hồi
Nội dung yêu cầu và phản hồi đã lưu khả dụng trong Console, Request Debugger và TokenLab Agent (Assistant) trong 30 ngày kể từ khi được ghi lại. Sau khi hết hạn, các công cụ này không thể truy xuất nội dung gốc đó nữa. Tóm tắt yêu cầu, mức sử dụng và hồ sơ thanh toán có thể vẫn khả dụng. Hãy tải xuống mọi chi tiết bạn cần trước khi chúng hết hạn.
Một bản ghi đã hết hạn khác với nội dung chưa bao giờ được lưu hoặc không thể tải. Hãy kiểm tra trạng thái hiển thị khi khắc phục sự cố.
Phương tiện được tạo
TokenLab tự động lưu các bản sao của hình ảnh, video, âm thanh và kết quả 3D có thể tải xuống (bao gồm các tệp Worlds) được hỗ trợ dưới dạng các liên kết HTTP(S). Mọi URL phương tiện bạn nhận được cho các kết quả này đều là URL của TokenLab: trong phản hồi API, trạng thái tác vụ, resultUrls của webhook task.completed và content.video_url cùng content.last_frame_url của callback tương thích với Seedance.
https://api.tokenlab.sh/v1/media-results/{id}.{ext}?token=…Phần mở rộng khớp với loại phương tiện, ví dụ: png, mp4, mp3 hoặc glb. URL vẫn hợp lệ trong 30 ngày kể từ khi kết quả được ghi lại lần đầu. Việc xem lại, thử lại hoặc kiểm tra trạng thái tác vụ không khởi động lại khoảng thời gian đó.
URL hoạt động ngay khi bạn nhận được. Trong khi TokenLab vẫn đang lưu bản sao, URL sẽ truyền phát tệp từ nguồn thông qua TokenLab. Khi bản sao đã sẵn sàng, URL sẽ phục vụ bản sao đó. Nếu việc lưu thất bại, URL sẽ truyền phát từ nguồn trong tối đa 24 giờ sau khi kết quả được tạo, sau đó trả về HTTP 410.
Để truy cập lâu hơn, hãy tải xuống tệp hoặc lưu tệp vào Media Assets khi tệp còn khả dụng. Bản sao được lưu vào Media Assets sẽ không hết hạn cùng với bản sao tự động 30 ngày.
Việc lưu tự động không bao gồm các trang Worlds tương tác, các phụ thuộc mô hình được tham chiếu bên ngoài, phương tiện Base64 hoặc nhị phân nội dòng, tệp đầu vào hoặc các liên kết trong văn bản được tạo. Hãy tự lưu các kết quả này nếu bạn cần chúng sau này. Hồ sơ tác vụ có thời hạn riêng; một tác vụ đã hoàn thành không đảm bảo phương tiện của nó vẫn khả dụng.
Kiểm tra tính khả dụng của phương tiện thông qua API
Các phản hồi JSON của AI-protocol bao gồm media_retention cho các kết quả được hỗ trợ: days và items, với mỗi mục báo cáo url, kind, status (saved, saving, failed hoặc expired), expires_at và content_type (nếu biết). Nếu trạng thái lưu không được biết trong giới hạn thời gian phản hồi, phản hồi sẽ bỏ qua media_retention; URL phương tiện vẫn hoạt động. Bạn cũng có thể thêm metadata=true vào URL kết quả phương tiện để kiểm tra trạng thái hiện tại của nó. Nó trả về status, expires_at, content_type và kind. Trạng thái saving hoặc thất bại không có nghĩa là tệp đã được lưu.
Các tác vụ thất bại và đang thực hiện sẽ trả về các trường URL phương tiện trống.
| Phản hồi URL kết quả phương tiện | Ý nghĩa | Việc cần làm |
|---|---|---|
404 media_not_found | Token hoặc phần mở rộng tệp không khớp với kết quả | Sử dụng chính xác URL bạn đã nhận |
410 media_expired | Thời hạn 30 ngày đã kết thúc hoặc việc lưu thất bại hơn 24 giờ trước | Tệp không còn khả dụng thông qua TokenLab |
502 hoặc 503 media_unavailable | Kết quả vẫn đang được ghi lại hoặc TokenLab đang bận | Thử lại sau khoảng thời gian Retry-After nếu có, hoặc sau một thời gian chờ ngắn |
Đối với kết quả hình ảnh, video và âm thanh, URL kết quả phương tiện sẽ chuyển hướng đến URL tải xuống kéo dài tối đa năm phút. Nếu liên kết đó hết hạn trong khi kết quả vẫn nằm trong cửa sổ 30 ngày, hãy yêu cầu lại URL kết quả phương tiện. Việc này không kéo dài thời hạn hết hạn của kết quả. Các tệp 3D truyền phát trực tiếp từ chính URL kết quả phương tiện.
Lịch sử trò chuyện TokenLab Agent (Assistant)
Đây là các cuộc trò chuyện của bạn với trợ lý TokenLab tích hợp sẵn. Chúng được lưu trữ riêng biệt với nhật ký yêu cầu API và không tự động bị xóa khi các nhật ký đó đạt mốc 30 ngày. Văn bản đã lưu trong cuộc trò chuyện có thể vẫn còn đó, nhưng chi tiết yêu cầu và phương tiện đã hết hạn không thể tải lại từ cuộc trò chuyện đó.
Bạn có thể xóa một cuộc trò chuyện khỏi lịch sử Agent. Thao tác này sẽ xóa cuộc trò chuyện khỏi danh sách lịch sử; nó không xóa tất cả dữ liệu liên quan hoặc xóa lịch sử yêu cầu, thanh toán, hỗ trợ hoặc Console. Trợ lý chỉ có thể điều tra nội dung yêu cầu và phản hồi gốc khi nó nằm trong cửa sổ 30 ngày; hồ sơ thanh toán và mức sử dụng cũ hơn có thể vẫn khả dụng.
Các hồ sơ và tệp khác
- Thông tin tài khoản, lịch sử thanh toán và mức sử dụng, cùng hồ sơ tác vụ được giữ riêng biệt để cung cấp dịch vụ tài khoản, thanh toán và hỗ trợ. Thời hạn lưu giữ của chúng không bị giới hạn trong cửa sổ 30 ngày của chi tiết yêu cầu.
- Các tệp xuất bản ghi cuộc gọi của tổ chức khả dụng để tải xuống trong 90 ngày. Hãy tải xuống trước khi chúng hết hạn; việc hết hạn của tệp xuất không xóa các bản ghi cơ sở.
- Các tệp tạm thời được tải lên trong Console hoặc TokenLab Agent (Assistant) có thể được sử dụng trong các yêu cầu mới trong 24 giờ. Sau đó, hãy tải lại tệp nếu bạn cần sử dụng trong yêu cầu mới.
- Các tệp bạn tải xuống hoặc xuất, bộ nhớ trình duyệt và các bản sao do ứng dụng của bạn tự lưu đều nằm trong tầm kiểm soát của bạn. Các giới hạn lưu giữ của TokenLab không xóa các bản sao đó.
Các khoảng thời gian trên mô tả tính khả dụng thông qua TokenLab. Việc xóa khỏi bộ nhớ có thể hoàn tất sau thời điểm hết hạn truy cập. Các nhà cung cấp dịch vụ AI xử lý yêu cầu của bạn có chính sách dữ liệu và thời hạn lưu giữ riêng.
Để khắc phục sự cố yêu cầu, xem Nhật ký và khắc phục sự cố. Để thăm dò tác vụ phương tiện, xem Công việc không đồng bộ và thăm dò.