同步、异步与任务查询

当前 /v1 接口采用同步/异步模型：同步请求直接返回结果；异步请求通过 async=true 创建任务，并用服务端返回的 task_id 查询。

同步请求

不传 async=true 时，接口按能力直接返回结果。语音生成在 delivery_method=audio 时直接返回音频内容，delivery_method=url 时返回 JSON 和结果 URL。

异步请求

传入 async=true 时，接口立即返回任务对象；可选传入 webhook_url 接收终态回调。

{
  "model": "moss-tts",
  "input": "这是一段异步生成的语音。",
  "voice_id": "<voice_id>",
  "async": true,
  "webhook_url": "https://example.com/webhook"
}

创建成功时接口立即返回任务对象：

{
  "task_id": "task_abc123",
  "status": "PENDING",
  "retry_after": 3
}

任务成功路径的状态机为 PENDING → PROCESSING → SUCCESS；失败时任务进入失败终态，返回内部标准错误结构 error（见下方任务查询说明）。任务可能较长时间处于 PROCESSING，完成时长以实际处理为准；轮询间隔建议从返回的 retry_after（秒）起步。

任务查询

用服务端返回的 task_id 查询任务的最新状态与结果。

通用音频任务的接口参数见 Audio Tasks。

curl https://api.mosi.cn/v1/audio/tasks/$TASK_ID \
  -H "Authorization: Bearer $MOSS_API_KEY"