查询任务 · Moss API

路径参数

字段类型必填说明

task_idstring必填

异步请求返回的任务 ID。

返回值

接口返回任务的当前状态。任务成功后，结果字段直接位于响应顶层。

字段类型说明

id: string

任务 ID，与路径中的 task_id 对应。

object: string

任务对象类型，例如 audio.speech / audio.voice_generation / audio.transcription。

status: string

任务状态，例如 PENDING / PROCESSING / SUCCESS / FAILED。

created_at: integer

创建时间，Unix 时间戳，单位为秒。

updated_at: integer

最近更新时间，Unix 时间戳，单位为秒。

error: object

任务执行失败信息。

语音任务结果

当 status=SUCCESS，且 object 为 audio.speech 或 audio.voice_generation 时，返回音频结果 URL。实际格式以返回的 response_format 和 content_type 为准。

字段类型条件说明

urlstring成功时

音频结果 URL。

response_formatstring成功时

实际输出音频格式，例如 wav。

content_typestring成功时

音频 MIME 类型，例如 audio/wav。

转写任务结果

当 status=SUCCESS，且 object=audio.transcription 时，text 返回完整转写文本；说话人分离任务还会返回 segments。

字段类型条件说明

textstring普通转写成功时

完整转写文本。

segmentsarray说话人分离成功时

说话人分离片段；无有效分段时可能为空数组。

segments[].speakerstring有分段时

说话人标识。

segments[].textstring有分段时

该分段文本。

segments[].startnumber有分段时

分段起始时间，单位为秒。

segments[].endnumber有分段时

分段结束时间，单位为秒。

任务失败

status=FAILED 表示任务已创建但执行失败，与任务不存在或无权访问的查询错误不同。失败原因位于 error。

错误码

HTTP	error.code	触发条件	处理建议
404	`task_not_found`	指定 `task_id` 不存在或不可见	确认使用创建任务接口返回的 `task_id`，且 API Key 有权限访问该任务。

下一步

单人语音生成

文本转语音接口。

音频转写

音频转写接口。

请求示例

curl -X GET "https://api.mosi.cn/v1/audio/tasks/<task_id>" \
  -H "Authorization: Bearer $MOSS_API_KEY"

import os
import requests

response = requests.get(
        "https://api.mosi.cn/v1/audio/tasks/<task_id>",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/audio/tasks/<task_id>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
  },
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

响应示例

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.speech",
  "status": "SUCCESS",
  "created_at": 1710000000,
  "updated_at": 1710000003,
  "url": "https://example.com/result.wav",
  "response_format": "wav",
  "content_type": "audio/wav"
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.transcription",
  "status": "SUCCESS",
  "created_at": 1710000000,
  "updated_at": 1710000002,
  "text": "This is a short transcription test audio."
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.voice_generation",
  "status": "PROCESSING",
  "created_at": 1710000000,
  "updated_at": 1710000001
}

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.speech",
  "status": "FAILED",
  "error": {},
  "created_at": 1710000000,
  "updated_at": 1710000001
}