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 上线。
基本信息
| 项目 | 取值 |
|---|---|
| ModelName | EL |
| 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 music | music_v2 |
compose_v2.5 | 音乐 | Compose music | music_v2_5 |
compose_detailed_v2.5 | 音乐(细节生音乐) | Compose music with details | music_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 | 否 | String | EL |
ModelVersion | 否 | String | compose_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 指南未写明)。