1简介
1.1服务能力简介
天幕2.0在文生音效部分进行了创新，支持一键调整歌曲风格、曲风、情绪、音色。当视频需要特定的声音效果来烘托氛围或描绘动作时，用户可以直接输入对场景环境或具体动作的文字描述。系统将基于这些描述，智能生成层次丰富、细节逼真且高度贴合现实的环境音效和动作音效。该功能极大简化了音效制作流程。它能高效地为用户补全视频所需的各类氛围音效，精准还原文字描述所对应的声音质感，显著增强视频的真实感和空间临场感。无需复杂的音效库搜索或专业录制，即可快速获得高质量、与画面内容完美匹配的音效素材，提升整体制作效率。
1.2效果展示
|
prompt |
输出音效 |
生成封面图、标题 |
|
rain |
标题: Rain whispers softly |
|
|
heavy raining in the city with grumbling thunder and lightning |
标题: 雷雨怒吼 |
|
|
Generate a big long cartoony wet kiss |
|
标题: Cartoony Wet Kiss Sound |
2Prompt engine
|
提示词=主体+场景（氛围/风格）
|
3API接入
3.1请求地址（POST 请求）
https://open-api.wondershare.cc/v1/open/capacity/application/tm_text2sfx3.2请求参数
Headers
|
参数名称 |
参数值 |
是否必须 |
示例 |
备注 |
|
Content-Type |
application/json |
是 |
|
|
|
X-App-Key |
{app_key} |
是 |
xxxxxx |
分配的appkey |
|
Authorization |
Basic {access_token} |
是 |
Basic xxx |
安全验证信息，格式为：Basic {access_token}，其中access_token为令牌，通过给的app_key和app_secret生产，生成方式为：base64(app_key:app_secret) |
Body
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
|
prompt |
string |
必须 |
|
提示词。支持 77token以内，多余的会被截断；支持英文，需要支持多语言则需要开启翻译 |
|
duration |
number |
必须 |
|
用户期望生成的音效时长。支持 0-47秒 |
|
qty |
integer |
必须 |
|
音效生成个数。支持 1-4 |
|
disable_translate |
boolean |
非必须 |
false |
是否禁止翻译 |
|
callback |
string |
非必须 |
|
回调地址 |
|
params |
string |
非必须 |
|
回调透明参数 |
返回数据：
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
|
code |
number |
必须 |
|
错误码 |
|
msg |
string |
必须 |
|
错误文案 |
|
data |
object |
非必须 |
|
|
|
├─ task_id |
string |
非必须 |
|
任务ID |
3.3 请求示例
curl --location --request POST 'https://open-api.wondershare.cc/v1/open/capacity/application/tm_text2sfx' \
--header 'X-App-Key: XXXXXX' \
--header 'Authorization: Basic XXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "heavy raining in the city with grumbling thunder and lightning",
"duration": 5,
"qty": 1
}'
3.4 响应结果
-
创建任务接口返回结果：
{
"code": 0,
"msg": "",
"data": {
"task_id": "tm_text2sfx_multi-2-20251030163630738656cac50fb507f4"
}
}