كيفية توليد بودكاست باستخدام واجهة Podhoc البرمجية: دليل شامل
ولّد بودكاست بالذكاء الاصطناعي برمجيًا عبر واجهة Podhoc البرمجية REST. المصادقة، دورة الإنشاء-الاستعلام-التنزيل، حدود المعدل، تقدير الأرصدة.
يتطلب إنشاء أو تدوير رموز الاختبار والإنتاج اشتراك Pro نشطًا أو تجريبيًا. يستهلك الاختبار رصيدًا حقيقيًا وليس بيئة مجانية. احفظ المفاتيح على الخادم وخارج المتصفح والروابط والسجلات والمستودعات.
يجب أن تكون المصادر روابط عامة مدعومة. لا تقبل API رفع ملفات أو نصًا ملصقًا. لا تنشر مستندات سرية لاستخدامها.
أول طلب آمن
يستخدم المثال مصدرًا عامًا خياليًا ويستهلك رصيدًا. اقرأ الرصيد والتقدير ثم وافق على الميزانية. خمس دقائق بصوت واحد تكلف 72 رصيدًا بمعامل الاختبار الافتراضي؛ اتبع التقدير المعاد إن اختلف الإعداد.
احفظ Idempotency-Key جديدًا لكل إنشاء مقصود قبل الإرسال. كرر الطلب غير المؤكد بالمفتاح والمحتوى نفسيهما ليعود الإيصال الأصلي. تغيير المحتوى يعطي 409. انتهاء المهلة ليس سببًا لتغيير المفتاح.
الحدود والأسعار
الاختبار: طلبان/دقيقة و20/ساعة وإنشاء متزامن واحد وحتى 5 دقائق ورابط واحد والإنجليزية. الإنتاج: 30/دقيقة و300/ساعة و5 متزامنة ضمن Pro. احترم Retry-After عند 429.
الأساس: max(36, ceil(الدقائق × 10 / 3)). تعدد المصادر يضيف 27 رصيدًا؛ الأوزان 13؛ تعدد الأصوات القياسية يضرب المجموع في 1.2 مع التقريب والسقف. بعدها معامل API: افتراضيًا 2× للاختبار و3.5× للإنتاج، وقد يُضبط. إنتاج 30 دقيقة بمصدر وصوت: 100 × 3.5 = 350 رصيدًا. الاختبار لا يسمح بـ30 دقيقة.
استدع estimate-cost بالإعدادات نفسها وافحص final_credits وcredit_multiplier والرصيد المتبقي. المدة تقريبية؛ السعر بحسب الإعداد المطلوب لا زمن الصوت النهائي.
الحالة والتنزيل والفشل
للاختبار استعلم بفاصل 240 ثانية على الأقل وحتى 12 مرة مع ترك سعة للطلبات الأخرى. للإنتاج استخدم انتظارًا محدودًا واحترم الترويسات. إن بقي معلقًا احفظ المعرّف وعد لاحقًا دون إنشاء نسخة. لا نعد هنا بـwebhook للإكمال.
نزّل بعد completed فقط. افحص سبب الفشل والرصيد والاسترداد قبل محاولة جديدة. رابط التنزيل مؤقت وخاص؛ لا تنشره كعنوان دائم.
الخصوصية والنشر والحذف
النتيجة عامة افتراضيًا. يتيح Creator وPro الإنشاء الخاص؛ يمكن نشر حلقة خاصة لاحقًا بعد تأكيد الحقوق. تحترم API الإنتاجية اختيار المالك المشترك؛ لا يمكن لرموز الاختبار النشر. للإنشاء الخاص، أرسل auto_publish=false صراحةً باستخدام حساب Pro.