انتقل إلى المحتوى
Transcript Dock
تسجيل الدخولابدأ مجانًا

قائمة الموقع

Transcript Dock
واجهة الصوت المباشر API

واجهة API لتفريغ البودكاست حلقات كاملة مع توقيت الكلمات

روابط صوت عامة وملفات MP3 للبودكاست، حتى ساعتين لكل حلقة، عبر التفريغ بالذكاء الاصطناعي.

1.0الإمكانات

المزايا الأساسية والحدود المرتبطة بها

فرّغ حلقات البودكاست من روابط الصوت المباشرة، بما فيها عناوين RSS enclosure، مع مقاطع موقوتة وتوقيت الكلمات.

  1. حلقات حتى ساعتين

    تقبل صوتًا طويلًا حتى ساعتين و250 MB لكل ملف، ويُفرَّغ كمهمة واحدة مع توقيت المقاطع والكلمات.

  2. جلب محمي من SSRF

    تُتحقق روابط الصوت المباشرة عبر فحوص صارمة لعناوين IP وإعادة التوجيه قبل بدء التنزيل.

  3. إشعارات Webhook

    احصل على Webhook موقّع بـ HMAC SHA256 عند انتهاء تفريغ حلقة طويلة، بدلًا من الاستعلام المستمر عنه.

الحدود التشغيلية والشفافية

  • أقصى حجم لملف الصوت هو 250 MB (262,144,000 بايت).
  • أقصى مدة للحلقة هي 7,200 ثانية (ساعتان).
  • بنية تحتية في منطقة واحدة؛ يُحتسب التفريغ بالذكاء الاصطناعي بـ 2 رصيد عن كل دقيقة تُبدأ، بحد أدنى 60 ثانية.
2.0التنفيذ

الطلب والاستجابة الطلب الدقيق وما يعود منه

POST/v1/jobs

curl -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer td_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"source": {
"url": "https://media.example.com/podcasts/episode-104.mp3"
},
"mode": "transcribe"
}'

نتيجة المهمة

{
"id": "8e9f0a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b",
"status": "succeeded",
"stage": null,
"result_id": "1f2a3b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
"error": null,
"billing": {
"credits_reserved": 0,
"credits_charged": 80,
"kind": "ai_transcription"
},
"source": {
"platform": "direct",
"media_id": null,
"canonical_url": "https://media.example.com/podcasts/episode-104.mp3",
"title": null,
"upload_id": null
},
"options": {
"mode": "transcribe",
"language": null,
"caption_preference": "prefer_creator"
},
"created_at": "2026-09-12T17:20:00Z"
}
3.0أسئلة

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

ما الذي يحدث مع الترجمات والتفريغ بالذكاء الاصطناعي والحدود لهذا المصدر.

هل يمكنني إرسال عناوين RSS enclosure؟

نعم. تُقبل روابط HTTPS المباشرة لملفات MP3 أو M4A أو WAV المستضافة على شبكات توصيل محتوى البودكاست.

كيف تعمل Webhooks مع حلقات البودكاست الطويلة؟

يمكنك تمرير webhook_endpoint_id في طلب المهمة لتلقي إشعار تلقائي فور انتهاء التفريغ.