يحوّل تحويل النص إلى كلام النصَّ المكتوب إلى صوت منطوق. اختر نموذج TTS، وحدّد صوتًا يدعمه هذا النموذج، وأرسل النص إلى /audio/speech، ثم احفظ استجابة الصوت الثنائية.
استخدم هذا الدليل لتوليد الأصوات القياسية. إذا كنت تريد إنشاء كلام من صوت مرجعي مخصص، فراجع استنساخ الصوت.
الاستخدام الأساسي
import os
from pathlib import Path
import requests
response = requests.post(
"https://api.venice.ai/api/v1/audio/speech",
headers={
"Authorization": f"Bearer {os.environ['VENICE_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "tts-kokoro",
"voice": "af_sky",
"input": "Hello, welcome to Venice Voice.",
},
)
response.raise_for_status()
Path("speech.mp3").write_bytes(response.content)
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.venice.ai/api/v1/audio/speech", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VENICE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tts-kokoro",
voice: "af_sky",
input: "Hello, welcome to Venice Voice.",
}),
});
if (!response.ok) {
throw new Error(await response.text());
}
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));
curl https://api.venice.ai/api/v1/audio/speech \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-kokoro",
"voice": "af_sky",
"input": "Hello, welcome to Venice Voice."
}' \
--output speech.mp3
اختيار النموذج والصوت
الأصوات خاصة بكل نموذج. يجب أن تكون قيمة voice صالحة لـ model الذي تختاره.
استخدم صفحة نماذج تحويل النص إلى كلام لتصفّح النماذج والأصوات المتاحة. يعرض منتقي الأصوات معرّفات الأصوات الدقيقة التي تُمرّرها في طلبك.
معرّفات الأصوات حسّاسة لحالة الأحرف. إذا بدّلت نموذج TTS، فحدِّث قيمة voice في الوقت نفسه.
بنية الطلب
| المعامِل | النوع | مطلوب | الوصف |
|---|
model | string | نعم | معرّف نموذج تحويل النص إلى كلام. |
voice | string | نعم | معرّف الصوت المدعوم من النموذج المُختار. |
input | string | نعم | النص المراد تحويله إلى كلام. |
نصائح الإنتاج
- خزّن الصوت المُولَّد مؤقتًا عند إعادة استخدام النص المصدر والصوت.
- طبِّع النص وراجعه قبل التوليد. تؤثر علامات الترقيم في الإيقاع والتنغيم.
- خزّن المخرجات بامتداد الملف الصحيح المطابق لصيغة استجابة النموذج.
موارد ذات صلة