▶محتويات API

وثائق Votxt OpenAPI

إصدار تجريبي واجهة Votxt OpenAPI في مرحلة تجريبية. اختبر التكامل في بيئة تطوير قبل الاستخدام الإنتاجي.

نظرة عامة

تتيح لك Votxt OpenAPI إضافة تفريغ الصوت والفيديو إلى تطبيقاتك وسير العمل الآلي.

ارفع ملفاً أو استخدم رابط ملف خارجي، ثم أنشئ مهمة تفريغ وتابع حالتها.

بعد اكتمال المهمة يمكنك تصدير النصوص والترجمات والبيانات المنظمة بعدة صيغ.

عنوان URL الأساسي

https://api.votxt.co

المصادقة

أرسل مفتاح API في ترويسة الطلب. يتطلب الوصول خطة نشطة تدعم API.

X-API-Key: your_api_key_here

افتح الإعدادات في حسابك.
تأكد من أن خطتك تدعم الوصول إلى API.
أنشئ مفتاح API واحفظه في مكان آمن.

رفع الملفات

ادعم الرفع المباشر عبر رابط موقّع أو استخدم رابط ملف خارجي قابل للتنزيل.

POST /api/v1/files/upload-url
PUT upload_url
POST /api/v1/transcriptions

POST /api/v1/files/upload-url
Content-Type: application/json
X-API-Key: your_api_key

{
  "filename": "audio.mp3",
  "file_size": 1048576,
  "upload_expires_in": 3600,
  "download_expires_in": 1800
}

التفريغ

المسار	الطريقة	الوصف
/api/v1/transcriptions	POST	رفع الملفات
/api/v1/transcriptions/youtube	POST	YouTube
/api/v1/transcriptions	GET	النصوص
/api/v1/transcriptions/{id}	GET	النص
/api/v1/transcriptions/{id}/status	GET	الحالة

POST /api/v1/transcriptions
Content-Type: application/json
X-API-Key: your_api_key

{
  "file_key": "12345-abc123def456.mp3",
  "filename": "audio.mp3",
  "language_code": "en",
  "transcription_type": "transcript",
  "enable_speaker_diarization": false,
  "webhook_url": "https://your-app.com/webhook"
}

الحالة

الحالة	التفريغ
queued	في قائمة الانتظار
preprocessing	المعالجة المسبقة
processing	قيد المعالجة
completed	مكتمل
failed	فشل

التصدير