Lưu tệp AI: từ URL đầu ra PiAPI đến kho lưu trữ bền vững
Tác vụ tạo hoàn tất cung cấp kết quả, nhưng URL do nhà cung cấp lưu trữ không phải thư viện phương tiện vĩnh viễn. Nếu người dùng cần mở, sửa hoặc tải kết quả sau này, hãy sao chép tệp vào kho bạn kiểm soát và theo dõi bản sao riêng với quá trình tạo.
1. Đọc đầu ra của mô hình đã dùng
Truy vấn ID đã lưu và yêu cầu data.status là completed trước khi trích xuất tệp. Cấu trúc data.output khác nhau theo mô hình và loại tác vụ. Dùng ví dụ tương ứng; đừng giả định mọi phản hồi đều có cùng URL ảnh hoặc video ở cấp cao nhất.
Ví dụ, phản hồi Kling trong tài liệu có mảng works chứa tài nguyên video. Mô hình khác dùng trường khác. Lưu ID, mô hình, loại tác vụ, thời gian hoàn tất và chỉ số tài nguyên đã chọn cùng công việc để lần thử lại tìm đúng kết quả.
2. Sao chép sớm và kiểm tra thời hạn theo dịch vụ
Tài liệu lưu đầu ra PiAPI nêu quy tắc khác nhau theo dịch vụ và nơi lưu trữ. Một số mục có thời hạn ngắn; mục khác theo chính sách CDN của nhà cung cấp. Trang cũng chứa dịch vụ cũ. Đừng áp dụng một thời hạn cho mọi mô hình hiện tại hoặc coi thời hạn không được ghi là vô hạn.
Sau khi hoàn tất, bắt đầu sao chép nền bằng webhook hoặc polling. Lưu bền vững công việc trước khi xác nhận callback. Chuỗi dưới đây mô tả trạng thái lưu trữ của ứng dụng, không phải trạng thái API tác vụ PiAPI.
generation completed → copy queued → downloading → verified → saved
↘ copy failed → retry copy3. Xác minh dữ liệu trước khi đánh dấu đã lưu
Tải URL kết quả mà không chuyển tiếp khóa API PiAPI. Giới hạn đích được phép, xác minh chuyển hướng và đặt giới hạn dung lượng, thời gian. Kiểm tra mã HTTP, số byte thực, loại phương tiện dự kiến và khả năng đọc cơ bản. Trang lỗi HTML trả 200 không phải video đã lưu.
Ghi vào đối tượng tạm, tính mã kiểm tra và chỉ công bố đối tượng cuối sau khi xác minh thành công. Dùng khóa ổn định dựa trên ID tác vụ và chỉ số tài nguyên. Ghi khóa đối tượng, số byte, mã kiểm tra và thời gian lưu; cung cấp URL do bạn kiểm soát theo chính sách truy cập.
4. Thử lại lưu trữ tách biệt với tạo nội dung
Nếu sao chép lỗi, giữ quá trình tạo ở trạng thái hoàn tất và thử sao chép lại khi nguồn còn khả dụng. Bản ghi duy nhất bền vững tránh mục phương tiện trùng lặp. Nếu URL không đọc được, truy vấn lại tác vụ và kiểm tra đầu ra hiện tại; điều này không bảo đảm khôi phục tệp hết hạn. Kiểm tra sự kiện lặp, tải dở dang và URL không khả dụng trước triển khai.
Tham khảo: lưu đầu ra, truy vấn tác vụ Kling và webhook. Đây là mẫu lưu trữ của ứng dụng, không phải cam kết lưu trữ lâu dài từ PiAPI.
