نجواکده › API تبدیل متن به گفتار
API تبدیل متن به گفتار
با یک درخواست HTTP متن فارسی یا انگلیسی را به فایل صوتی تبدیل کنید و در برنامه، وبسایت یا ربات خود به کار ببرید.
شروع سریع
- با شماره موبایل ثبتنام کنید.
- در بخش «API» روی «ساخت کلید» بزنید و کلید را ذخیره کنید (فقط یک بار نمایش داده میشود).
- کلید را در هدر
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 | زیر و بمی، از −۸ تا ۸ نیمپرده (پیشفرض ۰) |
format | mp3، 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 | سرور شلوغ است؛ چند ثانیه بعد دوباره تلاش کنید |
محدودیتها و پلن ویژه
کلید رایگان همان محدودیتهای حساب رایگان را دارد: ماهانه ۱۰٬۰۰۰ کاراکتر، هر درخواست تا ۳۰۰ کاراکتر و یک صدای جدید در هر دقیقه. متن تکراری از حافظهی نهان داده میشود و در این محدودیت حساب نمیشود. برای کلید ویژه با اعتبار یکماهه یا یکساله و محدودیتهای بیشتر با ۰۹۱۰۴۰۸۳۶۶۹ تماس بگیرید. صداهای فارسی فقط برای استفادهی غیرتجاریاند.