ElevenLabs
ElevenLabs Sound Effects
elevenlabs/sound-effects-v3
Série de efeitos sonoros gerados por texto da ElevenLabs: basta descrever ações, cenas e atmosfera em linguagem natural para gerar efeitos sonoros, com possibilidade de definir a duração, o loop contínuo e o grau de aderência ao prompt, ideal para efeitos sonoros de jogos, foley para pré-visualização de cinema e vídeo e camadas de ambiência
Experimentar elevenlabs/sound-effects-v3
Entrada
Criações
Ver todas as criaçõesSaída
Preços
elevenlabs/sound-effects-v3 per second
| Preço unitário | $0.0029 |
|---|
Visão geral
Modelo de áudio que gera efeitos sonoros a partir de descrições textuais, com suporte a prompts que especificam ações, ambientes, atmosferas e formas de expressão. As entradas incluem uma descrição sonora obrigatória e a duração, além de opções para loop contínuo e grau de influência do prompt. Ideal para desenvolvimento de jogos, pós-produção de cinema e TV, produção de vídeos curtos e equipes de produtos interativos, permitindo obter rapidamente efeitos sonoros curtos prontos para uso direto em projetos.
Destaques principais
- Prompt de até 450 caracteres — descreva em uma frase a ação, a cena e a atmosfera, com limite de 450 caracteres, espaço suficiente para cobrir detalhes sonoros mais sutis.
- Duração ajustável entre 0,5 e 30 segundos — especifique a quantidade de segundos a cada requisição, cobrindo desde cliques curtos até sons ambiente de meio minuto, os comprimentos comuns de material.
- Suporte a saída em loop contínuo — ao ativar o loop contínuo, o efeito sonoro gerado tem início e fim que se conectam, ideal para fundos ou sons mecânicos que precisam tocar continuamente.
- Grau de influência do prompt ajustável — use um valor de 0 a 1 para controlar a aderência; valores baixos geram resultados mais variados, valores altos ficam mais próximos da descrição.
Descrição das capacidades
Geração de efeitos sonoros a partir de descrição textual: envie uma descrição sonora de ação, cena, atmosfera e forma de expressão, e o modelo gera o áudio correspondente; a descrição é obrigatória, não pode conter apenas espaços em branco e tem no máximo 450 caracteres.
Duração personalizada do efeito sonoro: a cada requisição é obrigatório especificar uma duração de 0,5 a 30 segundos; não há duração automática, e efeitos curtos e sons ambiente mais longos usam o mesmo conjunto de parâmetros.
Opção de loop contínuo: ao ativar o loop contínuo, é gerado um efeito sonoro adequado para reprodução contínua; ao desativar, a saída é um efeito sonoro único comum.
Ajuste de aderência ao prompt: por meio do parâmetro de influência do prompt de 0 a 1, equilibram-se a variabilidade e a aderência do resultado; 0 é mais livre e 1 segue mais estritamente a descrição, com valor padrão de 0,3.
Cenários de aplicação
- Equipes de jogos criando efeitos sonoros de feedback interativo — insira descrições de ações como cliques em botões e disparo de habilidades com duração curta para obter materiais de áudio prontos para eventos do jogo.
- Pós-produção de cinema e TV complementando sons ambiente — use descrições de cena e atmosfera para gerar sons ambiente de cerca de dez segundos e inseri-los na linha do tempo da edição como base de fundo ou efeito de transição.
- Criadores de vídeos curtos adicionando toques sonoros — descreva efeitos curtos de transição e alerta conforme o conteúdo da imagem, com duração de um ou dois segundos, para usar em faixas de efeitos no software de edição.
- Design de produtos interativos com sons de fundo em loop — ative o loop contínuo e defina a duração para gerar sons mecânicos ou ambientes reproduzíveis continuamente, usados como feedback sonoro em demonstrações e protótipos.
Limitações e recomendações de escolha
O prompt tem no máximo 450 caracteres; se exceder, é preciso resumir. A cada requisição é obrigatório especificar uma duração de 0,5 a 30 segundos; não há duração automática. Se a descrição for muito curta ou se o parâmetro de influência tender à variação, o resultado pode diferir do esperado, sendo necessário tentar várias vezes e escolher o melhor. A saída é um áudio de efeito sonoro, não sendo adequada para tarefas que exigem arranjo musical completo ou canto vocal.
Perguntas frequentes
Ver todas as perguntas →-
Qual é a duração máxima de efeito sonoro que este modelo pode gerar?
A versão atual difere da geração anterior no tempo máximo suportado. O elevenlabs/sound-effects-v3 permite definir de 0,5 a 30 segundos por geração, enquanto o elevenlabs/sound-effects-v2 permite de 0,5 a 22 segundos; em ambos é obrigatório passar explicitamente duration_seconds, não há suporte a duração automática.
-
Como fazer o resultado gerado ficar mais próximo da minha descrição?
Basta aumentar o prompt_influence, que controla o grau de aderência ao prompt. Esse valor varia de 0 a 1, com padrão 0.3; quanto mais próximo de 1, mais estritamente a geração segue a descrição literal, e quanto mais próximo de 0, mais livre e com mais variações, ideal para cenários que exigem criatividade inesperada.
-
Como escrever prompts de efeitos sonoros com bons resultados?
Recomenda-se organizar em quatro elementos: "ação, ambiente, atmosfera e performance", escrevendo tudo em um parágrafo contínuo. Por exemplo, primeiro descreva qual ação gera o som, depois em que cenário isso ocorre, se a atmosfera geral é tensa ou silenciosa, e por fim acrescente detalhes de performance como timbre ou ritmo; mantenha o parágrafo inteiro dentro de 450 caracteres. O v3 segue prompts com múltiplas instruções com mais estabilidade; separar bem os elementos é mais eficaz do que empilhar sinônimos.
-
Como gerar um efeito sonoro em loop?
Defina loop como true para gerar um efeito sonoro que pode ser reproduzido em loop sem emendas. O resultado não contém pontos de início e fim perceptíveis, sendo adequado para sons ambientes, texturas sonoras e fundos de longa duração; o valor padrão é false, ou seja, gera um efeito sonoro comum com início e fim.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.
Idempotency-KeystringOpcionalChave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.
Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.
Corpo
modelstringObrigatórioValor fixo atual: elevenlabs/sound-effects-v3
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para elevenlabs/sound-effects-v3 e a rota default — veja a tabela de parâmetros abaixo.
loopbooleanOpcionalPadrão: falseControla se é gerado um efeito sonoro que pode ser reproduzido em loop contínuo; valor booleano, predefinição false (sem loop).
promptstringObrigatóriominLength 1maxLength 450pattern \STexto que descreve o efeito sonoro pretendido, devendo abranger a ação, a cena, a atmosfera e o modo de representação, com um máximo de 450 caracteres.
duration_secondsnumberObrigatórioPadrão: 2min 0.5max 30Duração do efeito sonoro gerado, em segundos, com um intervalo de 0,5 a 30 e predefinição 2; não suporta duração automática.
prompt_influencenumberOpcionalPadrão: 0.3min 0max 1Controla o grau de adesão do resultado gerado ao prompt: o valor 0 é mais aleatório e variável, o valor 1 é mais rigorosamente fiel à descrição, com predefinição 0,3.
callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.
urlstringObrigatórioObrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.
whenstringOpcionalPadrão: "final"Atualmente só há suporte a final — notifica tanto em success quanto em fail.
finalstoragestringOpcionalPadrão: "temp"Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.
temppersistentExemplos de requisição
# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
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"
} Obter detalhes da tarefa
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
queued Na fila, ainda não iniciada.
handling Em processamento.
archiving Processamento concluído, preparando artefatos.
success Terminal: concluído, artefatos disponíveis (retorna output).
fail Terminal: falha (retorna error).
Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.
creatednumberObrigatórioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos Unix do estado terminal; 0 enquanto não terminal.
outputarrayOpcional
Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).
Array [ object ]
Itens do array
urlstringObrigatórioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescrição do erro.
Exemplos de resposta
Sucesso
{
"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
}
]
}
} Em processamento (não final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Falhou
{
"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"
}
}
} Artigos
Ver todos os artigos →-
Guia de uso
Como escrever prompts no ElevenLabs Sound Effects v3: organizar a descrição de efeitos sonoros por material, ação e distância
-
Guia de uso
ElevenLabs Sound Effects v3 API: efeitos sonoros de 30 segundos, loop contínuo e migração do v2
Preço, parâmetros, exemplos de requisição e como escrever prompts, tudo em um só artigo
-
Guia de uso
Prática de efeitos sonoros em loop com ElevenLabs Sound Effects v3: do ruído de fundo estável à validação da emenda
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
MiniMax Music 1.5 MiniMax $0.070 /música -
Lyria 3.5 Google $0.090 /música -
Lyria 3 Pro Google $0.140 /música -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 3 MiniMax $0.0026 /segundo -
MiniMax Music 2.6 MiniMax $0.210 /música -
Mirelo SFX 2.0 Mirelo AI $0.021 /segundo -
ElevenLabs ElevenLabs $0.125 /1.000 caracteres


