เก็บไฟล์ AI: จาก URL ผลลัพธ์ PiAPI สู่พื้นที่จัดเก็บถาวร

งานสร้างที่เสร็จให้ผลลัพธ์ แต่ URL ที่ผู้ให้บริการโฮสต์ไม่ใช่คลังสื่อถาวร หากผู้ใช้ต้องเปิด แก้ไข หรือดาวน์โหลดภายหลัง ให้คัดลอกไฟล์ไปยังพื้นที่ที่คุณควบคุม และติดตามการคัดลอกแยกจากการสร้าง

1. อ่านผลลัพธ์ของโมเดลที่ใช้

ดึงงานด้วยรหัสที่บันทึกไว้ และกำหนดให้ data.status เป็น completed ก่อนดึงไฟล์ รูปแบบ data.output ต่างกันตามโมเดลและชนิดงาน ใช้ตัวอย่างที่เกี่ยวข้อง อย่าสมมติว่าทุกคำตอบมี URL ภาพหรือวิดีโอเดียวกันในระดับบนสุด

เช่น คำตอบ Kling ในเอกสารมีอาร์เรย์ works ที่บรรจุทรัพยากรวิดีโอ โมเดลอื่นใช้ฟิลด์ต่างกัน บันทึกรหัสงาน โมเดล ชนิดงาน เวลาเสร็จ และดัชนีทรัพยากรที่เลือกคู่กับงานของแอป เพื่อให้การลองใหม่พบผลลัพธ์เดิม

2. คัดลอกทันทีและตรวจอายุเก็บตามบริการ

เอกสารเก็บผลลัพธ์ PiAPI ระบุกฎต่างกันตามบริการและตำแหน่งโฮสต์ บางรายการกำหนดเวลาสั้น บางรายการขึ้นกับนโยบาย CDN ของผู้ให้บริการ และมีบริการเก่ารวมอยู่ด้วย อย่านำระยะเวลาหนึ่งไปใช้กับทุกโมเดลปัจจุบัน หรือมองว่าระยะเวลาที่ไม่ระบุคือไม่จำกัด

หลังเสร็จให้เริ่มคัดลอกเบื้องหลังผ่านwebhook หรือ polling บันทึกงานอย่างถาวรก่อนตอบรับ callback ลำดับด้านล่างเป็นสถานะการเก็บข้อมูลของแอป ไม่ใช่สถานะใน API งาน PiAPI

generation completed → copy queued → downloading → verified → saved
                                      ↘ copy failed → retry copy

3. ตรวจข้อมูลจริงก่อนระบุว่าบันทึกแล้ว

ดาวน์โหลดจาก URL ผลลัพธ์โดยไม่ส่งต่อคีย์ API ของ PiAPI จำกัดปลายทาง ตรวจการเปลี่ยนเส้นทาง และตั้งขีดจำกัดขนาดกับเวลา ตรวจสถานะ HTTP จำนวนไบต์จริง ชนิดสื่อที่คาด และความสามารถในการอ่านเบื้องต้น หน้า HTML แจ้งข้อผิดพลาดที่ตอบ 200 ไม่ใช่วิดีโอที่บันทึกสำเร็จ

เขียนเป็นออบเจ็กต์ชั่วคราว คำนวณ checksum และเผยแพร่ออบเจ็กต์สุดท้ายหลังตรวจผ่านเท่านั้น ใช้คีย์คงที่จากรหัสงานและดัชนีทรัพยากร บันทึกคีย์ จำนวนไบต์ checksum และเวลาจัดเก็บ แล้วให้ URL ที่คุณควบคุมตามนโยบายการเข้าถึง

4. ลองจัดเก็บใหม่แยกจากการสร้าง

หากคัดลอกล้มเหลว ให้คงการสร้างเป็นเสร็จแล้ว และลองคัดลอกใหม่ขณะต้นทางยังใช้ได้ ระเบียนไม่ซ้ำแบบถาวรป้องกันรายการสื่อซ้ำ หาก URL อ่านไม่ได้ ให้ดึงงานอีกครั้งและตรวจผลลัพธ์ปัจจุบัน ซึ่งไม่รับประกันว่าจะกู้ไฟล์หมดอายุได้ ทดสอบเหตุการณ์ซ้ำ การดาวน์โหลดไม่ครบ และ URL ใช้ไม่ได้ก่อนเปิดใช้

อ้างอิง: การเก็บผลลัพธ์, การดึงงาน Kling และWebhook นี่คือรูปแบบจัดเก็บของแอป ไม่ใช่คำรับรองการเก็บถาวรจาก PiAPI