结果查询

接口说明

请求示例

curl "https://unifiedtts.com/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $UNIFIEDTTS_API_KEY"

将 TASK_ID 设置为提交响应中的 data.id。

响应说明

{
  "data": {
    "id": "任务ID",
    "status": "completed",
    "audioUrl": "/api/v1/tasks/任务ID/audio",
    "subtitleUrl": null,
    "durationMs": 12500,
    "billableUnits": 10,
    "error": null
  }
}

示例仅展示相关字段，目录内容、价格及结果以实际响应为准。

status

任务执行状态。

audioUrl / subtitleUrl

结果链接；未完成或缺少对应文件时为 null。

billableUnits

已保存的模型计费用量，不能用原文长度替代。

error

失败或取消原因；正常时为 null。

状态与结果

queued、running 表示尚在处理，可间隔查询；completed、failed、cancelled 是终态。失败或取消时读取 error 并停止轮询。

只有 completed 且确有文件时才返回 audioUrl、subtitleUrl。没有字幕时 subtitleUrl 为 null；durationMs 在没有时长信息时也可能为 null。Edge V2 不提供字幕；Azure 与 MiniMax 取决于上游真实时间戳，MiniMax 可通过 subtitle_enable 关闭字幕。

按本站地址解析返回的文件链接，携带同一账号 Bearer 读取；追加 ?download=1 可作为附件下载。结果地址不含访问令牌，不要自行拼接或向其他站点发送密钥。

查询与重复下载不额外扣费。任务及文件均校验账户归属，其他账号不能读取。