{
"status": "IN_QUEUE",
"request_id": "01a04482-39ff-7632-b67a-97d87c97ffdb",
"response_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb",
"status_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb/status",
"cancel_url": "-01a04482-39ff-7632-b67a-97d87c97ffdb/cancel",
"logs": null,
"metrics": [],
"queue_position": 0
}
curl --location --request POST 'https://zylalabs.com/api/13644/waveform+api/30943/get+id' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"media_url": "https://storage.googleapis.com/falserverless/example_inputs/ffmpeg-audio.wav",
"points_per_second": 4,
"precision": 2,
"smoothing_window": 3
}'
{
"waveform": [
-0.14,
-0.46,
-0.67,
-0.25,
-0.42,
-0.17,
-0.52,
-1,
-0.4,
-0.13,
-0.36,
-0.52,
-0.36,
-0.13,
-0.2,
-0.52,
-0.45,
-0.31,
-0.13,
-0.06,
0.07
],
"duration": 5.36,
"points": 21,
"precision": 2
}
curl --location --request GET 'https://zylalabs.com/api/13644/waveform+api/30944/create+waveform&request_id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 波形 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
波形API从提供的媒体URL生成音频波形的数值表示。只需提交一个包含音频或视频文件的公共可访问URL,API会分析音轨并返回一个结构化的波形,可以用于可视化、播放接口、音频分析和多媒体应用。
响应包括一个波形数组,包含归一化的振幅值,代表分析时长内的音频信号。这些值可以用于生成波形可视化,例如时间轴、音频播放器、进度条、编辑接口和互动多媒体组件。正值和负值表示音频信号的振幅,而返回的点数决定了可视化的细节级别。
API还返回分析的多媒体内容的总时长(以秒为单位),允许应用程序将波形与播放同步。“points”字段表示返回的波形样本数,而“precision”指定用于波形值的小数精度。
POST获取ID端点返回请求ID和波形生成过程的状态信息 GET创建波形端点返回结构化波形数组 音频持续时间 点数和波形值的精度
POST 获取 ID 响应中的关键字段包括 `request_id`、`status` 和 `queue_position` 在 GET 创建波形响应中,重要字段是 `waveform`、`duration`、`points` 和 `precision`,这些字段提供音频可视化的基本细节
响应数据以JSON格式组织 POST获取ID的响应包含状态和请求信息 而GET创建波形的响应包含波形值数组以及持续时间和精度等元数据 使解析和利用变得简单
POST获取ID端点不需要参数 GET创建波形端点接受一个媒体URL,该URL必须是公开可访问的 用户可以通过指定他们希望分析的音频或视频文件的URL来自定义其请求
典型的使用案例包括为音乐播放器生成音频的视觉表示 创建交互式多媒体组件以及进行音频分析以用于研究或开发目的 波形数据可以增强用户界面并改善与音频相关的应用程序
用户可以通过将振幅值映射到图形表示(如波形或进度条)来可视化波形数据 持续时间和精度字段有助于将可视化与音频播放同步 从而增强多媒体应用中的用户体验
数据准确性通过强大的处理算法得以保持,该算法分析来自提供的媒体网址的音频轨道。API确保波形点准确反映音频信号的振幅,从而实现可靠的可视化和分析
用户可以期待波形数组中的归一化振幅值,通常范围从-1到1 返回的点数将根据音频的持续时间和复杂性而有所不同,提供适合各种可视化需求的详细表示