# CastReader Voice API

> 面向开发者的文字转语音服务。使用已授权的专属声音，通过 REST API 生成音频。

## 产品事实

- 官网：https://voice.castreader.cn
- 产品归属：CastReader，https://castreader.com
- 开通方式：自主开通，当前为开发者预览版。
- 当前合成语言：zh, en；页面语言不代表新增了合成语言。
- 模型标识：clone-v1。输出为完整 MP3 或 WAV 文件。
- 声音添加：自己录制、邀请朋友录制、上传已有音频。均需声音本人明确授权。
- 即时请求：POST /v1/audio/speech，最多 120 个规范化字符。
- 排队任务：POST /v1/jobs，最多 1800 个字符，任务期限 86400 秒。工作区最多 1 个生成并发。
- 时间戳仅支持英文，采用 qwen-pcm-measured-groups-v3 单词或实测词组对齐。中文、日文及其他语言不进行时间戳对齐。非英文请求传 return_timestamps=true 会在生成、扣费前返回 422 unsupported_timestamps。
- 计费：每百万计费字符 12 美元（USD）。按 NFC 规范化后的 Unicode 码点计数，包含内部空格和标点，不按 UTF-8 字节或 token 计费。
- 试用：开通后 3000 个字符，30 天有效，受每日额度限制；试用额度优先抵扣。
- 没有 API 月度订阅。API 钱包、声音和用量独立于 CastReader 阅读订阅。
- 成功音频保留 24 小时；下载保留结果不再次生成或扣费。
- 相同内容使用相同幂等键重试，复用原任务。排队不收费。
- 当前不提供实时会话、流式输出、长篇生成或延迟 SLA。
- 区域：本页面供中国区部署使用。区域服务不可用时不得向美国转发任务。 页面语言不迁移账户、声音、密钥或余额。

## 官方资料

- [文字转语音 API · 私有声音克隆](https://voice.castreader.cn/)：用 CastReader Voice API 为应用加入专属声音。创建 API 密钥、录制或上传授权声音，排队生成 MP3/WAV，查看字符用量与扣费。
- [API 价格与计费](https://voice.castreader.cn/pricing)：了解 CastReader 语音 API 的字符计量、免费试用、预付余额、成功扣费和幂等重试规则。
- [开发文档与快速入门](https://voice.castreader.cn/docs)：从创建密钥、添加声音到生成第一段音频。查看 REST API、排队任务、v3 时间戳、错误处理及计费说明。
- [API 能力与限制](https://voice.castreader.cn/docs/overview/capabilities)：查看当前模型、语言、格式、字符上限、排队能力和声音授权规则，以实际部署为准。
- [v3 语音时间戳](https://voice.castreader.cn/docs/timestamps)：生成语音并获取 v3 对齐时间戳。了解 words、start_time、end_time、词组粒度、结果保留和计费规则。
- [数据处理与声音授权](https://voice.castreader.cn/data)：了解私有声音的授权、数据处理区域、录音与结果保留、声音删除及区域隔离。
- [申请 Voice API](https://voice.castreader.cn/request-access)：介绍你的应用场景与预计用量，申请开通 CastReader Voice API。
- [OpenAPI 3.1](https://voice.castreader.cn/openapi.json)：机器可读的接口参数、响应字段与错误码。