www_site/docs/TTS_UPSTREAM_REQUEST.md

30 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 地址。