توثيق واجهة برمجة تطبيقات Podhoc

ادمج توليد البودكاست في تطبيقاتك

تتيح لك واجهة برمجة تطبيقات Podhoc إنشاء بودكاستات مولّدة بالذكاء الاصطناعي برمجيًا من الروابط المتاحة للعامة. ادمج توليد البودكاست في سير عملك وتطبيقاتك ومنصاتك.

مصادر المحتوى: تقبل الواجهة البرمجية الروابط المتاحة للعامة فقط. رفع الملفات والنص الخام غير مدعومين حاليًا. إذا كانت مؤسستك لديها متطلبات امتثال أو أمان تمنع الاستضافة العامة، يرجى إنشاء تذكرة دعم لمناقشة خيارات التكامل المؤسسي.

البدء السريع

1. احصل على اشتراك PRO في app.podhoc.com
2. أنشئ رمز API في app.podhoc.com/account/api-access
3. أرسل طلبك الأول باستخدام الأمثلة أدناه

المصادقة

تتطلب جميع طلبات API ترويسة X-Api-Key مع رمزك:

X-Api-Key: phk_test_a1b2c3d4e5f6...

عنوان URL الأساسي: https://api-ext.podhoc.com/v1

أنواع الرموز:

• رموز الاختبار (phk_test_...) – أرخص، ميزات محدودة. للتطوير والاختبار.
• رموز الإنتاج (phk_prod_...) – أكثر تكلفة، وصول كامل. للاستخدام الإنتاجي.

نقاط النهاية

POST /v1/podcasts – إنشاء بودكاست

ابدأ بتوليد بودكاست جديد من مصدر واحد أو أكثر.

curl -X POST https://api-ext.podhoc.com/v1/podcasts \
  -H "X-Api-Key: phk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article"],
    "language": "ar",
    "target_duration_minutes": 10,
    "style": "conversational"
  }'

GET /v1/podcasts/{id}/status – استعلام حالة التوليد

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
  -H "X-Api-Key: phk_test_..."

قيم الحالة: requested، processing، completed، failed.

GET /v1/podcasts/{id}/download – تحميل البودكاست

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download \
  -H "X-Api-Key: phk_test_..."

GET /v1/estimate-cost – تقدير التكلفة بالأرصدة

curl "https://api-ext.podhoc.com/v1/estimate-cost?duration_minutes=30&source_count=2&voice_count=2" \
  -H "X-Api-Key: phk_test_..."

GET /v1/account/credits – التحقق من رصيد الأرصدة

curl https://api-ext.podhoc.com/v1/account/credits \
  -H "X-Api-Key: phk_test_..."

الأسعار

يستخدم توليد البودكاست تسعيرًا ديناميكيًا بالأرصدة. تطبّق الواجهة مضاعفًا إضافيًا حسب نوع الرمز.

الصيغة:

التكلفة الأساسية:   max(30, ceil(مدة_الدقائق x 2.5))
المكافآت:           + 20 إذا أكثر من مصدر واحد
                    + 10 إذا تم تفعيل الأوزان المخصصة
تدرج الأصوات:      x 1.2 إذا أكثر من صوت واحد
الحد الأقصى:       min(500, الحد_الأقصى_للطبقة)
تكلفة API:         الأرصدة_الأساسية x مضاعف_الأرصدة

أمثلة التكلفة حسب المدة (مصدر واحد، صوت واحد، بدون أوزان مخصصة):

مضاعفات الأرصدة:

مضاعفات الأرصدة (أرخص للاختبار، أكثر تكلفة للإنتاج) هي المستويات الافتراضية. يمكن تعديلها – المضاعف الفعلي المطبق على طلبك يظهر في البيانات الوصفية للاستجابة.

حدود المعدل

رموز الخطأ

رموز الاختبار مقابل الإنتاج