ElevenLabs
ElevenLabs
elevenlabs/sound-effects-v2
Una familia de generación de voz y audio para desarrolladores que abarca la síntesis de voz a partir de texto, la voz conversacional y la generación de efectos de sonido y música
Probar elevenlabs/sound-effects-v2
Entrada
Creaciones
Ver todas las creacionesSalida
Precios
elevenlabs/sound-effects-v2 per second
| Precio unitario | $0.0029 |
|---|
Descripción general
Este es el modelo de generación de efectos de sonido de ElevenLabs, que se invoca a través de la interfaz unificada de HiAPI.ai: se introduce una descripción textual y se produce directamente un archivo de audio con el efecto de sonido. Está especializado en generar, a partir de una descripción, efectos de sonido ambientales y de foley breves y concretos, con una duración especificable entre 0.5 y 22 segundos y la opción de generar una versión con bucle continuo. Resulta adecuado para desarrolladores de videojuegos, productores de vídeos cortos y pódcasts que necesitan completar capas de efectos de sonido de forma masiva y controlable, así como para equipos de aplicaciones que integran la generación de efectos de sonido en sus propias canalizaciones de contenido.
Aspectos destacados
- Duración especificada con precisión por quien invoca: duration_seconds admite de 0.5 a 22 segundos y es obligatorio; no existe un modo de duración automática, por lo que la longitud de salida es predecible y facilita la alineación de pistas.
- Ajuste cuantificable de la fidelidad al prompt: prompt_influence toma valores de 0 a 1; los valores bajos producen salidas más libres y variadas, y los altos se ajustan más a la descripción, lo que permite alternar entre la exploración creativa y la reproducción precisa.
- Generación de efectos de sonido con bucle continuo: al activar el interruptor loop, la salida produce un sonido que se repite de forma fluida, lo que evita el empalme y los fundidos de entrada y salida en la posproducción.
Capacidades
Generación de efectos de sonido a partir de una descripción textual: se describe el sonido con un texto de no más de 450 caracteres y el modelo genera el audio del efecto correspondiente, lo que permite convertir rápidamente una descripción creativa en material sonoro utilizable.
Control de bucle y duración: los parámetros loop y duration_seconds controlan la forma de la salida, de modo que se puede producir directamente un audio apto para la reproducción en bucle en videojuegos o para fragmentos con una línea de tiempo fija.
Ajuste de la aleatoriedad de la generación: prompt_influence controla el grado de ajuste a la descripción; una misma descripción puede reproducirse de forma estable o generarse varias veces para elegir entre distintas variantes.
Casos de uso
- Desarrolladores de videojuegos que completan sonidos ambientales en bucle: generan sonidos ambientales con bucle continuo a partir de una descripción de la escena y el interruptor loop, para usarlos como fondo y atmósfera de los niveles.
- Productores de vídeos cortos y pódcasts que crean foley: a partir de la descripción de la imagen y con una duración precisa, obtienen efectos de sonido breves de transiciones, acciones, etc., que se superponen directamente en la línea de tiempo de montaje.
- Equipos de aplicaciones que generan recursos de efectos de sonido de forma masiva: invocan la interfaz de forma masiva según el texto para escribir los recursos de audio generados en una biblioteca de materiales o en una canalización de producción de contenido.
Limitaciones y recomendaciones de selección
Solo genera audio; no produce imágenes, ilustraciones ni bandas sonoras completas. La duración máxima por invocación es de 22 segundos, por lo que los paisajes sonoros largos requieren concatenar fragmentos. La descripción está limitada a 450 caracteres, y el resultado de los textos demasiado abstractos depende del compromiso que se logre al ajustar prompt_influence. Cuando se necesiten voces, doblaje de diálogos o melodías musicales completas, conviene usar modelos de síntesis de voz o de generación de música; tampoco es adecuado para escenarios que requieran sonidos de fondo continuos de larga duración.
Preguntas frecuentes
Ver todas las preguntas →-
¿Qué es Turbo 2.5?
Modelo de texto a voz de baja latencia de ElevenLabs, adecuado para asistentes de voz, anuncios de notificaciones y doblaje a gran escala.
-
¿Cómo se invoca?
Envíe a POST /v1/tasks los parámetros model (elevenlabs/text-to-speech-turbo-2-5) e input, y luego consulte el resultado con taskId o configure un callback.
-
¿Cómo se factura?
Se factura según el número de caracteres de input.text, por cada 1,000 caracteres; el precio unitario en tiempo real se rige por la sección de precios de esta página.
-
¿previous_text y next_text tienen costo?
No tienen costo. Solo proporcionan contexto para la síntesis por segmentos, de modo que la entonación fluya de forma natural.
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-v2
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para elevenlabs/sound-effects-v2 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 interrupciones. Valor booleano, por defecto false, es decir, se genera un efecto de sonido normal no bucle.
promptstringObligatoriominLength 1maxLength 450pattern \SDescribe el contenido del efecto de sonido que se va a generar, con un máximo de 450 caracteres.
duration_secondsnumberObligatorioPredeterminado: 2min 0.5max 22Duración del efecto de sonido generado (segundos), con un rango de 0.5 a 22 segundos; este parámetro es obligatorio, no existe opción de duración automática y el valor predeterminado es 2 segundos.
prompt_influencenumberOpcionalPredeterminado: 0.3min 0max 1Controla el grado de seguimiento del prompt en el resultado generado: 0 indica mayor variabilidad y 1 indica una generación más estricta según la descripción. Tipo numérico, 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-v2",
"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-v2",
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-v2",
"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 →-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
MiniMax Music 1.5 MiniMax $0.070 /canción -
Mirelo SFX 2.0 Mirelo AI $0.021 /segundo -
MiniMax Music 2.6 MiniMax $0.210 /canción -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 3 MiniMax $0.0026 /segundo -
Lyria 3 Pro Google $0.140 /canción -
ElevenLabs ElevenLabs $0.0029 /segundo -
Gemini 3.1 Flash TTS Google -- -
Lyria 3.5 Google $0.090 /canción -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres



