API 参考总览

本分区收录对外接口的逐字段契约：请求字段、响应结构与真实示例。所有接口经请求头 Authorization: Bearer <API_KEY> 鉴权，用 model 指定模型名称。

模型

查询模型列表

GET /v1/models — 列出当前租户可用模型，只做 list。

上传文件

POST /v1/files — 上传文件，返回 file_id 供大文件场景复用。

查询文件列表

GET /v1/files — 查询已上传文件列表。

查询文件详情

GET /v1/files/{file_id} — 按 file_id 查询单个文件元数据。

删除文件

DELETE /v1/files/{file_id} — 按 file_id 删除文件。

POST /v1/responses — 使用 MOSS-VL 理解 1～5 张图片或 1 个视频，并返回文本结果。

单人语音生成

POST /v1/audio/speech — 文本转语音，voice 只接受 voice id。

流式语音生成

POST /v1/audio/speech — TTS 1.5 Flash 低延迟流式生成，支持 SSE 与原始 PCM。

多人语音生成

POST /v1/audio/speech/speakers — 多说话人 TTS，用 speakers 绑定说话人与音色。

音频转写

POST /v1/audio/transcriptions — 语音识别，支持 file / file_id / url / audio_url 输入。

查询音色列表

GET /v1/audio/voices — 查询当前可用音色列表。

创建音色

POST /v1/audio/voices — 上传音频样本创建可复用音色，返回 voice_id。

音色生成

POST /v1/audio/voice/generations — 据文本与 instruction 生成音色/语音预览。

查询任务

GET /v1/audio/tasks/{task_id} — 查询通用音频异步任务，成功结果展开在顶层。