跳到内容

EL ​

更新时间

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcAudioTask

EL(ElevenLabs)是音频生成模型:compose_* 系列基于提示词生成音乐,sound_t2s_* 系列基于文本生成音效。音乐提供 compose_v2、compose_v2.5、compose_detailed_v2.5 三个版本,音效提供 sound_t2s_v2、sound_t2s_v3 两个版本;其中 compose_v2.5、compose_detailed_v2.5、sound_t2s_v3 于 2026-11-16 上线。

选版本见版本差异,各版本写法见按版本调用。

基本信息 ​

项目取值
ModelNameEL
ModelVersion音乐:compose_v2 / compose_v2.5 / compose_detailed_v2.5;音效:sound_t2s_v2 / sound_t2s_v3
SceneType无需填写
用途compose_* 音乐,sound_t2s_* 音效

版本差异 ​

ModelVersion类型上游 ElevenLabs 接口上游模型
compose_v2音乐Compose musicmusic_v2
compose_v2.5音乐Compose musicmusic_v2_5
compose_detailed_v2.5音乐(细节生音乐)Compose music with detailsmusic_v2_5
sound_t2s_v2音效Sound effects—
sound_t2s_v3音效Sound effects—

怎么选:

  • 普通的提示词生音乐 → compose_v2.5(最新);compose_v2 仍可用。
  • 走「细节生音乐」接口 → compose_detailed_v2.5。
  • 短音效 → sound_t2s_v3(最新);sound_t2s_v2 仍可用。

「上游模型」一列是根据版本名与上游 model_id 取值(music_v2 / music_v2_5)推断的,接入指南没有写明对应关系。音效两个版本的上游模型指南未说明,故留空;sound_t2s_v3 与 v2 共用同一参数表(Duration [1, 30]),指南没有写两者的效果差异。

⚠️ 上游的「细节生音乐」还支持按段落编排的 composition_plan,并会在音频之外返回元数据。接入指南对 compose_detailed_v2.5 只写了 Prompt + OutputConfig,没有说明 composition_plan 能否经 AdditionalParameters 透传、额外元数据是否返回 —— 这两点待确认,依赖之前请先实测。

请求参数 ​

参数必填类型说明
SubAppId否Integer点播应用 ID
ModelName否StringEL
ModelVersion否Stringcompose_v2 / compose_v2.5 / compose_detailed_v2.5 / sound_t2s_v2 / sound_t2s_v3
SceneType否String无需填写
Prompt否String风格 / 乐器 / 场景描述(音效:描述声音本身)
OutputConfig否Object输出设置,见下表

OutputConfig ​

字段适用版本说明
StorageMode全部Temporary:不存入点播,事件通知里返回临时访问 URL,有效期 7 天;Permanent:存入点播,返回 FileId
Duration仅 sound_t2s_*音效时长(秒),[1, 30]

按版本调用 ​

音乐(compose_v2.5) ​

compose_v2 写法相同,只换 ModelVersion。

json
{
  "ModelName": "EL",
  "ModelVersion": "compose_v2.5",
  "Prompt": "A quiet electronic instrumental for a night drive",
  "SubAppId": 123456789,
  "OutputConfig": {
    "StorageMode": "Temporary"
  }
}

细节生音乐(compose_detailed_v2.5) ​

json
{
  "ModelName": "EL",
  "ModelVersion": "compose_detailed_v2.5",
  "Prompt": "Cinematic orchestral trailer music, slow build to an epic climax",
  "SubAppId": 123456789,
  "OutputConfig": {
    "StorageMode": "Permanent"
  }
}

音效(sound_t2s_v3) ​

sound_t2s_v2 写法相同,只换 ModelVersion。

json
{
  "ModelName": "EL",
  "ModelVersion": "sound_t2s_v3",
  "Prompt": "Rain on a metal roof",
  "SubAppId": 123456789,
  "OutputConfig": {
    "StorageMode": "Temporary",
    "Duration": 6
  }
}

响应示例 ​

json
{
  "Response": {
    "TaskId": "<task-id>",
    "RequestId": "<request-id>"
  }
}

用 DescribeTaskDetail 查询完成结果。请参考 音频结果结构。

特殊设置 ​

  • OutputConfig.Duration 只对音效 sound_t2s_v2 / sound_t2s_v3 生效(1–30 秒),不适用于 compose_* 音乐版本。
  • 所有版本都不指定 SceneType。
  • 上游普通提示词上限 4100 字符(参考值,取自 ElevenLabs 上游接口,VOD 指南未写明)。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages