# תהליך התמלול

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

Canonical: https://alef-bot.top/developers/guides/transcription-workflow

Updated: 2026-08-14

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

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

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

## התנהגות בסביבת ייצור

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

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)