跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
根据文字简述或逐段编排方案创作歌曲或纯音乐,可控制音乐风格、歌词和编排。

模型

  • elevenlabs/music - 根据文本或结构化编排方案生成音乐。

功能

  • 根据文本或结构化编排方案生成音乐。
  • 规划音乐段落,每段可设置自己的风格、歌词和时长。
  • 使用 output_format 选择输出编码。

时长选项

  • 文本输入 - 可选的 duration 为 3 到 600 秒之间的数值,仅与 text 一起使用。
  • 编排方案 - 每个段落为 3-120 秒。

输出选项

输出格式

  • output_format:可选。字符串。默认:mp3_44100_128。
  • mp3_22050_32
  • mp3_44100_32
  • mp3_44100_64
  • mp3_44100_96
  • mp3_44100_128
  • mp3_44100_192
  • pcm_8000
  • pcm_16000
  • pcm_22050
  • pcm_24000
  • pcm_44100
  • pcm_48000
  • ulaw_8000
  • alaw_8000
  • opus_48000_32
  • opus_48000_64
  • opus_48000_96
  • opus_48000_128
  • opus_48000_192

高级参数

在请求根级设置 model 和可选的 callback_url。所有工作流程参数(包括输出选项)都放在 input 中。 选择一种创作方式:文字简述或结构化编排方案。
  • text 和 composition_plan 必须且只能提供一个。
  • duration 和 is_instrumental 仅适用于 text。respect_sections_durations 仅与 composition_plan 一起使用。

文本

  • text:使用文本方式时必填。描述要生成的音乐。长度:1-4,100 个字符。
  • 在音乐描述中写明期望的流派、情绪和乐器。

编排方案

  • composition_plan:使用编排方案方式时必填。描述全局风格和按顺序排列的音乐段落。传入包含以下字段的对象。
  • composition_plan.positive_global_styles:必填。数组,每项必须是字符串。
  • composition_plan.negative_global_styles:必填。数组,每项必须是字符串。
  • composition_plan.sections:必填。至少 1 项,每项为一个对象。
  • composition_plan.sections[].section_name:必填。长度:1-100 个字符。
  • composition_plan.sections[].positive_local_styles:必填。数组,每项必须是字符串。
  • composition_plan.sections[].negative_local_styles:必填。数组,每项必须是字符串。
  • composition_plan.sections[].duration:必填。时长(秒)。数值 3 到 120。
  • composition_plan.sections[].lines:必填。数组,每项必须是字符串,每个字符串最多 200 个字符。
  • 段落时长以秒为单位。

纯音乐模式

  • is_instrumental:可选。设为 true 生成纯音乐。文本方式下默认:false。
  • 仅与 text 一起使用。

段落时长

  • respect_sections_durations:可选。仅与编排方案一起使用,控制是否严格遵循段落时长。使用 true 或 false。编排方案方式下默认:true。

输出文件

  • 读取返回的 files 数组中的每一项。
  • 生成的音频 file_type 为 "audio"。
  • 时间戳和对齐文件可能使用 file_type: "other"。如有可选的文件元数据,请一并保留。

示例

每个示例都包含请求、对应的已完成任务响应和生成的音频。将请求提交到 POST https://api.vidgo.ai/api/generate/submit,然后使用提交返回的任务 ID 查询 GET https://api.vidgo.ai/api/generate/status/{task_id}。
下载音频
下载音频
下载音频

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

在根级设置 model 和可选的 callback_url,创作方式及其控制参数放在 input 中。

model
enum<string>
必填
可用选项:
elevenlabs/music
示例:

"elevenlabs/music"

input
object
必填

text 和 composition_plan 必须且只能提供一个。使用 text 时省略 respect_sections_durations;使用 composition_plan 时省略 duration 和 is_instrumental。

callback_url
string | null

可选的公开 HTTP(S) 接口,用于接收任务完成通知,建议使用 HTTPS。省略、设为 null 或空字符串即不回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填