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请求地址
https://open-api.wondershare.cc/v1/open/capacity/application/tm_text2sfx3.2请求参数（需要加版本号）
Method： POST
Headers
|
参数名称 |
参数值 |
是否必须 |
示例 |
备注 |
|
Content-Type |
application/json |
是 |
|
|
|
Authorization |
|
是 |
Basic xxx |
|
|
X-Prod-Id |
|
是 |
123 |
Body
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
其他信息 |
|
prompt |
string |
必须 |
|
提示词，token < 77 多余的会被截断 |
|
|
duration |
number |
必须 |
|
用戶期望的生成音檔時長:0 < length < 47(sec) |
|
|
wsid |
integer |
必须 |
|
wsid |
|
|
qty |
integer |
必须 |
|
生成个数 1-4 |
|
|
units_value |
integer |
必须 |
|
积分扣除单元 例如：如果需要用prompt字段扣分，那就是字符数 |
|
|
disable_translate |
boolean |
非必须 |
|
是否禁止翻译, 默认为false, 开启翻译 |
|
|
drive |
string |
非必须 |
|
如果输出的图片、视频等数据用云存储输出，此字段必填，json字符串类型 示例如下： { "space_id": 11111, // 云存储空间id "file_dest_path": "/path/sss", // 云存储存储路径(目录) "file_tag": // 文件标签 [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] } |
|
|
file_type |
integer |
非必须 |
|
文件类型 0：oss ,5-云存储(需要传drive) |
|
|
callback |
string |
非必须 |
|
回调地址 |
|
|
params |
string |
非必须 |
|
回调透明参数 |
|
|
priority |
number |
非必须 |
|
任务优先级 |
|
3.3返回数据
|
名称 |
类型 |
是否必须 |
默认值 |
备注 |
其他信息 |
|
code |
number |
必须 |
|
错误码 |
|
|
msg |
string |
必须 |
|
错误信息 |
|
|
data |
object |
非必须 |
|
|
|
|
├─ task_id |
string |
非必须 |
|
任务ID |
|
3.4完整示例