音频切分算子,用于从音频或视频文件中提取音频,并按照指定规则将音频切分为多个片段,输出到用户指定的存储路径。该算子主要用于长音频或视频的结构化处理场景,如音频预处理、数据切分、训练数据构建等,支持批量并发处理以及灵活的输出路径组织方式。
算子 ID : las_audio_extract_and_split
1. 音频/视频提取与切分
2. 支持自定义切分规则
3. 支持自定义输出音频格式
4. 支持输出路径模板
5. 支持音频编码参数扩展
"data": { "input_path": "tos://las-doctest/las-ai/input/audio/audio_5mins.mp3", "output_format": "mp3", "output_path_template": "tos://las-doctest/las-ai/output/las_audio_extract_and_split/{ordinal}.{output_file_ext}", "split_duration": 30 }
细分项 | 性能影响说明 |
|---|---|
最大 RPM | 600 |
耗时 |
|
当前版本以 TOS 存储地址作为输入与输出形式,后续将扩展支持 HTTP/HTTPS 等协议。
细分 | 详细说明 |
|---|---|
支持的输入数据模态 |
|
输入格式:音频/视频 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细说明 |
|---|---|
输出数据模态 |
|
输出格式:音频 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 基于输入音频的时长统计用量进行计费。 |
计费类型 | 按量计费,单位: |
单价 | 0.003 元/分钟 |
计费详情
计费公式:总费用 = 单价 * 用量
细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
调用 las_audio_extract_and_split 从音频或视频文件中提取/读取音频,并按规则切分多个片段。
参数 | 类型 | 必填 | 示例值 | 说明 |
|---|---|---|---|---|
operator_id | string | 是 | las_audio_extract_and_split | 本算子的id是 las_audio_extract_and_split。 |
operator_version | string | 是 | v1 | 目前只支持v1。 |
data | process_param | 是 | 算子参数 | |
input_path | string | 是 | tos://xxx/video.mp4 | 输入 TOS 路径或公网 URL。支持的音视频格式:`mp4`、`wmv`、`webm`、`mkv`、`m4v`、`flv`、`avi`、`mov`、`wav`、`mp3`、`flac`。 |
output_path_template | string | 是 | tos://testbucket/{index}.{output_file_ext} | 输出文件路径模板。可注入变量:
|
split_duration | double | 否 | 10 | 每个片段的时长(秒),默认为 30.0。 |
output_format | string | 否 | wav | 输出文件格式,仅支持 wav, mp3, flac,默认为 wav。 |
timeout | integer | 否 | 10 | ffmpeg 执行超时时间(秒),最大值和默认值为600。 |
extra_params | list of string | No | ["-ar", "16000", "-ac", "1", "-b:a", "128k"] | 额外的 ffmpeg 参数列表,直接拼接到命令中。 支持命令:
|
参数 | 类型 | 示例值 | 说明 |
|---|---|---|---|
metadata | metadata | 请求的元信息。 | |
data | result | 返回的数据,随着不同算子有不同模式。 | |
output_paths | list of string | ["tos://dingfeng/0/test.wav", "tos://dingfeng/1/test.wav"] | 输出的音频文件路径列表。 |
metrics | list of metric | 指标。 | |
name | string | duration_ms | 指标名称。支持 duration_ms 输入音频的总毫秒数。 |
value | integer | 指标值。 |
# 请将 INPUT_PATH 设置为 保存在本账号下的视频文件TOS路径 export INPUT_PATH="tos://xxxx/sample.mp4" # 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径 export OUTPUT_PATH_TEMPLATE="tos://xxxx/{index}/test.wav" # 发起算子服务请求 curl --location "https://operator.las.cn-beijing.volces.com/api/v1/process" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data "{ \"operator_id\": \"las_audio_extract_and_split\", \"operator_version\": \"v1\", \"data\": { \"input_path\": \"$INPUT_PATH\", \"output_format\": \"wav\", \"output_path_template\": \"$OUTPUT_PATH_TEMPLATE\", \"split_duration\": 15 } }"
{ "metadata": { "task_status": "COMPLETED", "business_code": "0", "error_msg": "", "request_id": "c7b29d78a99f88beda5497753ed60816" }, "data": { "output_paths": [ "tos://xxx/0/test.wav", "tos://xxx/1/test.wav" ], "metrics": [ { "name": "duration_ms", "value": 26633 } ] } }
HttpCode | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权 |
401 | ApiKey.Invalid | The api key is invalid. | API不合法 |