用途:通过 ElevenLabs Music API 从文本提示生成音乐,包括器乐、含歌词歌曲、背景音乐与广告短曲,也可基于视频生成配乐。
主要能力:music.compose 按提示或作曲计划生成音频;music.stream 流式输出(需付费套餐);composition_plan.create 生成可编辑的分段计划;compose_detailed 返回音频、计划与元数据,store_for_inpainting=True 可启用修补;compose_detailed_stream 以 SSE 流式返回音频、元数据与可选词级时间戳;video_to_music 依据上传视频生成背景音乐;upload 上传音频用于后续修补,可提取计划或时间戳;finetunes 系列接口列出、训练、查询、更新与删除音乐微调模型。
使用方式:安装后配置密钥,Python 用 elevenlabs 包,JavaScript 仅用 @elevenlabs/* 包。默认使用 music_v2_5,仅在明确要求旧模型时使用 music_v2 或 music_v1。可用 CLI,例如: elevenlabs music compose --prompt "A chill lo-fi beat" --music-length-ms 30000 --model-id music_v2_5 --output output.mp3 作曲计划为有序分段,每段含 text、duration_ms、positive_styles、negative_styles、context_adherence;最多 30 段,每段 3000–120000 毫秒,总时长 3 秒至 10 分钟。输出格式通过 output_format 选择,auto 对 music_v2 与 music_v2_5 选择 mp3_48000_192。
适用场景:批量生成配乐、按段落控制歌词与风格、流式预览、视频配乐、微调自有风格。
限制:不得引用具体艺人、乐队或受版权保护的歌词;video_to_music 每次上传 1–10 个视频,合计不超过 200 MB、600 秒,默认模型为 music_v1;CLI 每次只接受一个 --videos 文件和一个 --tags 值,多视频或多标签需用 Python 或 TypeScript SDK;流式与 upload 修补等能力受套餐或企业权限限制;错误包含 401、422、429,bad_prompt 与 bad_composition_plan 会给出改写建议。