الانتقال إلى المحتوى الرئيسي
يحوّل تحويل النص إلى كلام النصَّ المكتوب إلى صوت منطوق. اختر نموذج 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 في الوقت نفسه.

بنية الطلب

المعامِلالنوعمطلوبالوصف
modelstringنعممعرّف نموذج تحويل النص إلى كلام.
voicestringنعممعرّف الصوت المدعوم من النموذج المُختار.
inputstringنعمالنص المراد تحويله إلى كلام.

نصائح الإنتاج

  • خزّن الصوت المُولَّد مؤقتًا عند إعادة استخدام النص المصدر والصوت.
  • طبِّع النص وراجعه قبل التوليد. تؤثر علامات الترقيم في الإيقاع والتنغيم.
  • خزّن المخرجات بامتداد الملف الصحيح المطابق لصيغة استجابة النموذج.

موارد ذات صلة