如何使用 Gemini 2.5 Pro TTS
-
定义说话人:在 speakers 列表中为每个声音添加一个条目。为每个条目设置 "Speaker N" 格式的 speaker_id,选择 voice_name,并设置 accent、style 和 pace。还可以选择添加描述角色的 audio_profile。
-
编写对话:在 dialogue_turns 中填入有序台词。每个轮次的 speaker_id 必须与已定义的说话人匹配。可以在文本中嵌入 [whispers]、[shouting] 或 [determination] 等语气标签。
-
设置氛围(可选):使用 scene 描述声学环境,使用 sample_context 设置整体旁白语气。调整 temperature(0-2)以获得更多或更少变化的表达。
-
提交并轮询:提交请求,然后轮询 /predictions/{request_id}/result,直到状态为 completed,以获取音频 URL。
curl -X POST https://api.muapi.ai/api/v1/gemini-2-5-pro-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}'