ElevenLabs
ElevenLabs Sound Effects
elevenlabs/sound-effects-v3
La serie de generación de efectos de sonido a partir de texto de ElevenLabs permite crear efectos de sonido describiendo acciones, escenas y atmósferas en lenguaje natural; se pueden definir la duración, el bucle sin interrupciones y el nivel de seguimiento del prompt, ideal para efectos de sonido de videojuegos, foley para previsiones cinematográficas y fondos ambientales
Probar elevenlabs/sound-effects-v3
Entrada
Creaciones
Ver todas las creacionesSalida
Precios
elevenlabs/sound-effects-v3 per second
| Precio unitario | $0.0029 |
|---|
Descripción general
Modelo de audio que genera efectos de sonido a partir de una descripción textual y permite especificar mediante prompts la acción, el entorno, la atmósfera y el modo de ejecución. La entrada incluye una descripción del sonido obligatoria y la duración, y además se puede elegir si el bucle es continuo y el grado de influencia del prompt. Es adecuado para equipos de desarrollo de videojuegos, postproducción audiovisual, creación de vídeos cortos y productos interactivos, que lo utilizan para obtener rápidamente recursos de efectos de sonido breves que se pueden incorporar directamente al proyecto.
Aspectos destacados
- Prompt de hasta 450 caracteres: describe la acción, la escena y la atmósfera en una sola frase, con un límite de 450 caracteres, suficiente para cubrir detalles sonoros relativamente finos.
- Duración configurable entre 0,5 y 30 segundos: en cada solicitud se especifican los segundos necesarios, lo que cubre las longitudes habituales de recursos, desde un clic breve hasta un sonido ambiental de medio minuto.
- Salida con bucle continuo: al activar el bucle continuo, el efecto de sonido generado enlaza su inicio y su final, lo que resulta adecuado para sonidos de fondo o mecánicos que deben reproducirse de forma continua.
- Grado de influencia del prompt ajustable: se controla la fidelidad con un valor de 0 a 1; con valores bajos el resultado es más variado y con valores altos se ajusta más a la descripción.
Capacidades
Generación de efectos de sonido a partir de una descripción textual: se envía una descripción del sonido con la acción, la escena, la atmósfera y el modo de ejecución, y el modelo genera el audio correspondiente; la descripción es obligatoria, no puede contener solo espacios en blanco y admite un máximo de 450 caracteres.
Duración personalizada del efecto de sonido: en cada solicitud se debe indicar una duración de 0,5 a 30 segundos; no se admite la duración automática, y tanto los efectos breves como los sonidos ambientales más largos se generan con el mismo conjunto de parámetros.
Opción de bucle continuo: al activar el bucle continuo se genera un efecto de sonido apto para reproducción continua; si se desactiva, se obtiene un efecto de sonido normal de una sola reproducción.
Ajuste de la fidelidad al prompt: mediante el parámetro de influencia del prompt, de 0 a 1, se equilibra la variabilidad y la fidelidad del resultado; 0 es más libre y 1 sigue más estrictamente la descripción, con un valor predeterminado de 0,3.
Casos de uso
- Equipos de videojuegos que crean efectos de sonido de respuesta interactiva: se introducen descripciones de acciones como el clic de un botón o la activación de una habilidad y se establece una duración breve para obtener recursos de audio que se pueden incorporar directamente a los eventos del juego.
- Postproducción audiovisual que complementa sonidos ambientales: se generan sonidos ambientales de una decena de segundos con descripciones de escena y atmósfera, que se colocan en la línea de tiempo de edición como fondo o como efecto de transición.
- Creadores de vídeos cortos que añaden toques sonoros: se describen efectos breves como transiciones o avisos según el contenido de la imagen y se limitan a uno o dos segundos para usarlos en la pista de efectos del software de edición.
- Diseño de productos interactivos con sonidos de fondo en bucle: se activa el bucle continuo y se indica la duración para generar sonidos mecánicos o ambientales reproducibles de forma continua, destinados a la retroalimentación sonora en demostraciones y prototipos.
Limitaciones y recomendaciones de selección
El prompt admite un máximo de 450 caracteres; si se supera, hay que resumirlo. En cada solicitud se debe indicar una duración de 0,5 a 30 segundos; no se admite la duración automática. Si la descripción es demasiado breve o el parámetro de influencia se inclina hacia la variación, el resultado puede diferir de lo esperado y es necesario probar varias veces y elegir la mejor opción. La salida es audio de efectos de sonido y no es adecuada para tareas que requieran una composición musical completa o canto vocal.
Preguntas frecuentes
Ver todas las preguntas →-
¿Cuál es la duración máxima de efecto de sonido que puede generar este modelo?
La versión actual y la generación anterior difieren en la duración máxima admitida. elevenlabs/sound-effects-v3 permite configurar de 0.5 a 30 segundos por generación, mientras que elevenlabs/sound-effects-v2 admite de 0.5 a 22 segundos; en ambos casos es obligatorio pasar duration_seconds explícitamente y no se admite la duración automática.
-
¿Cómo hago que el resultado generado se ajuste más a mi descripción?
Basta con aumentar prompt_influence, que controla el grado de seguimiento del prompt. Este valor va de 0 a 1 y su valor predeterminado es 0.3; cuanto más cerca de 1, más estrictamente se genera según la descripción literal, y cuanto más cerca de 0, más flexible y con más variaciones, adecuado para escenarios que requieren creatividad inesperada.
-
¿Cómo escribir indicaciones de efectos de sonido que den buenos resultados?
Se recomienda organizar la descripción en torno a cuatro elementos: «acción, entorno, atmósfera e interpretación», y redactarla en un párrafo coherente. Por ejemplo, primero indica qué acción produce el sonido, luego en qué escena ocurre y si la atmósfera general es tensa o silenciosa, y por último añade detalles de interpretación como el timbre o el ritmo; mantén todo el párrafo por debajo de 450 caracteres. La v3 sigue con mayor estabilidad las indicaciones que contienen varias instrucciones, por lo que desglosar bien los elementos es más eficaz que acumular sinónimos.
-
¿Cómo se generan los efectos de sonido en bucle?
Establece loop en true para generar un efecto de sonido que se reproduce en bucle sin cortes. El resultado no tiene puntos de inicio ni de fin perceptibles, lo que lo hace adecuado para sonidos ambientales, texturas de fondo y bases de fondo de larga duración; el valor predeterminado es false, es decir, se genera un efecto de sonido normal con inicio y fin.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: elevenlabs/sound-effects-v3
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para elevenlabs/sound-effects-v3 y la ruta default; consulta la tabla de parámetros a continuación.
loopbooleanOpcionalPredeterminado: falseControla si se genera un efecto de sonido reproducible en bucle sin cortes, valor booleano, por defecto false (sin bucle).
promptstringObligatoriominLength 1maxLength 450pattern \STexto que describe el efecto de sonido deseado; debe abarcar la acción, la escena, la atmósfera y el modo de ejecución, con una longitud máxima de 450 caracteres.
duration_secondsnumberObligatorioPredeterminado: 2min 0.5max 30Duración del efecto de sonido generado, en segundos; el rango va de 0.5 a 30, por defecto 2; no se admite duración automática.
prompt_influencenumberOpcionalPredeterminado: 0.3min 0max 1Controla el grado en que el resultado generado sigue el prompt: un valor de 0 es más aleatorio y variable, y un valor de 1 se ajusta más estrictamente a la descripción; por defecto 0.3.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "elevenlabs/sound-effects-v3",
input: {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": False,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Guía de uso
Cómo escribir prompts para ElevenLabs Sound Effects v3: organizar la descripción de efectos de sonido con material, acción y distancia
-
Guía de uso
Práctica de efectos de sonido en bucle con ElevenLabs Sound Effects v3: del ruido de fondo estable a la validación de la costura
-
Guía de uso
ElevenLabs Sound Effects v3 API: efectos de sonido de 30 segundos, bucles sin cortes y migración desde v2
Precio, parámetros, ejemplos de solicitud y cómo redactar los prompts, todo claro en un solo artículo
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
MiniMax Music 1.5 MiniMax $0.070 /canción -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 3 MiniMax $0.0026 /segundo -
MiniMax Music 2.6 MiniMax $0.210 /canción -
Lyria 3.5 Google $0.090 /canción -
ElevenLabs ElevenLabs $0.125 /1.000 caracteres -
Lyria 3 Pro Google $0.140 /canción -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
Mirelo SFX 2.0 Mirelo AI $0.021 /segundo


