ElevenLabs Sound Effects v2
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | elevenlabs/sound-effects-v2 |
|---|---|
| 类型 | 音频生成（text-to-audio） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
ElevenLabs Sound Effects v2 文生音效：用一句描述生成 0.5–22 秒的音效，支持无缝循环和提示词影响强度，固定输出 MP3，适合视频、游戏与应用音效。
生产建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。
适用场景
为片头、转场、logo 揭示和预告片高潮生成低频冲击、whoosh 与金属点缀，时长按镜头长度设定。
promptduration_secondsprompt_influence生成雨声、风声、机器嗡鸣等可循环背景层，用 loop 让首尾尽量衔接。
promptduration_secondsloop批量制作拾取、升级、命中、按钮和通知提示音，用短时长与高 prompt_influence 固定声音细节。
promptduration_secondsprompt_influence请求参数
model string 必填 固定填 elevenlabs/sound-effects-v2。
input object 必填 业务参数对象；Sound Effects v2 的模型专属配置都放在这里。
prompt string 必填 要生成的声音描述，1–450 个字符。先写声音本体，再补材质、动作、空间和情绪；需要排除音乐或人声时直接写进描述。
duration_seconds number 必填 音效时长，0.5–22 秒，支持小数秒，例如 0.5、2、8.5。必须明确填写，不提供自动时长；计费按请求秒数计算。
prompt_influence number 可选 描述对结果的影响程度，0–1。数值越高越贴近描述，越低的变化越多。
loop boolean 可选 设为 true 时生成首尾尽量无缝衔接的音效，适合环境声、游戏循环和背景氛围；不会改变时长。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
用一句描述生成 2 秒预告片 braam，保留低频下潜、金属泛音与短混响尾音。
{
"model": "elevenlabs/sound-effects-v2",
"input": {
"prompt": "Spacious cinematic braam with a deep sub-bass impact, metallic shimmer and a short reverb tail, suitable for a high-impact movie trailer moment.",
"duration_seconds": 2,
"prompt_influence": 0.3,
"loop": false
}
}生成 8 秒雨夜森林环境声并开启 seamless loop，描述中排除鸟叫以保持声场均匀。
{
"model": "elevenlabs/sound-effects-v2",
"input": {
"prompt": "Steady rainy-night forest ambience: fine rain on leaves, a distant soft thunder rumble, no birds, immersive and even.",
"duration_seconds": 8,
"prompt_influence": 0.3,
"loop": true
}
}获取结果
- 提交成功后立即返回 taskId（不等待生成完成）。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output 中找到 type=audio 的条目，通过 url 下载生成的 MP3。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
ElevenLabs Sound Effects v2 能生成什么？
它把一句声音描述变成一段独立音效，例如电影低频冲击、雨夜环境声、游戏拾取提示音或 UI 反馈音。每次请求生成一条音频，不做音乐，也不做语音合成。
时长如何控制？
必须明确填写 duration_seconds，范围 0.5–22 秒，支持小数秒，例如 0.5、2、8.5。首版不提供自动时长，计费按请求秒数计算。
prompt_influence 有什么用？
它控制描述对结果的影响程度，范围 0–1，默认 0.3。数值越高越贴近描述，越低的变化越多，适合在固定方向上探索不同版本。
loop 是什么？
打开 loop 后会尽量生成首尾可衔接的音效，适合环境声、游戏循环和背景氛围；它不会改变时长，时长仍由 duration_seconds 决定。
输出是什么格式？
当前固定输出 MP3（44.1 kHz、128 kbps）。每次请求返回一条音频产物，可直接下载或保存。
怎么计费？
按请求的时长每秒计费，例如 2 秒按 2 秒计算。失败任务会退回扣费；实时价格以价格页为准。 查看价格页
如何通过 API 调用？
向 POST /v1/tasks 发送异步任务，model 填 elevenlabs/sound-effects-v2，input 里传 prompt 和 duration_seconds，按需加 prompt_influence、loop。接口立即返回 taskId，用 callback.url 接收结果，或轮询 GET /v1/tasks/:id。
一次可以生成多条音效吗？
一次请求只生成一条音频。需要多条时分别提交任务，每条按自己的时长计费。