会议转写 API
POST /v1/meeting/upload-tickets · /v1/meeting/tasks 会议录音异步转写 · 输出分说话人分段
将多人会议录音转写为带说话人与时间戳的分段文本。当前版本支持中文。会议录音走异步任务:先申请上传签名、PUT 直传 OSS,再提交任务并轮询结果(wav/mp3/flac/m4a/ogg/aac,≤500MB、最长 2 小时)。与语音识别的逐段切分不同,会议转写整段录音一次推理(说话人编号需要全录音上下文才能保持一致)。任务状态机与轮询约定见通用说明 · 异步任务。
三步流程
| 步骤 | 接口 | 要点 |
|---|---|---|
| ① 申请签名 | POST /v1/meeting/upload-tickets | 入参 {fileName, sizeBytes};响应 {fileKey, uploadUrl, headers, maxSizeBytes},PUT 时必须带同值 Content-Type |
| ② 直传 OSS | PUT {uploadUrl} | PUT 签名 URL(域名是 OSS 非平台);文件 ≤ 500MB |
| ③ 提交并轮询 | POST /v1/meeting/tasks → GET /v1/meeting/tasks/{taskNo} | 提交体 {audio:{url: fileKey}, fileName};轮询到 success 后取 resultUrl 下载结果 JSON |
请求示例
# ① 申请上传签名 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 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| durationMs | integer | 音频总时长(毫秒,引擎实测) |
| speakerCount | integer | 识别出的说话人数量 |
| utterances | array | 分段数组,按时间顺序 |
| utterances[].startTime / endTime | integer | 分段起止时间(毫秒) |
| utterances[].speakerId | integer | 说话人编号(0 起始,全录音一致——同一嗓音恒同号) |
| utterances[].text | string | 该分段的转写文本 |
结果 JSON 示例
{
"durationMs": 486000,
"speakerCount": 3,
"utterances": [
{ "startTime": 0, "endTime": 5420, "speakerId": 0, "text": "好,那我们开始今天的站会,先从你这边说起。" },
{ "startTime": 5900, "endTime": 12400, "speakerId": 1, "text": "我这边昨天把转码那条链路收尾了,今天看聚合。" }
]
}
任务历史分页查询,分页参数与字段结构同语音识别 · 历史记录查询;差异字段:会议转写行含 speakerCount(说话人数量,成功任务行回填,失败任务为 null),无 language/hotwords。
按笔后付费:每次成功调用按实际用量从账户余额扣费,失败调用不扣费。费用明细与账户余额可在「会议转写工具」页的「历史记录」与「账户信息」页查看。
按音频实际时长计费,元 / 小时,精确到秒折算。牌价以平台实时牌价为准。异步任务整段录音一笔计费(任务失败不计费)。程序化查询在线模型与实时牌价:GET /v1/meeting/models,见通用说明 · 模型列表。
网络中断可能发生在计费完成之后,重试同一请求会产生新的计费,请结合「调用记录」核对后再重试。