Skip to main content

说话人日志接口

接口信息​

  • 接口路径: /v1/diarize
  • 请求方式: POST
  • 认证方式: Header 中的 X-API-Key

请求头​

参数名类型必填说明
X-API-Keystring是应用密钥
注意： X-API-Key 用于验证账户信息，进入 控制台 → 项目空间，选择对应项目，左侧导航进入「API Key 管理」即可创建/查看。

请求参数​

参数名类型必填说明
object_keystring否OSS 存储中的音频对象 Key，与 url 二选一
urlstring否音频文件的公开访问 URL，与 object_key 二选一

注意：object_key 和 url 参数必须提供其中一个。如果同时提供，优先使用 url。

音频文件要求：文件大小不超过 500 MB，时长不超过 300 秒，支持 WAV、MP3 等常见音频格式。

请求示例​

curl -X POST "https://api.vuilabs.cn/v1/diarize" \
  -H "X-API-Key: your-secret-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/audio.mp3"
  }'

响应参数​

参数名类型说明
error_codenumber错误码，0 表示成功
error_messagestring错误信息，成功时为空
succeedboolean请求是否成功
dataobject响应数据
data.trace_idstring请求追踪 ID，用于问题排查
data.speakersarray说话人列表
data.speakers[].speaker_idstring说话人标识符（如 "A"、"B" 等）
data.speakers[].total_durnumber该说话人的总发言时长（秒）
data.speakers[].segmentsarray该说话人的发言片段列表
data.speakers[].segments[].start_timenumber发言片段开始时间（秒）
data.speakers[].segments[].end_timenumber发言片段结束时间（秒）

成功响应示例​

{
    "error_code": 0,
    "error_message": "",
    "succeed": true,
    "data": {
        "trace_id": "a874b3b77b6f1412bab3fb75bb73eb5e",
        "speakers": [
            {
                "speaker_id": "A",
                "total_dur": 1.242,
                "segments": [
                    {
                        "start_time": 1.218,
                        "end_time": 1.662
                    },
                    {
                        "start_time": 2.112,
                        "end_time": 2.91
                    }
                ]
            }
        ]
    }
}

错误响应示例​

{
  "error_code": 20003,
  "error_message": "余额不足",
  "succeed": false,
  "data": null
}

错误码​

业务失败时 HTTP 状态码仍为 200，请检查响应中的 succeed 和 error_code。

error_code说明
10001 / 20011 / 20013参数错误、未提供 object_key 或 url、音频时长不足 1 秒
10003X-API-Key 缺失或无效
10004API Key 未开通此接口所需权限
20003免费额度和账户余额均不足
10005 / 10014请求频率或连接数超过限制
20002服务暂时不可用
10000服务内部错误

计费说明​

具体计费规则、价格和免费额度请参见 产品计费。