واجهة الصوت المباشر API
واجهة API لتفريغ البودكاست حلقات كاملة مع توقيت الكلمات
روابط صوت عامة وملفات MP3 للبودكاست، حتى ساعتين لكل حلقة، عبر التفريغ بالذكاء الاصطناعي.
1.0الإمكانات
المزايا الأساسية والحدود المرتبطة بها
فرّغ حلقات البودكاست من روابط الصوت المباشرة، بما فيها عناوين RSS enclosure، مع مقاطع موقوتة وتوقيت الكلمات.
الحدود التشغيلية والشفافية
- أقصى حجم لملف الصوت هو 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 في طلب المهمة لتلقي إشعار تلقائي فور انتهاء التفريغ.
