نحوه استفاده از Gemini 3.8 Flash TTS
-
گویندگان را تعریف کنید: برای هر صدا یک ورودی به فهرست speakers اضافه کنید. برای هرکدام speaker_id را با قالب "Speaker N" تعیین کنید، یک voice_name انتخاب کنید و accent، style و pace را تنظیم کنید. در صورت تمایل، audio_profile را برای توصیف شخصیت اضافه کنید.
-
دیالوگ را بنویسید: خطها را بهترتیب در dialogue_turns قرار دهید. speaker_id هر نوبت باید با یکی از گویندگانی که تعریف کردهاید مطابقت داشته باشد. میتوانید برچسبهای لحن مانند [whispers]، [shouting] یا [determination] را در متن بگنجانید.
-
حالوهوا را تنظیم کنید (اختیاری): با scene فضای صوتی را توصیف کنید و با sample_context لحن کلی روایت را مشخص کنید. برای بیان متنوعتر یا یکنواختتر، temperature را تنظیم کنید (0-2).
-
ارسال و بررسی وضعیت: درخواست را با POST ارسال کنید، سپس /predictions/{request_id}/result را تا زمانی که وضعیت completed شود بررسی کنید تا URL صوت را دریافت کنید.
curl -X POST https://api.muapi.ai/api/v1/gemini-3-8-flash-tts \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"speakers": [
{"speaker_id": "Speaker 1", "voice_name": "Fenrir", "accent": "British (RP)", "style": "Deadpan", "pace": "Natural"},
{"speaker_id": "Speaker 2", "voice_name": "Puck", "accent": "American (Gen)", "style": "Empathetic", "pace": "Staccato"}
],
"dialogue_turns": [
{"speaker_id": "Speaker 1", "text": "[shouting] Halt, traveler!"},
{"speaker_id": "Speaker 2", "text": "[determination] I carry a message for the elder."}
],
"scene": "A dark, crumbling dungeon.",
"temperature": 1
}'