أتمتة النسخ باستخدام API: أمثلة عملية

باستخدام API يمكنك تحويل أي مصدر تسجيلات — هاتفي، مسجل اجتماعات، نظام داخلي — إلى نص قابل للبحث دون تدخل يدوي. تعرض هذه المقالة المسار الموصى به ووصفات جاهزة. قبل ذلك، راجع المتطلبات الأساسية في API النسخ (خطة Profissional+ ومفتاح vpt_live_).

المسار الموصى به

1. أرسل الصوت عبر رابط مع webhook_url.
2. استلم رد الاتصال عند اكتمال العملية (نجاحًا أو فشلًا).
3. نزّل الملفات المُصدَّرة عبر روابط النتيجة — وهي صالحة لمدة 7 أيام.

لا حاجة إلى الاقتراع (polling): مع حد أقصى 60 طلبًا في الدقيقة لكل مفتاح، يهدر استعلام الحالة المتكرر الحصة. يسلّم webhook النتيجة تلقائيًا، مع إعادة تسليم تصل إلى 6 مرات إذا كان خادمك غير متاح.

وصفة 1 — نسخ كل تسجيل جديد

curl -X POST https://api.voxscriber.com/v1/transcriptions \
  -H "Authorization: Bearer $VPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://storage.suaempresa.com/calls/2026-08-02-0931.mp3",
    "webhook_url": "https://api.suaempresa.com/hooks/vpt",
    "formats": ["txt", "docx"],
    "metadata": { "call_id": "0931", "agente": "maria" },
    "idempotency_key": "call-2026-08-02-0931"
  }'

• metadata تعود في webhook — استخدمها لربط النتيجة بالسجل في نظامك.
• تضمن idempotency_key أن عمليات إعادة الإرسال العرضية (إعادة محاولة من طرفك، أو نشر في منتصف المهمة) لا تعالج ولا تحتسب نفس الصوت مرتين.

وصفة 2 — اختيار المحرك حسب التكلفة

يقبل حقل engine القيم ASSEMBLYAI (Premium، الافتراضي)، وWHISPER (القياسي)، وELEVENLABS (Ultra). بالنسبة للأحجام الكبيرة حيث تكون التكلفة أكثر أهمية من الجودة النهائية، استخدم Whisper — دورة واحدة/دقيقة مقابل 4 دورات في Premium:

-d '{ "audio_url": "...", "webhook_url": "...", "engine": "WHISPER" }'

وصفة 3 — الترجمة النصية التلقائية

اطلب formats: ["srt", "vtt"] واستلم الترجمات النصية جاهزة لليوتيوب أو مشغلات الويب في نفس webhook. تفاصيل كل صيغة في تصدير إلى أدوات أخرى.

الحدود التي تؤثر على الأتمتة

الأسئلة الشائعة

مقالات ذات صلة

• API النسخ
• Webhooks والإشعارات
• API Enterprise للتدقيق
• ما هي الدورات وكم تكلف كل دقيقة

لم تحصل على الحل؟ افتح تذكرة — فريقنا يرد بسرعة.