Introducción
Describe lo que se oye, dónde ocurre y en qué orden. ElevenLabs Sound Effects V3 devuelve un clip de audio con la duración que solicites.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
| Editor | ElevenLabs |
| Fecha de lanzamiento | 29 de octubre de 2026 |
| Modalidad | Audio |
| Tarea | Texto a efectos de sonido |
| Entrada requerida | Prompt de texto no vacío que describa sonidos, entorno y orden de eventos |
| Duración solicitada | De 0.5 a 30 segundos; 5 segundos de forma predeterminada |
| Control de repetición | Booleano; desactivado de forma predeterminada |
| Influencia del prompt | De 0 a 1; 0.3 de forma predeterminada |
| Clips de ejemplo | Dos archivos MP3 de 5 segundos, con repetición desactivada y activada, respectivamente |
| Base de facturación | Por cada segundo iniciado de la duración solicitada; mínimo de un segundo; las solicitudes fallidas no se cobran |
Funciones y aspectos destacados
Un sonido de puerto sin bucle
La solicitud del puerto describe gaviotas sobre pequeñas olas en un muelle tranquilo. Devolvió un MP3 de 5 segundos con la influencia predeterminada de 0.3 y la repetición desactivada. Escúchalo junto con tu escena costera para evaluar el equilibrio que buscas entre aves y agua.
Lluvia sobre una superficie definida
La solicitud de lluvia combina una descripción breve de una superficie resonante con la repetición activada. Devolvió un MP3 de 5 segundos. Aplica ese enfoque a una textura de fondo sostenida y escucha la unión del bucle para comprobar cómo encaja en la escena.
Revisa el sonido sin perder la referencia
La duración, la repetición y la fidelidad al prompt responden a decisiones diferentes. Mantén la descripción al comparar un control y guarda los ajustes con el clip recibido para identificar qué versión corresponde a la edición.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | El sonido, su entorno y el orden de los eventos. mínimo 1 caracteres |
duration_seconds | No | Duración de 0.5 a 30 segundos, 5 por defecto. Se cobra cada segundo iniciado. |
loop | No | Solicita un clip pensado para repetirse sin cortes. Desactivado por defecto. Valor predeterminado: |
prompt_influence | No | De 0 a 1. Los valores altos siguen más de cerca el prompt. |
Precios
$0.0024 / segundo
ElevenLabs Sound Effects V3 se cobra por segundo iniciado de la duración solicitada, con un mínimo de un segundo. Las solicitudes fallidas no se cobran.
Casos de uso
Ambiente portuario para una edición de locación
Usa el prompt del puerto como punto de partida para una escena junto al agua. Combina gaviotas, pequeñas olas y un muelle en una descripción. Nuestra solicitud devolvió un MP3 de 5 segundos con la repetición desactivada.
Textura de lluvia bajo una escena interior
El ejemplo del techo de lámina da una superficie concreta al sonido del clima. Nuestra solicitud devolvió un MP3 de 5 segundos con la repetición activada. Prueba esa combinación de sonido sostenido y material definido al preparar audio de fondo para reproducirlo en bucle.
Sonidos de materiales para tomas de producto
Para una edición de producto, describe un pestillo, un cajón deslizante o un panel metálico mediante su acción y material. Incluye el espacio y cualquier traqueteo o decaimiento posterior para indicar cómo debe sonar el objeto en la escena.
Secuencias de eventos para prototipos de juegos
Describe cómo se abre la puerta de un taller y luego un carrito rueda por el piso. Elige una duración que deje espacio para ambos eventos. El endpoint acepta descripciones ordenadas de sonidos; compara el resultado con los tiempos del juego antes de usarlo.
Guía de prompts y consejos prácticos
Describe un evento audible
Indica qué produce el sonido, el material involucrado y el espacio que lo rodea. Si hay una secuencia, describe los eventos en el orden en que quieres escucharlos.
Elige una duración útil
Configura entre 0.5 y 30 segundos, con 5 segundos como valor predeterminado. Deja espacio para la acción y su decaimiento, y revisa el precio mostrado para la duración solicitada.
Ajusta la repetición y la fidelidad
Activa la repetición para una ambientación o textura recurrente. Comienza con la influencia predeterminada de 0.3 y modifícala al comparar cuánto sigue el resultado tu indicación.
Escucha en el contexto de uso
Compara el clip recibido con la indicación escrita y la escena que acompaña. Si lo usarás en bucle, escucha la unión del final con el inicio antes de extenderlo por una edición más larga.
Crea un efecto sonoro a partir de una indicación escrita
Convierte la descripción de un evento audible en un efecto corto para una edición, una escena de juego o una producción de audio. Nombra la fuente, ubícala en un entorno y explica qué sucede con el paso del tiempo. Elige una duración de 0.5 a 30 segundos, solicita repetición cuando el sonido deba continuar en bucle y ajusta la influencia del prompt para explorar la fidelidad a la indicación.
Según ElevenLabs, SFX V3 sigue con mayor fidelidad que V2 las instrucciones que incluyen varios sonidos. En una secuencia, escribe los eventos en el orden en que quieres escucharlos y deja espacio para que el sonido final se desvanezca.
Elige los ajustes de la solicitud
Se requiere un prompt no vacío. La duración, la repetición y la influencia tienen valores predeterminados, así que puedes comenzar con una indicación escrita y modificar los controles a medida que desarrollas la escena.
| Parámetro | Tipo | Valor admitido | Predeterminado | Función |
|---|---|---|---|---|
prompt | Cadena | Texto no vacío | Obligatorio | Describir el sonido, el entorno y el orden de los eventos. |
duration_seconds | Número | De 0.5 a 30 | 5 | Fijar la duración solicitada en segundos. |
loop | Booleano | true o false | false | Solicitar un clip diseñado para repetirse con fluidez. |
prompt_influence | Número | De 0 a 1 | 0.3 | Controlar cuánto sigue el resultado la descripción. |
Ajusta la duración a la acción
El cierre de un pestillo y la lluvia continua sobre un techo necesitan ritmos distintos. Reserva tiempo para la acción y su final, y compara el resultado con el espacio disponible en tu edición. Enfoca un efecto corto en pocos sonidos en lugar de comprimir una escena completa. La duración predeterminada es de 5 segundos y puede ajustarse entre 0.5 y 30 segundos.
Separa la repetición de la duración
Activa loop para una textura que deba repetirse, como lluvia constante o el zumbido de una ventilación. El ajuste solicita un clip apto para repetición dentro de la duración elegida. Escucha varias repeticiones en tu editor y presta atención a la transición del final al inicio y a los cambios de nivel que distraigan. Deja la repetición desactivada para efectos con un inicio y un final definidos.
Compara la fidelidad sin reescribir la indicación
La influencia va de 0 a 1, con 0.3 como valor predeterminado. Los valores más altos solicitan mayor fidelidad al prompt. Al explorar este ajuste, conserva la descripción, la duración y el estado de repetición para concentrar la escucha en el cambio solicitado. Guarda los ajustes elegidos junto con el clip para futuras revisiones.
Escribe indicaciones que puedas evaluar de oído
Comienza por la fuente y su acción: un pestillo de acero se cierra con un clic, un carrito rueda sobre concreto o la lluvia golpea un techo de lámina. Agrega el entorno cuando afecte el carácter deseado. Un taller tranquilo da a un sonido mecánico un contexto distinto al de un puerto abierto. Vincula los detalles de la descripción con lo que debe escuchar el oyente.
Facilita el seguimiento de la secuencia
Conecta las acciones con palabras como «después» y describe cómo termina la secuencia. Por ejemplo, se abre una puerta de taller, un carrito rueda por el piso y después se detiene. Así tienes un orden concreto para contrastarlo con el clip recibido. Si la secuencia se siente saturada, simplifica la indicación o elige una duración mayor dentro del rango admitido.
ElevenLabs señala que el número exacto de repeticiones puede no respetarse. Si un efecto depende de una cantidad precisa, escucha el resultado y ajusta su ubicación durante la edición.
Dale una fuente clara al ambiente
Para un fondo repetitivo, identifica un sonido sostenido y el material o espacio que le da carácter. «Lluvia constante sobre un techo de lámina» concentra la atención en una textura climática y una superficie. Un ventilador que zumba en un taller de reparación también aporta una fuente estable. Activa la repetición con el control y revisa el clip en bucle debajo de la escena donde se usará.
Escucha los ejemplos del puerto y la lluvia
Nuestras solicitudes del 18 de noviembre de 2026 devolvieron dos archivos MP3 de 5 segundos. Ambas usaron una influencia del prompt de 0.3, con distintos ajustes de repetición para las dos indicaciones.
Gaviotas y olas junto a un muelle
«Las gaviotas llaman sobre un puerto tranquilo mientras pequeñas olas golpean suavemente el muelle» devolvió un MP3 de 5 segundos con la repetición desactivada. El prompt ubica dos fuentes sonoras en el mismo entorno. Úsalo como punto de partida para un efecto junto al agua y escúchalo con tu escena para decidir cómo integrar las aves y el agua en la edición.
Lluvia sobre un techo de lámina
«Lluvia constante sobre un techo de lámina» devolvió un MP3 de 5 segundos con la repetición activada. La indicación breve nombra el evento continuo y su superficie. Reproduce el clip en bucle al preparar un fondo más largo y evalúa la unión en el contexto del audio que lo rodea.
Calcula el presupuesto según la duración solicitada
Consulta el precio mostrado en esta página al planificar una solicitud. La facturación cuenta cada segundo iniciado de la duración solicitada, con un mínimo de un segundo. Las solicitudes fallidas no se cobran. Elige la duración antes de enviar y mantenla al comparar revisiones del prompt para que cada propuesta cubra el mismo espacio en la edición.
Explora familias de audio relacionadas
Considera foley/v1 para un proyecto de Foley, seed-audio/1.0 para explorar otra familia de audio o elevenlabs/music-v2.5 para un proyecto musical. Contrasta las entradas admitidas y los ejemplos de cada familia con tu tarea. Para este endpoint, prepara una descripción escrita del sonido y configura la solicitud mediante duración, repetición e influencia.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/sound-effects-v3/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.






