۱. ضبطها را در سایتت نگه دار
متن نمونه و رضایت فعلی پادلی را از GET /api/v1/voices/recording-guide بگیر. دو ضبط WAV هر کاربر را در فضای خودت ذخیره کن.
نمونهٔ صدا و رضایت صوتی کاربر را در فضای ذخیرهسازی سایت خودت نگه دار. در هر درخواست، لینک مستقیم دو فایل را بفرست؛ پادلی آنها را پردازش میکند و خروجی صوت یا پادکست را تحویل میدهد. ثبت صدای کاربر در پادلی لازم نیست. احراز هویت در سایت تو اختیاری است؛ رضایت صوتی همراه نمونه لازم است.

متن نمونه و رضایت فعلی پادلی را از GET /api/v1/voices/recording-guide بگیر. دو ضبط WAV هر کاربر را در فضای خودت ذخیره کن.
برای فایلهای همان کاربر دو لینک HTTPS در دسترس مدل بساز. فضای خصوصی با لینک امضاشده هم مناسب است؛ اعتبار لینک باید تا پایان تولید ادامه داشته باشد.
لینکها را در personal_voice مسیر /tts یا /podcasts بفرست؛ هزینه را برآورد کن و پس از پایان کار، خروجی را بگیر.
const base = 'https://podly.site/api/v1';
const requestId = process.env.PODLY_REQUEST_ID;
if (!requestId) throw new Error('Set a stable PODLY_REQUEST_ID.');
const sourceUrl = process.env.PODLY_SOURCE_AUDIO_URL;
const consentUrl = process.env.PODLY_CONSENT_AUDIO_URL;
if (!sourceUrl || !consentUrl) throw new Error('Set both recording URLs.');
const response = await fetch(base + '/podcasts', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PODLY_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': requestId
},
body: JSON.stringify({
text: 'سه راهکار برای شروع یک پادکست آموزشی',
duration: 2,
personal_voice: {
source_audio_url: sourceUrl,
consent_audio_url: consentUrl
}
})
});
const job = await response.json();
if (!response.ok) throw new Error(JSON.stringify(job.error));
console.log('شناسهٔ کار برای پیگیری و دانلود:', job.id);
// Poll GET /jobs/{id}; download GET /jobs/{id}/audio when completed.فایل آمادهٔ WAV تککاناله، ۲۴ کیلوهرتز و PCM16 بفرست. نمونه ۱۰ تا ۳۰ ثانیه، رضایت ۳ تا ۳۰ ثانیه و هر فایل حداکثر ۱۰ مگابایت است. پیش از تولید، همان ورودی را با service: 'podcast' به POST /api/v1/estimates بده.
۲۰۰ جفت فایل نمونه و رضایت روی فضای ذخیرهسازی خود سایتت نگه میداری و ارتباط هر جفت با کاربر را در پایگاه دادهٔ خودت ثبت میکنی. در هر تولید، فقط لینکهای همان کاربر را میفرستی. این روش سقف ثبت صدا در پادلی ندارد؛ محدودیت فعلی ۶۰ درخواست در دقیقه برای هر کلید، ۳ کار فعال در حساب و موجودی اعتبار برقرار است.
پادلی فایلهای ورودی را دانلود یا ذخیره نمیکند. برای اجرای غیرهمزمان، لینکها به صورت رمزگذاریشده در اطلاعات کار نگه داشته میشوند؛ خروجی تولیدشده طبق چرخهٔ معمول API ذخیره و تحویل میشود. حذف ضبطها و لغو لینکها را در سایت خودت مدیریت کن.
tts و پادکست تکگوینده یا چندگوینده فعال است؛ هر گوینده میتواند personal_voice خودش را داشته باشد.این متن فرم اختیاری سایت شماست و جای ضبط رضایت رسمی مدل را نمیگیرد. ضبط الزامی و جملهٔ رسمی را در راهنمای رضایت صوتی ببینید.
پیشنهاد اجرایی: کنار این متن، لینک سیاست حریم خصوصی، مدت نگهداری نمونهها، روش لغو رضایت و راه تماس را نمایش بده و ثبت نسخهٔ متن و زمان رضایت را در سمت خودت نگه دار.
در نسخهٔ فعلی API، صدای شخصی برای TTS و پادکست تکگوینده یا چندگوینده فعال است؛ مسیر dialogues صدای شخصی را نمیپذیرد.
خیر. لینک فایلهای هر کاربر را با درخواست تولید بفرست. فایلهای بیرونی در فهرست /voices ثبت نمیشوند و به شناسهٔ صدای ذخیرهشده نیاز ندارند.
کلید API را در مرورگر قرار نده. درخواست را از سرور خودت ارسال کن و فایل آماده را به برنامهٔ کاربر تحویل بده.