API 概览
Mossland API 采用 /v1 音频接口。开发者按能力调用对应 endpoint,用 model 指定模型,通过同步返回、异步任务或主动查询获取结果。
核心概念
- Endpoint – 开发者请求的接口入口,例如
POST /v1/audio/speech。 - model – 指定要调用的模型,例如
moss-tts;/v1用单个model字段指定模型名称。 - delivery_method –
audio直接返回音频;url返回 JSON 和结果 URL。 - response_format – 音频编码格式,如
mp3/wav;默认mp3。 - async / webhook_url – 传
async=true创建异步任务,终态后回调webhook_url。 - task_id – 异步任务由服务端返回
task_id,用于查询状态与结果。
接口清单
| 接口 | 说明 | 同步 | 异步 |
|---|---|---|---|
| GET /v1/models | 查询可用模型列表 | ✓ | - |
| POST /v1/files | 上传文件并获取 file_id | ✓ | - |
| GET /v1/files | 查询文件列表 | ✓ | - |
| GET /v1/files/{file_id} | 查询文件详情 | ✓ | - |
| DELETE /v1/files/{file_id} | 删除文件 | ✓ | - |
| POST /v1/audio/speech | 单人文本转语音 | ✓ | ✓ |
| POST /v1/audio/speech/speakers | 多人对话语音生成 | ✓ | ✓ |
| POST /v1/audio/voice/generations | 音色 / 语音生成 | ✓ | ✓ |
| GET /v1/audio/voices | 查询音色列表 | ✓ | - |
| POST /v1/audio/voices | 创建 / 克隆音色 | ✓ | - |
| POST /v1/audio/transcriptions | 音频转写(含多说话人) | ✓ | ✓ |
| GET /v1/audio/tasks/{task_id} | 查询通用音频任务 | ✓ | - |