API 平台

API 概览

Mossland API 采用 /v1 音频接口。开发者按能力调用对应 endpoint,用 model 指定模型,通过同步返回、异步任务或主动查询获取结果。

核心概念

  • Endpoint – 开发者请求的接口入口,例如 POST /v1/audio/speech
  • model – 指定要调用的模型,例如 moss-tts/v1 用单个 model 字段指定模型名称。
  • delivery_methodaudio 直接返回音频;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}查询通用音频任务-