Text-to-Speech

تبدیل متن به صوت باکیفیت. سازگار با OpenAI Audio Speech API.

اندپوینت

POSThttps://api.darvareh.ir/v1/audio/speech

پارامترها

پارامتر	نوع	اجباری	توضیح
model	string	بله	مثل tts-1 یا tts-1-hd.
input	string	بله	متنی که به گفتار تبدیل می‌شود (تا ۴۰۹۶ کاراکتر).
voice	string	بله	alloy, echo, fable, onyx, nova, shimmer و مشابه.
response_format	string	—	mp3, opus, aac, flac, wav, pcm. پیش‌فرض mp3.
speed	number	—	‏۰٫۲۵ تا ۴٫۰ . پیش‌فرض ۱٫۰.

نمونۀ درخواست

پاسخ به‌صورت باینری فایل صوتی است.

curl -X POST https://api.darvareh.ir/v1/audio/speech \
  -H "Authorization: Bearer YOUR_DARVAREH_API_KEY" \
  -H "Content-Type: application/json" \
  -o speech.mp3 \
  -d '{
    "model": "tts-1",
    "input": "سلام! این یک نمونه از سرویس تبدیل متن به گفتار درواره است.",
    "voice": "alloy",
    "format": "mp3"
  }'

نمونۀ Python

from openai import OpenAI

client = OpenAI(api_key="…", base_url="https://api.darvareh.ir/v1")

with client.audio.speech.with_streaming_response.create(
    model="tts-1",
    voice="alloy",
    input="سلام درواره!",
) as resp:
    resp.stream_to_file("speech.mp3")