วิธีใช้ 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 ซ้ำจนกว่า status จะเป็น 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
}'