معالجة الدُفعات

أتمتة نسخ ملفات متعددة في وقت واحد. تعلم الاستراتيجيات والمراقبة وأفضل الممارسات لتحقيق أقصى كفاءة ونتائج.

فوائد معالجة الدُفعات

كيف يعمل

عبر لوحة التحكم

عبر API

# Upload multiple files
curl -X POST https://api.vozparatexto.com.br/v1/batch/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files[]=@audio1.mp3" \
  -F "files[]=@audio2.mp3" \
  -F "files[]=@audio3.mp3" \
  -F "engine=ASSEMBLYAI" \
  -F "language=en-US"

// Response
{
  "batchId": "batch_abc123",
  "totalFiles": 3,
  "status": "PROCESSING",
  "files": [
    { "id": "upload_1", "name": "audio1.mp3", "status": "QUEUED" },
    { "id": "upload_2", "name": "audio2.mp3", "status": "QUEUED" },
    { "id": "upload_3", "name": "audio3.mp3", "status": "QUEUED" }
  ]
}

الحدود والإعدادات

| المورد | الخطة المجانية | الخطة البسيطة | الخطة المتقدمة | الخطة الاحترافية | |---|---|---|---|---| | الملفات لكل دفعة | 3 | 10 | 25 | 100 | | المعالجة المتوازية | 1 | 2 | 3 | 5 | | الحجم الأقصى للدفعة | 100 MB | 500 MB | 2 GB | 10 GB | | أولوية الطابور | عادي | عادي | عالية | قصوى |

مراقبة الدفعات

حالات الملفات

| الحالة | الوصف | |---|---| | QUEUED | في الطابور بانتظار المعالجة | | UPLOADING | جارٍ التحميل | | PROCESSING | جارٍ النسخ | | COMPLETED | تم النسخ بنجاح | | FAILED | فشلت المعالجة | | RETRYING | إعادة المحاولة تلقائيًا |

لوحة المراقبة

تعرض لوحة الدفعات:

• التقدم الكلي للدفعة (نسبة مئوية)
• حالة كل ملف على حدة
• الوقت المقدر للانتهاء
• الرصيد المستهلك مقابل المقدر
• سجلات الأخطاء لكل ملف

استراتيجيات التحسين

تنظيم الملفات

• تجميع الملفات حسب المشروع أو الموضوع
• استخدام اتفاقيات تسمية متسقة
• الفصل حسب اللغة عند الضرورة
• الترتيب حسب الأولوية

الإعدادات الموصى بها

• استخدم AssemblyAI لتحقيق أفضل فعالية من حيث التكلفة (15 دورة/دقيقة)
• تفعيل تعريف المتحدث فقط عند الحاجة
• اختيار اللغة الصحيحة للحصول على أفضل دقة
• إعداد webhooks لإشعارات الانتهاء

استكشاف الأخطاء وإصلاحها

فشلت بعض الملفات في الدفعة

الأسباب المحتملة: تنسيق غير مدعوم، ملف تالف، رصيد غير كافٍ.

الحلول: تحقق من تنسيقات الملفات الفاشلة، حاول إعادة المعالجة بشكل فردي، تأكد من رصيدك.

المعالجة بطيئة جدًا

الأسباب المحتملة: العديد من الملفات الكبيرة، ساعات الذروة، حد المعالجة المتوازية.

الحلول: قسم إلى دفعات أصغر، أرسل خارج ساعات الذروة، فكر في ترقية خطتك للحصول على فتحات متوازية أكثر.

نتائج غير متناسقة بين الملفات

الأسباب المحتملة: جودة صوت متغيرة، لغات مختلفة، إعدادات غير صحيحة.

الحلول: قم بتطبيع الصوت قبل التحميل، وضبط اللغة لكل ملف عند الحاجة، وراجع إعدادات الدفعة.

مواصلة التعلم

• تكامل API - أتمتة تحميل الدفعات عبر API
• Webhooks والإشعارات - تلقي تنبيهات الانتهاء
• أتمتة سير العمل - إنشاء تدفقات آلية للدفعات