Video Eraser API לטיפול בכתוביות ובסימני מים בסרטונים ובתמונות
עודכן · תהליך השימוש במוצר נבדק על ידי 550W AI Labs
מה באמת נתמך ב־API למפתחים של 550W
ה־API למפתחים של 550W מאפשר לשרת לשלוח משימות מורשות לטיפול בכתוביות או בסימן מים גלוי בתוך מלבן שנבחר, וכן להסרת סימני מים מתמונות. השימוש ב־API אינו מעניק זכויות בחומר המקור, ויש לבדוק את התוצאות.
טיפול בכתוביות ובסימני מים בסרטון
אפשר להעלות סרטון MP4 או MOV דרך /open/uploadVideo, או להעביר videoUrl ציבורי אל /open/submitTask. הבקשה כוללת ממדים, משך ומלבן לטיפול. המשימה פועלת באופן אסינכרוני; את מצבה בודקים דרך /open/taskDetail או /open/taskList.
הסרת סימני מים מתמונות
לגבי תמונות, /open/removeImageWatermark מקבל JPG, PNG, BMP, WebP, AVIF, TIFF ו־SVG עד 50 MB. הוא עשוי להחזיר תוצאה מיד או מזהה משימה לבירור מאוחר יותר. ה־API של Eraser אינו מספק הורדת סרטון מקישור לשם הסרת סימן מים, ולכן אין להבטיח יכולת כזאת במוצר.
השתמשו ב־API לניקוי מורשה של טקסט בווידאו וסימני מים בתמונות, בהתאם ליכולות המתועדות.
תהליך בקשות מתאים לייצור
כל בקשה מחייבת userNo ו־apiKey. שמרו אותם בשרת: מפתח שמופיע בקוד דפדפן או יישומון ניתן לחילוץ. אפשר להעלות תחילה את הסרטון או לספק כתובת HTTP(S) ציבורית שהשירות יכול לגשת אליה.
| שלב | נקודת קצה | מה שומרים |
|---|---|---|
| העלאה | /open/uploadVideo | videoUrl, coverUrl, width, height, duration |
| שליחה | /open/submitTask | taskId, Idempotency-Key / idempotencyKey, asset ID |
| מעקב | /open/taskDetail or /open/taskList | status, cost, failCode, failReason, refundStatus |
| מסירה | callbackUrl and resultUrl | עותק מאושר ורישום ביקורת |
אימות והעלאה
שלחו אל /open/submitTask את width, height, duration והקואורדינטות x1, y1, x2, y2. מצב Standard (mode=normal, ברירת המחדל) מעבד את השטח שבתוך המלבן. מצב Protect (mode=protect) משאיר את השטח שבתוכו ומעבד את השטח שמחוצה לו; הוא אינו מצב באיכות גבוהה יותר. השתמשו ב־removeAudio רק אם צריך להסיר את השמע לפני העיבוד.
שליחת משימה ללא כפילות
שלחו Idempotency-Key באורך עד 128 תווים. אם החיבור נקטע לאחר השליחה, חזרו על אותה משימה לוגית עם אותו מפתח כדי להימנע ממשימה שנייה בתשלום. שמרו את taskId לצד מזהה הנכס אצלכם.
קבלה ובדיקת התוצאה
למסירה אסינכרונית הגדירו callbackUrl ציבורי ב־HTTP(S). עם קבלת הודעה על מצב סופי, אשרו קבלה במהירות ובדקו את המשימה שוב דרך /open/taskDetail. טפלו בבטחה בהודעות חוזרות והשאירו בדיקה יזומה כנתיב גיבוי.
מפתחות בשרת, מניעת כפילויות, taskId שמור ואימות הודעות מאפשרים חזרה בטוחה על בקשות.
מגבלות קלט ובקרת איכות
אלה מגבלות נפרדות מזרימת הווידאו בדפדפן. בדקו פורמט, משך, ממדים, עומק צבע ו־HDR לפני השליחה.
בדקו לפני שימוש בנקודות זכות
האיכות תלויה בתנועה מאחורי הטקסט. קיר חלק או שמיים בדרך כלל קלים יותר משיער, ידיים, דוגמאות, השתקפויות או תנועת מצלמה מהירה. הכינו תור לבדיקת מקרים מורכבים וצפו בכל הסרטון, ולא בתמונה ממוזערת בלבד.
העבירו סצנות קשות לבדיקה
משימות תמונה תומכות בפורמטים נפוצים; את מחיר המשימה המוצלחת יש לבדוק בדף ה־API העדכני. שמרו את המקור ואת התוצאה כעותק נפרד. הסרת סימן מים אינה מקנה זכויות יוצרים או הרשאת שימוש מסחרי.
דחו קבצים שאינם נתמכים מראש וחייבו בדיקה אנושית כאשר האזור המעובד חוצה פרטים חשובים בתנועה.
חיוב, כשלים ומדיניות ניסיונות חוזרים
מחיקת כתוביות מווידאו מחויבת לפי משך ורזולוציה. התעריף הנוכחי הוא 1.3 נקודות זכות לשנייה עד 720p ו־1.6 מעל 720p ועד 1080p. סרטון של 30 שניות יעלה לכן בערך 39 או 48 נקודות. בדקו יתרה דרך /open/queryCredits לפני אצווה גדולה.
העריכו עלות לפני השליחה
תשובות כוללות code ו־message; משימות כוללות status ולאחר השלמה גם resultUrl. כשל עשוי לכלול failCode, failReason ו־refundStatus. נסו שוב לאחר תקלה זמנית בתקשורת עם השהיה הולכת וגדלה, אך תקנו תחילה פרמטרים שגויים, קובץ לא נתמך או מחסור בנקודות.
טפלו בשדות כשל יציבים
מדדו זמן שליחה והשלמה, שיעור כשלים ודחיות בבדיקה, ועלות לכל נכס שאושר. כך ניתן לראות אם האוטומציה באמת מקלה על עבודת העריכה.
מדדו תוצרים מאושרים ועלות בפועל, ולא רק תגובות HTTP מוצלחות.
הפעלת השילוב בארבעה שלבים
צרו מפתח API בדף המפתחים ושלחו סרטון מייצג אחד. לאחר מכן הציגו במוצר את המצבים waiting, processing, success ו־failed. הוסיפו מניעת כפילויות, Webhook ובדיקה יזומה כגיבוי. לבסוף עבדו על אצווה קטנה ובדקו כל ייצוא לפני הגדלת העומס.
התחילו בניסוי מצומצם
הפרידו בין הגדרות פיתוח לייצור, החליפו מפתחות שנחשפו, הגבילו גישה לחומרי המקור והגדירו מדיניות מחיקה לתוצאות. שלבו את ה־API בספריית מדיה, CMS או תור לוקליזציה תוך שמירה על אישור עריכתי.
שאלות נפוצות
אילו משימות וידאו אפשר לשלוח דרך ה־API?
ה־API מקבל משימות מורשות לטיפול בכתוביות/טקסט או בסימן מים גלוי בקובץ MP4/MOV מתאים שהועלה או ב־videoUrl ציבורי ונגיש, עם קואורדינטות לאזור. זה אינו כלי להורדת סרטונים מפוסטים ברשתות חברתיות. בדקו את תנאי הקלט בתיעוד ה־API העדכני.
כדאי לבצע בדיקה יזומה או להשתמש ב־Webhook?
השתמשו ב־Webhook להשלמה רגילה ושמרו בדיקת פרטי משימה כגיבוי. שני המסלולים צריכים להתמודד עם מסירה חוזרת.
כיצד מונעים חיוב כפול לאחר פקיעת זמן?
שלחו Idempotency-Key קבוע בעת יצירת המשימה והשתמשו באותו ערך בעת חזרה על אותה משימה לוגית.
כיצד מחויבות משימות וידאו?
דף ה־API הנוכחי מציג 1.3 נקודות זכות לשנייה עד 720p ו־1.6 מעל 720p ועד 1080p. בדקו את התנאים העדכניים לפני קיבוע הערכות.
אפשר לחשוף את מפתח ה־API בקוד צד לקוח?
לא. שמרו userNo ו־apiKey בשרת והעבירו בקשות מורשות דרך השרת שלכם.