API 参考总览
本分区收录对外接口的逐字段契约：请求字段、响应结构与真实示例。所有接口经请求头 Authorization: Bearer <API_KEY> 鉴权，用 model 指定模型名称。
模型
文件
上传文件
POST /v1/files — 上传文件，返回 file_id 供大文件场景复用。
查询文件列表
GET /v1/files — 查询已上传文件列表。
查询文件详情
GET /v1/files/{file_id} — 按 file_id 查询单个文件元数据。
删除文件
DELETE /v1/files/{file_id} — 按 file_id 删除文件。
语音生成
单人语音生成
POST /v1/audio/speech — 文本转语音，voice 只接受 voice id。
多人语音生成
POST /v1/audio/speech/speakers — 多说话人 TTS，用 speakers 绑定说话人与音色。
语音识别
音色管理
查询音色列表
GET /v1/audio/voices — 查询当前可用音色列表。
创建音色
POST /v1/audio/voices — 上传音频样本创建可复用音色，返回 voice_id。
音色生成
POST /v1/audio/voice/generations — 据文本与 instruction 生成音色/语音预览。