音效生成 Sound Effect

音效生成用于给已有视频生成背景音或环境音。可以根据视频内容自动生成，也可以通过 sound_effect_content 指定音效方向，注：不是直接返回独立音频，最终产物仍是带音效的视频。

能力示例视频

准备源视频 -> 发起音效生成任务 -> 查询任务状态 -> 获取带音效视频

参数	类型	是否必填	说明
`source_video_id`	integer	条件必填	PixVerse 生成的视频 ID；与 `video_media_id` 二选一
`video_media_id`	integer	条件必填	上传视频获得的 media ID；与 `source_video_id` 二选一
`original_sound_switch`	boolean	否	是否保留原声，默认值是 false，false 不保留原视频音轨，true 将原音与新生成音效共同保留
`sound_effect_content`	string	否	音效描述；为空时可根据视频内容生成省略和传 " " 明确等价，建议使用省略或空字符串，最大 2048 个 Unicode 字符，开启音效但内容为空时，系统会自动生成音效；模板场景则优先使用模板音乐

{
  "source_video_id": 123456,
  "original_sound_switch": true,
  "sound_effect_content": "soft cinematic ambient music"
}

{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "video_id": 123456,
    "credits": 60
  }
}

调用「查询任务状态」接口，通过返回的 video_id 获取生成进度和最终视频 URL。

如果希望模型自动判断音效，sound_effect_content 可以传空字符串。

如源视频已有声音，可通过 original_sound_switch 控制是否保留。

生成后仍通过「查询任务状态」获取结果。