音效生成(背景音乐)使用指南
功能概览
POST https://app-api.pixverseai.cn/openapi/v2/video/sound_effect/generate前提条件
或者
使用步骤
1. 参数形式调用音效/背景音乐(sound_effect)
| 字段名 | 类型 | 是否必传 | 取值说明 | 备注说明 |
|---|---|---|---|---|
sound_effect_switch | boolean | 否 | 枚举值：true, false | - 是否开启音效生成(背景音乐) - 必须为布尔值（true 或 false） |
sound_effect_content | string | 否 | 任意字符串或不传 | - 可选 - 如果不传，系统将随机生成音效 |
是否使用模板功能 (template_id) | sound_effect_switch 值 | sound_effect_content 值 | 预期效果 | 扣减说明 |
|---|---|---|---|---|
| 使用 | true | 未传 | 使用模板内置背景音乐 如无，则自动生成音效 | 仅扣视频生成积分（如 45 credits，5s/360p/v4.5） |
| 使用 | true | 空字符串 "" | 同上（如无模板音乐则自动生成） | 同上 |
| 使用 | true | "sea waves" | 同上（如无模板音乐则自动生成） | 同上 |
| 使用 | false | 任意取值 | 不带任何背景音乐 | 同上 |
| 不使用 | true | 未传 | 自动根据视频内容生成音效 | 视频生成 45 + 音效生成 10 = 共 55 credits |
| 不使用 | true | 空字符串 "" | 同上 | 同上 |
| 不使用 | true | "sea waves" | 根据提供内容生成音效 | 同上 |
| 不使用 | false | 任意取值 | 不带任何背景音乐 | 仅扣视频生成积分（如 45 credits，5s/360p/v4.5） |
2. 通过接口生成音效/背景音乐
| 字段名 | 名称 | 类型 | 是否必传 | 取值说明 | 备注说明 |
|---|---|---|---|---|---|
source_video_id | 生成出的视频 ID | int | 是 | - | 视频 ID；与 video_media_id 二选一必传 |
video_media_id | 上传的视频 ID | int | 是 | - | 视频 ID；与 source_video_id 二选一必传 |
model | 模型 | string | 否 | - | 目前无需填写，预留字段 |
original_sound_switch | 是否保留原始声音 | boolean | 否 | 枚举值：true, false | 是否保留视频原声，默认值为 false |
sound_effect_content | 音效内容 | string | 否 | 任意字符串或不传 | 可不传；如不传则默认随机生成音效 |
点数消耗
功能计费说明
| 功能 | 计费标准 | 示例 |
|---|---|---|
| 音效（Sound effect） | 每 5 秒增加 10 Credits | 5 秒 → 10 Credits 8 秒 → 20 Credits 10 秒 → 20 Credits |
修改于 2025-08-06 03:19:44