www_site/docs/TTS_UPSTREAM_REQUEST.md

# TTS 上游资料请求清单

状态：Phase 2 核查仍未取得真实上游资料。
日期：2026-09-08

## 已核查范围

- 当前仓库：未发现 TTS 客户端、适配器、接口文档、音色清单、上游地址或凭据引用。
- 测试服务器：当前仅有 PostgreSQL、API、Web、Caddy 和 SSH 监听；未发现 TTS 监听端口或 TTS 服务配置。
- `services/api`：仅实现认证、会话、权益和额度基础；没有 Phase 3 生成路由或上游调用。
- `docs/API_CONTRACT.md`：只有脱敏目标契约，明确标记为待确认，不能替代真实上游协议。

## 需要内部服务负责人提供

请通过安全渠道提供以下信息，不要提交 Git、不要放入前端构建，也不要粘贴到普通日志：

1. 测试环境内部地址、端口、允许访问的来源机器和网络方式。
2. OpenAPI、接口文档或一组脱敏请求/响应示例。
3. 鉴权方式、凭据注入名称、凭据有效期和轮换方式。实际密钥只进入服务器秘密配置。
4. 音色 ID、语言、名称、启用状态和各 Plan 可用范围。
5. 参数范围，例如格式、语速、音调、采样率、声道和最大文本长度。
6. 音频返回方式：同步字节流、短期 URL、结果 URL 或 provider task ID 查询。
7. 同步/异步行为、任务状态、查询接口、取消能力、幂等支持和重试边界。
8. 连接/读取/任务超时、响应大小、计量口径和错误码映射。
9. 最小联调用例、失败用例和允许保存的测试音频/文本保留期。

## 当前阻断

缺少以上资料前，Phase 3 不启动真实生成接入，不创建伪造音色，不使用 Mock 成功替代真实联调，不尝试扫描或猜测内部 TTS 地址。