واجهة API للنسخ: نظرة عامة، المصادقة والحدود

تتيح واجهة REST API من VoxScriber إرسال ملفات صوتية عبر رابط واستلام النسخ الجاهز في نظامك دون المرور عبر الموقع. وهي تستخدم نفس المحركات وتحتسب نفس الدورات المستخدمة في النسخ من لوحة التحكم.

من يمكنه الاستخدام

تُتاح واجهة API ابتداءً من خطة Profissional (R$ 39,90/شهريًا). يحق الوصول إلى: Profissional وPremium وجميع الخطط المؤسسية (الشهرية والسنوية) والخطط القديمة المكافئة. إذا لم يكن حسابك مؤهلًا، تُرجع مسارات المفاتيح الخطأ 403 PLAN_NOT_ELIGIBLE.

مفاتيح API

إنشاء المفاتيح الشخصية ليس له بعد شاشة مخصصة في لوحة التحكم. إذا كانت خطتك مؤهلة وتريد البدء في استخدام API، افتح تذكرة وسيقوم الفريق بتفعيل الوصول معك.

المصادقة

كل طلب يحمل المفتاح في الترويسة Authorization:

Authorization: Bearer vpt_live_SUA_CHAVE

الطلب بدون هذه الترويسة يُرجع 401 MISSING_API_KEY.

إرسال ملف صوتي للنسخ

نقطة نهاية النسخ موجودة على البوابة api.voxscriber.com:

curl -X POST https://api.voxscriber.com/v1/transcriptions \
  -H "Authorization: Bearer vpt_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://exemplo.com/gravacoes/reuniao.mp3",
    "webhook_url": "https://seusistema.com/webhooks/vozparatexto",
    "formats": ["txt", "srt"]
  }'

الحقول المقبولة في الجسم: audio_url, webhook_url, engine (ASSEMBLYAI أو WHISPER أو ELEVENLABS), language, formats (txt, json, srt, vtt, docx, pdf), metadata وidempotency_key. تصل النتيجة إلى webhook_url الخاص بك — انظر Webhooks والتنبيهات.

الحدود

قواعد الأمان في الروابط: يُسمح بـ https فقط، دون إعادة توجيه، ويتم حظر العناوين الداخلية/الخاصة. يجب أن يكون رابط الصوت متاحًا للجمهور.

تتبع تنسيقات التصدير المتاحة قيود خطتك، تمامًا كما في الموقع — التنسيقات خارج الخطة تُعاد مدرجة في exports_skipped.

الفوترة

تخصم الواجهة نفس الدورات المستخدمة في النسخ من الموقع، وفقًا للمحرك المختار (Padrão/Whisper: دورة واحدة/دقيقة؛ Premium: 4 دورات/دقيقة؛ Ultra: 10 دورات/دقيقة). لا يوجد حاليًا حصة شهرية للاستدعاءات ولا سقف إنفاق لكل مفتاح — تحكم في الاستهلاك عبر رصيد دوراتك. انظر ما هي الدورات وكم تكلف كل دقيقة.

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

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

• Webhooks والتنبيهات
• الأتمتة باستخدام API
• ما هي الدورات وكم تكلف كل دقيقة
• التصدير إلى أدوات أخرى

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