视频转音乐

根据一个或多个视频文件生成背景音乐。视频将按顺序合并。可选描述和风格标签会影响生成的音乐。

请求头

xi-api-keystring可选

查询参数

output_formatenum可选
生成音频的输出格式。格式为 codec_sample_rate_bitrate。因此,采样率为 22.05kHz、比特率为 32kbs 的 mp3 表示为 mp3_22050_32。使用 192kbps 比特率的 MP3 需要订阅 Creator 或更高版本。采样率为 44.1kHz 的 PCM 格式需要订阅 Pro 或更高版本。请注意,μ-law 格式(有时写作 mu-law,通常近似写作 u-law)常用于 Twilio 音频输入。

请求

This endpoint expects a multipart form with multiple files.
videosfiles必需
通过 FormData 数组(multipart/form-data)发送的一个或多个视频文件。它们将按顺序合并为一个编解码器。 最多允许 10 个视频,合并后视频总大小不得超过 200MB。 视频总时长最长为 600 秒。请注意,合并多个视频可能会显著增加请求时长。如有可能,请提前合并视频。
descriptionstring or null可选1-1000 characters

所需音乐的可选文本描述。最多 1000 个字符。

tagslist of strings可选默认为 []

可选的风格标签列表(例如 [‘upbeat’, ‘cinematic’])。最多可包含 10 个标签。

model_idenum可选默认为 music_v1

用于生成的模型。

允许的值:
sign_with_c2paboolean可选默认为 false

是否使用 C2PA 为生成的歌曲签名。仅适用于 mp3 文件。

响应

与视频匹配的生成音频文件。Content-Type 和文件扩展名取决于 output_format 参数(默认为 mp3)。

错误

403
Forbidden Error
422
Unprocessable Entity Error