מדריך

תהליך התמלול

בנו תהליך אמין להעלאה, יצירת עבודה, מעקב והורדת התוצר

העלאה ← תמלול ← מעקב ← הורדה

התייחסו לכל פעולה כשלב עצמאי ושמרו אצלכם את upload_id ואת job_id, כדי שניסיונות חוזרים ובדיקות תמיכה יהיו צפויים.

1
העלאה
שמרו מקום להעלאה והעבירו את הקובץ לפני פקיעת התוקף. גודל קובץ שאינו תואם יידחה.
2
תמלול
צרו עבודה אחת לכל העלאה. אם התגובה אינה ודאית, השתמשו שוב באותו Idempotency-Key.
3
מעקב
בצעו Polling בהשהיה הולכת וגדלה. שלחו את ה־ETag האחרון ב־If-None-Match כדי לקבל 304 כשאין שינוי.
4
הורדה
הורידו תוצר רק לאחר שהעבודה הושלמה ובחרו SRT או טקסט רגיל לפי הצורך.

עבודות Live מחזירות בדרך כלל 202 Accepted; עבודות Test עשויות להחזיר 200 באופן מיידי.
פעולות העלאה ויצירת תמלול מוגבלות ל־15 בקשות בדקה בפרימיום ול־60 בפלטיניום
קריאות, Polling ובקשות תוצר מוגבלות ל־60 בקשות בדקה בפרימיום ול־240 בפלטיניום
בדיקות Webhook מוגבלות ל־5 בקשות בדקה בפרימיום ול־20 בפלטיניום
כל המפתחות בחשבון חולקים את המכסות, וכל קבוצת פעולות נספרת בנפרד
X-RateLimit-Reset הוא חותמת Unix בשניות UTC, ובתגובה 429 יש לכבד גם את Retry-After בשניות שלמות
שמרו את X-Request-ID במקרה של כשל, כדי שתמיכת אלף בוט תוכל לאתר את הבקשה.