mirror of https://github.com/Hommy-master/capcut-mate.git synced 2026-08-28 15:12:08 +08:00

Files

T

2. 删除多余文档。
3. 添加中英文切换开关。

2026-03-01 20:27:45 +08:00

4.9 KiB

Raw Permalink Blame History

AUDIO_INFOS API 接口文档

🌐 语言切换

中文版 | English

接口信息

POST /openapi/capcut-mate/v1/audio_infos

功能描述

根据音频URL和时间线生成音频信息。该接口将音频文件URL和时间线配置转换为剪映草稿所需的音频信息格式，支持音量控制和音频效果设置。

请求参数

{
  "mp3_urls": ["https://assets.jcaigc.cn/audio1.mp3", "https://assets.jcaigc.cn/audio2.mp3"],
  "timelines": [
    {"start": 0, "end": 3000000},
    {"start": 3000000, "end": 8000000}
  ],
  "audio_effect": "reverb",
  "volume": 0.8
}

参数说明

参数名	类型	必填	默认值	说明
mp3_urls	array[string]	✅	-	音频文件URL数组
timelines	array[object]	✅	-	时间线配置数组
audio_effect	string	❌	None	音频效果名称
volume	number	❌	1.0	音量大小(0.0-2.0)

参数详解

mp3_urls

类型: array[string]
说明: 音频文件URL地址数组
示例: ["https://assets.jcaigc.cn/bgm.mp3", "https://assets.jcaigc.cn/sfx.mp3"]

timelines

类型: array[object]
说明: 时间线配置数组，每个元素包含start和end字段
示例: [{"start": 0, "end": 5000000}, {"start": 5000000, "end": 10000000}]

audio_effect

类型: string
说明: 音频效果名称
默认值: None
示例: "reverb", "echo", "bass_boost"

volume

类型: number
说明: 音频音量大小
默认值: 1.0
范围: 0.0 - 2.0
示例: 0.8 (80%音量)

##响应格式

成功响应 (200)

{
  "infos": "[{\"audio_url\":\"https://assets.jcaigc.cn/audio1.mp3\",\"start\":0,\"end\":3000000,\"duration\":5000000,\"volume\":0.8,\"audio_effect\":\"reverb\"},{\"audio_url\":\"https://assets.jcaigc.cn/audio2.mp3\",\"start\":3000000,\"end\":8000000,\"duration\":8000000,\"volume\":1.0,\"audio_effect\":null}]"
}

###响应字段说明

字段名	类型	说明
infos	string	音信息JSON字符串

###错误响应 (4xx/5xx)

{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1.基本音频信息生成

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/audio_infos \
  -H "Content-Type: application/json" \
  -d '{
    "mp3_urls": ["https://assets.jcaigc.cn/bgm.mp3"],
    "timelines": [{"start": 0, "end": 10000000}],
    "volume": 0.7
  }'

2.效果的音频信息

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/audio_infos \
  -H "Content-Type: application/json" \
  -d '{
    "mp3_urls": ["https://assets.jcaigc.cn/intro.mp3", "https://assets.jcaigc.cn/content.mp3"],
    "timelines": [{"start": 0, "end": 2000000}, {"start": 2000000, "end": 12000000}],
    "audio_effect": "reverb",
    "volume": 0.9
  }'

##错误码说明

错误码	错误信息	说明	解决方案
400	mp3_urls是必填项	缺少音频URL参数	提供有效的音频URL数组
400	timelines是必填项	缺少时间线参数	提供有效的时间线数组
400	数组长度不匹配	mp3_urls和timelines长度不一致	确保两个数组长度相同
400	volume值无效	音不在0.0-2.0范围内	使用0.0-2.0之间的音量值
404	音频资源不存在	音频URL无法访问	检查音频URL是否可访问
500	音频信息生成失败	内部处理错误	联技术支持

注意事项

数组匹配: mp3_urls和timelines数组长度必须相同
时间单位:所有时间参数使用微秒（1秒 = 1,000,000微秒）
音量范围: volume值必须在0.0-2.0范围内
效果支持: audio_effect需要是系统支持的音频效果名称
JSON格式: 返回的infos是JSON字符串，需要解析后使用
网络访问: 音频URL必须可以正常访问

##工作流程

1.验证必填参数（mp3_urls, timelines） 2.检查数组长度匹配 3.验证时间线参数有效性 4.验证音量参数范围 5. 为每个音频URL生成对应的音频信息 6.应用音量和音频效果设置 7.将信息转换为JSON字符串格式 8. 返回处理结果

##相关接口

📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate

语言切换