Gemini 3.1 Flash Tts Preview

این مدل را برای چه کاری انتخاب کنم؟

فارسی و چندزبانه · انتخاب مناسب نریشن. پیش از استفادهٔ گسترده، چند نمونه از ورودی واقعی محصول خودت را در آزمایشگاه مقایسه کن.

تنظیمات همین مدل

در گفت‌وگو، text اختیاری است و اگر حذف شود از مجموع نوبت‌ها ساخته می‌شود؛ turns نوبت‌های واقعی را به ترتیب می‌فرستد. تا دو صدا: حداکثر ۴۰ نوبت و ۱۲٬۰۰۰ نویسه. سه تا هشت صدا: حداکثر ۱۲ نوبت و ۴٬۰۰۰ نویسه؛ ساروی نوبت‌ها را جداگانه می‌سازد و یک فایل WAV تحویل می‌دهد. هزینه مجموع نوبت‌ها یک‌بار محاسبه می‌شود. در صورت شکست، خروجی ناقص تحویل نمی‌شود و اعتبار رزروشده آزاد می‌شود.

{
  "model": "google/gemini-3.1-flash-tts-preview",
  "text": "سلام! خوش آمدی.",
  "instructions": "Warm and friendly Persian",
  "voice": "Kore",
  "format": "wav",
  "turns": [
    {
      "text": "سلام!",
      "voice": "Kore"
    },
    {
      "text": "خوش آمدی.",
      "voice": "Puck",
      "instructions": "cheerful"
    },
    {
      "text": "من هم آماده‌ام.",
      "voice": "Charon"
    }
  ]
}

درخواست آماده

شناسهٔ دقیق مدل را کپی کن و کلید ساروی را در متغیر محیطی سرورت قرار بده.

google/gemini-3.1-flash-tts-preview

import json, os, urllib.request, urllib.error

payload = {
    "model": "google/gemini-3.1-flash-tts-preview",
    "text": "به ساروی خوش آمدید.",
    "voice": "Kore",
    "format": "wav",
    "instructions": "Warm and friendly Persian"
}

request = urllib.request.Request(
    "https://api.sarovi.ir/v1/studio/audio",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["SAROVI_API_KEY"],
        "Content-Type": "application/json"
    },
    method="POST"
)
try:
    with urllib.request.urlopen(request, timeout=300) as response:
        result = json.load(response)
        print(result)
except urllib.error.HTTPError as error:
    detail = json.load(error)
    raise RuntimeError(f"{error.code}: {detail['error'].get('code', detail['error'].get('type', 'HTTP_ERROR'))}") from error

امکان‌ها در API ساروی

فراخوانی ابزار و JSON Schema برای مدل‌های پشتیبان از مسیر chat/completions و قرارداد پیشرفتهٔ responses در دسترس‌اند. قابلیت‌های ارائه‌دهنده و محدودیت‌های هر مسیر را پیش از اجرا بررسی کنید.