ورود / ثبت‌نام
نجواکده › API تبدیل متن به گفتار

API تبدیل متن به گفتار

با یک درخواست HTTP متن فارسی یا انگلیسی را به فایل صوتی تبدیل کنید و در برنامه، وب‌سایت یا ربات خود به کار ببرید.

شروع سریع

  1. با شماره موبایل ثبت‌نام کنید.
  2. در بخش «API» روی «ساخت کلید» بزنید و کلید را ذخیره کنید (فقط یک بار نمایش داده می‌شود).
  3. کلید را در هدر X-API-Key بفرستید.
curl -X POST https://houshdan.ir/tts \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"text":"سلام، به نجواکده خوش آمدید","voice":"fa-1","format":"mp3"}' \
  -o speech.mp3
import requests

r = requests.post("https://houshdan.ir/tts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"text": "Hello from Najvakadeh", "voice": "kokoro-af_heart", "format": "mp3"})
r.raise_for_status()
open("speech.mp3", "wb").write(r.content)
const r = await fetch("https://houshdan.ir/tts", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ text: "Hello from Najvakadeh", voice: "kokoro-af_heart", format: "mp3" }),
});
const audio = await r.blob();   // audio/mpeg

پارامترها

پارامترتوضیح
textمتن (در پلن رایگان تا ۳۰۰ کاراکتر)
voiceشناسه‌ی صدا؛ فهرست در جدول پایین یا GET /voices
speedسرعت، از ۰٫۵ تا ۲ (پیش‌فرض ۱)
pitchزیر و بمی، از ‎−۸ تا ۸ نیم‌پرده (پیش‌فرض ۰)
formatmp3، ogg یا wav

صداها

نامشناسه در APIجنسیت و لهجه
ساراfa-1زن · فارسی
آرمانfa-2مرد · فارسی
مهساfa-3فارسی، ملایم
هارتkokoro-af_heartزن · انگلیسی آمریکایی
بلاkokoro-af_bellaزن · انگلیسی آمریکایی
نیکولkokoro-af_nicoleزن · انگلیسی آمریکایی، آرام
مایکلkokoro-am_michaelمرد · انگلیسی آمریکایی
آدامkokoro-am_adamمرد · انگلیسی آمریکایی، عمیق
اماkokoro-bf_emmaزن · انگلیسی بریتانیایی
جورجkokoro-bm_georgeمرد · انگلیسی بریتانیایی

کدهای خطا

کدمعنی
401کلید نادرست، حذف‌شده یا منقضی‌شده
403کلید شما اجازه‌ی استفاده از این صدا را ندارد
413متن از حد مجاز طولانی‌تر است
422متن خالی یا پارامتر نامعتبر
429تعداد درخواست در دقیقه یا سهمیه‌ی ماهانه تمام شده است؛ هدر Retry-After را ببینید
503سرور شلوغ است؛ چند ثانیه بعد دوباره تلاش کنید

محدودیت‌ها و پلن ویژه

کلید رایگان همان محدودیت‌های حساب رایگان را دارد: ماهانه ۱۰٬۰۰۰ کاراکتر، هر درخواست تا ۳۰۰ کاراکتر و یک صدای جدید در هر دقیقه. متن تکراری از حافظه‌ی نهان داده می‌شود و در این محدودیت حساب نمی‌شود. برای کلید ویژه با اعتبار یک‌ماهه یا یک‌ساله و محدودیت‌های بیشتر با ۰۹۱۰۴۰۸۳۶۶۹ تماس بگیرید. صداهای فارسی فقط برای استفاده‌ی غیرتجاری‌اند.

شروع رایگان با شماره موبایل

صداهای فارسی · صداهای انگلیسی