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

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

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

Updated: 2026-07-11

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

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

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

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

- עבודות Live מחזירות בדרך כלל 202 Accepted; עבודות Test עשויות להחזיר 200 באופן מיידי.
- כבדו את X-RateLimit-Remaining ואת X-RateLimit-Reset בתגובות מוצלחות.
- שמרו את 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)