SuperAPI AI 工具集

music

设计与创作

查看项目

更新于 11-08 16:04

技能介绍

该技能基于 ElevenLabs Music API,用于根据文本提示词生成音乐,适用于器乐、带歌词的歌曲、背景音乐、短广告旋律等场景,也支持通过 composition plan(作曲计划)进行较细粒度的控制。

主要方法包括:music.compose 根据提示词或 composition plan 生成音频;music.composition_plan.create 先生成结构化计划以便修改风格与分段;music.compose_detailed 返回音频、composition plan 和元数据;music.upload 上传音频文件,供后续 inpainting 工作流使用,并可选择提取其 composition plan;该功能面向具备 inpainting 权限的企业客户。

使用方式提供 Python、JavaScript 和 cURL 示例。Python 通过 ElevenLabs 客户端调用 music.compose 并传入 prompt 与 music_length_ms,将返回的音频流写入 mp3 文件;JavaScript 使用 @elevenlabs/elevenlabs-js 包,采用 musicLengthMs 参数,并将结果管道写入文件;cURL 直接向 https://api.elevenlabs.io/v1/music 发起 POST 请求,携带 xi-api-key 与 JSON 请求体,并输出到文件。JavaScript 场景建议仅使用 @elevenlabs/* 包。

细粒度控制流程为:先生成 composition plan,检查或修改 positiveGlobalStyles 等风格与分段信息,再调用 music.compose 传入 composition_plan 生成长音频。

内容限制方面,提示词不得引用具体艺人、乐队或受版权保护的歌词;bad_prompt 错误会附带 prompt_suggestion,bad_composition_plan 错误会附带 composition_plan_suggestion 供替换。错误处理示例展示了对 compose 调用的异常捕获;常见错误包括 401(密钥无效)、422(参数无效)、429(限流)。

限制与未提供信息:定价、配额、可用语言、音频格式细节、最大时长上限等资料未明确说明,需参考官方安装指南与 API 参考。