> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# CosyVoice 3 TTS

`cosyvoice3-tts-0.5b` 提供零样本声音克隆:一段 3–30 秒的参考音频即可复刻音色,合成任意中文文本语音。

| 参数    | 取值                                    |
| ----- | ------------------------------------- |
| 模型 ID | `cosyvoice3-tts-0.5b`                 |
| 输入模式  | `zero-shot-clone`                     |
| 提示词   | 即要合成的文本,≤ 5000 字符                     |
| 参考音频  | 必填;3–30 秒;走 media 槽位 `referenceAudio` |
| 产物    | 音频文件,经 `GET /v1/media/downloadUrl` 签发 |

```js
const project = client.projects.create({
  modelId: 'cosyvoice3-tts-0.5b',
  positivePrompt: '欢迎使用 Reelway,祝你创作愉快。',
  referenceAudio: fs.readFileSync('./voice.wav'),
});
const [audioUrl] = await project.waitForCompletion();
```

参考音频要求清晰、单人、无背景音乐;克隆质量随参考时长在 3–30 秒区间提升。TTS 作为 `audio` 媒体项目提交,走与图像/视频相同的[项目生命周期](https://docs.reelway.ai/api-reference/project-status.md)。