Video Eraser API สำหรับประมวลผลคำบรรยายและลายน้ำในวิดีโอและภาพ

550W API สำหรับนักพัฒนารองรับอะไรบ้าง

550W Developer API ให้เซิร์ฟเวอร์ส่งงานที่ได้รับอนุญาตเพื่อประมวลผลคำบรรยาย/ข้อความหรือลายน้ำที่มองเห็นในกรอบสี่เหลี่ยมที่เลือก รวมถึงลายน้ำในภาพ การเข้าถึง API ไม่ได้ให้สิทธิ์ในสื่อต้นฉบับ และต้องตรวจผลลัพธ์ด้วยคน

ประมวลผลคำบรรยายและลายน้ำในวิดีโอ

สำหรับวิดีโอ ให้อัปโหลด MP4 หรือ MOV ผ่าน /open/uploadVideo หรือส่ง videoUrl สาธารณะไปยัง /open/submitTask คำขอต้องระบุขนาด ระยะเวลา และกรอบที่ต้องการแก้ไข งานประมวลผลแบบอะซิงโครนัส ตรวจสถานะผ่าน /open/taskDetail หรือ /open/taskList

ลบลายน้ำบนภาพ

สำหรับภาพ /open/removeImageWatermark รับ JPG, PNG, BMP, WebP, AVIF, TIFF หรือ SVG ขนาดไม่เกิน 50 MB โดยรอผลลัพธ์หรือรับรหัสงานเพื่อตรวจภายหลังได้ Eraser API ไม่มีฟังก์ชันดาวน์โหลดวิดีโอจากลิงก์เพื่อลบลายน้ำ จึงไม่ควรโฆษณาว่ารองรับ

ใช้ API กับงานลบข้อความในวิดีโอและลายน้ำบนภาพที่คุณมีสิทธิ์แก้ไขเท่านั้น

ลำดับคำขอที่พร้อมใช้จริง

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

ยืนยันตัวตนและอัปโหลด

ส่ง width, height, duration และพิกัด x1, y1, x2, y2 ไปยัง /open/submitTask โหมด Standard (mode=normal, ค่าเริ่มต้น) ประมวลผลพื้นที่ภายในกรอบ ส่วน Protect (mode=protect) คงพื้นที่ภายในไว้และประมวลผลภายนอก ไม่ใช่โหมดเพิ่มคุณภาพ ตั้งค่า removeAudio เฉพาะเมื่อต้องลบเสียงก่อนประมวลผล

ส่งงานโดยป้องกันการสร้างซ้ำ

ส่ง Idempotency-Key ยาวไม่เกิน 128 อักขระ หากการเชื่อมต่อหลุดหลังส่งงาน ให้ลองงานเดิมด้วยคีย์เดิมเพื่อหลีกเลี่ยงงานใหม่ที่คิดเครดิตอีกครั้ง เก็บ taskId คู่กับรหัสสื่อในระบบของคุณ

รับและตรวจผลลัพธ์

สำหรับผลลัพธ์แบบอะซิงโครนัส ให้ระบุ callbackUrl สาธารณะแบบ HTTP(S) เมื่อได้รับ Webhook สถานะสุดท้าย ให้ตอบรับอย่างรวดเร็วแล้วตรวจซ้ำผ่าน /open/taskDetail รองรับการส่ง Webhook ซ้ำ และใช้การดึงสถานะเป็นทางสำรอง

เก็บคีย์บนเซิร์ฟเวอร์ ป้องกันงานซ้ำ เก็บ taskId และตรวจ Webhook เพื่อให้การลองใหม่ปลอดภัย

ขีดจำกัดข้อมูลเข้าและการตรวจคุณภาพ

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

ตรวจไฟล์ก่อนใช้เครดิต

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

ให้คนตรวจฉากที่ยาก

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

ปฏิเสธไฟล์ที่ไม่รองรับตั้งแต่ต้น และให้คนตรวจเมื่อพื้นที่แก้ไขทับรายละเอียดที่เคลื่อนไหว

การคิดเครดิต ข้อผิดพลาด และการลองใหม่

งานลบคำบรรยายคิดเครดิตตามระยะเวลาและความละเอียด อัตราปัจจุบันคือ 1.3 เครดิตต่อวินาทีที่ 720p หรือต่ำกว่า และ 1.6 เครดิตที่สูงกว่า 720p ถึง 1080p วิดีโอ 30 วินาทีจึงประมาณ 39 หรือ 48 เครดิต ตรวจยอดผ่าน /open/queryCredits ก่อนรับงานจำนวนมาก

ประเมินเครดิตก่อนส่ง

คำตอบมี code และ message ส่วนงานมี status และ resultUrl เมื่อเสร็จ งานล้มเหลวอาจมี failCode, failReason และ refundStatus ลองใหม่หลังปัญหาเครือข่ายชั่วคราวโดยเพิ่มเวลารอ แต่ควรแก้พารามิเตอร์ ไฟล์ที่ไม่รองรับ หรือเครดิตไม่พอก่อนส่งอีกครั้ง

จัดการรหัสข้อผิดพลาดที่คงที่

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

วัดไฟล์ที่ผ่านการอนุมัติและต้นทุนจริง ไม่ใช่เพียง HTTP ที่ตอบสำเร็จ

เริ่มเชื่อมต่อในสี่ขั้นตอน

สร้าง API Key จากหน้านักพัฒนาแล้วส่งวิดีอตัวอย่างหนึ่งชิ้น จากนั้นแสดงสถานะ waiting, processing, success และ failed ในผลิตภัณฑ์ของคุณ เพิ่มการป้องกันงานซ้ำ Webhook และการดึงสถานะสำรอง ก่อนทดลองชุดเล็กและตรวจทุกผลลัพธ์

ทดลองก่อนเพิ่มปริมาณ

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