查询任务

查询通用音频异步任务的最新状态与结果。用创建异步任务（async=true）时服务端返回的 task_id 查询；任务成功后结果字段展开在顶层，不包在 result 字段中。包括音频转写在内的各类音频异步任务，均统一用本接口查询。

GET

/v1/audio/tasks/{task_id}

通用音频异步任务查询。无请求体；返回任务对象，成功路径状态机为 PENDING → PROCESSING → SUCCESS，失败时进入失败终态并返回 error。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。

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

路径参数

字段	类型	必填	说明
task_id	string	是	创建异步任务时服务端返回的任务 ID，例如 `task_abc123`。

请求示例

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

响应字段

字段	类型	必返	说明
id	string	是	任务 ID。
object	string	是	任务对象类型，例如 `audio.speech` / `audio.voice_generation` / `audio.transcription`。
status	string	是	任务状态，例如 `PENDING` / `PROCESSING` / `SUCCESS` / `FAILED`。
created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
updated_at	integer	是	最近更新时间，Unix 时间戳，单位为秒。
retry_after	integer	否	建议轮询间隔（秒），任务未到终态时返回。

响应示例

{
  "id": "task_abc123",
  "object": "audio.speech",
  "status": "PROCESSING",
  "created_at": 1710000000,
  "updated_at": 1710000000,
  "retry_after": 3
}

任务可能较长时间处于 PROCESSING，完成时长以实际处理为准；轮询间隔建议从返回的 retry_after（秒）起步。

下一步

同步、异步与任务查询

同步直接返回结果；异步任务用 task_id 查询。

单人语音生成

文本转语音接口。

音频转写

音频转写接口。