01异步转写

将多人会议录音转写为带说话人与时间戳的分段文本。当前版本支持中文。会议录音走异步任务:先申请上传签名、PUT 直传 OSS,再提交任务并轮询结果(wav/mp3/flac/m4a/ogg/aac,≤500MB、最长 2 小时)。与语音识别的逐段切分不同,会议转写整段录音一次推理(说话人编号需要全录音上下文才能保持一致)。任务状态机与轮询约定见通用说明 · 异步任务。

接口 POST/v1/meeting/upload-tickets
接口 POST/v1/meeting/tasks
接口 GET/v1/meeting/tasks/{taskNo}

三步流程

步骤接口要点
① 申请签名POST /v1/meeting/upload-tickets入参 {fileName, sizeBytes};响应 {fileKey, uploadUrl, headers, maxSizeBytes},PUT 时必须带同值 Content-Type
② 直传 OSSPUT {uploadUrl}PUT 签名 URL(域名是 OSS 非平台);文件 ≤ 500MB
③ 提交并轮询POST /v1/meeting/tasks → GET /v1/meeting/tasks/{taskNo}提交体 {audio:{url: fileKey}, fileName};轮询到 success 后取 resultUrl 下载结果 JSON

请求示例

bash · curl
# ① 申请上传签名
curl https://www.suanlinfang.cn/v1/meeting/upload-tickets \
  -H "Authorization: Bearer $SLF_API_KEY" -H "Content-Type: application/json" \
  -d '{"fileName":"weekly-2h.mp3","sizeBytes":183000000}'

# ② PUT 直传 OSS(URL/headers 用①的响应值)
curl -X PUT "https://slf-media-meeting.oss-cn-beijing.aliyuncs.com/inference-media/upload/1024/8f14e45f-....mp3?Expires=...&Signature=..." \
  -H "Content-Type: audio/mpeg" --data-binary @weekly-2h.mp3

# ③ 提交任务(audio.url = ①响应的 fileKey,非公网 URL)
curl https://www.suanlinfang.cn/v1/meeting/tasks \
  -H "Authorization: Bearer $SLF_API_KEY" -H "Content-Type: application/json" \
  -d '{"audio":{"url":"inference-media/upload/1024/8f14e45f-....mp3"},"fileName":"weekly-2h.mp3"}'

# 轮询(success 后按 resultUrl 下载结果 JSON)
curl -H "Authorization: Bearer $SLF_API_KEY" \
  https://www.suanlinfang.cn/v1/meeting/tasks/f47ac10b-58cc-4372-a567-0e02b2c3d479

任务查询响应中 doneUnits/totalUnits 恒为 1/1(整段录音单单元);status 为 received/queued/running/aggregating/success/failed/expired。轮询到 success 后按 resultUrl 下载结果 JSON。

结果 JSON 字段

字段类型说明
durationMsinteger音频总时长(毫秒,引擎实测)
speakerCountinteger识别出的说话人数量
utterancesarray分段数组,按时间顺序
utterances[].startTime / endTimeinteger分段起止时间(毫秒)
utterances[].speakerIdinteger说话人编号(0 起始,全录音一致——同一嗓音恒同号)
utterances[].textstring该分段的转写文本

结果 JSON 示例

json · result
{
  "durationMs": 486000,
  "speakerCount": 3,
  "utterances": [
    { "startTime": 0, "endTime": 5420, "speakerId": 0, "text": "好,那我们开始今天的站会,先从你这边说起。" },
    { "startTime": 5900, "endTime": 12400, "speakerId": 1, "text": "我这边昨天把转码那条链路收尾了,今天看聚合。" }
  ]
}
02历史记录查询
接口 GET/v1/meeting/tasks

任务历史分页查询,分页参数与字段结构同语音识别 · 历史记录查询;差异字段:会议转写行含 speakerCount(说话人数量,成功任务行回填,失败任务为 null),无 language/hotwords。

03计费说明

按笔后付费:每次成功调用按实际用量从账户余额扣费,失败调用不扣费。费用明细与账户余额可在「会议转写工具」页的「历史记录」与「账户信息」页查看。

按音频实际时长计费,元 / 小时,精确到秒折算。牌价以平台实时牌价为准。异步任务整段录音一笔计费(任务失败不计费)。程序化查询在线模型与实时牌价:GET /v1/meeting/models,见通用说明 · 模型列表。

网络中断可能发生在计费完成之后,重试同一请求会产生新的计费,请结合「调用记录」核对后再重试。