Ana içeriğe geç
YeniSeedance 2.5 yayında→
ModelRunner
elevenlabs avatarı

ElevenLabs Sound Effects V2 API

elevenlabs/sound-effects

Metin prompt’undan ses efektleri, Foley ve ortam sesi üretin; sonuç barındırılan bir MP3 olarak döner.

üretilen ses için saniye başına 0.002
OpenAPI

Model girdisi

Input

The text describing the sound effect to generate.

Length of the generated effect in seconds (0.5–22). Leave unset to let the model choose the optimal duration from the prompt.

Min: 0 - Max: 1

How closely the output follows the prompt (0–1). Higher is more literal and on-prompt; lower allows more variation.

Output audio format, named as codec_samplerate_bitrate.

Generate a sound effect that loops smoothly, for seamless ambience and beds.

You need to be logged in to run this model and view results.
Log in

Model çıktısı

Output

Loading
Generated in 4.702 seconds
Logs (1 lines)

Örnek istekler

Örnekler

ElevenLabs Sound Effects V2 API

ElevenLabs Sound Effects V2 is a sound AI model by elevenlabs. On ModelRunner it runs through a REST API or via MCP from any AI assistant, at $0.002 per second of audio.

POST https://queue.modelrunner.run/elevenlabs/sound-effects

cURL

# Submit a request to the queue. Input fields go at the top level of the
# body. The optional reserved "metadata" object holds your own flat string
# tags — stored on the request, never sent to the model; filter later with
# GET https://queue.modelrunner.run/requests?metadata=<url-encoded JSON>.
curl -X POST https://queue.modelrunner.run/elevenlabs/sound-effects \
  -H "Authorization: Key $MRUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "loop": false,
    "text": "Old grandfather clock ticking steadily, then chiming three times",
    "output_format": "mp3_44100_128",
    "duration_seconds": 8,
    "prompt_influence": 0.3,
    "metadata": {
      "project": "my-project"
    }
  }'
# → { "request_id": "...", "status_url": "...", "response_url": "..." }

# Poll status_url until "COMPLETED", then fetch the result
curl "https://queue.modelrunner.run/elevenlabs/sound-effects/requests/$REQUEST_ID/status" \
  -H "Authorization: Key $MRUN_API_KEY"
curl "https://queue.modelrunner.run/elevenlabs/sound-effects/requests/$REQUEST_ID" \
  -H "Authorization: Key $MRUN_API_KEY"

JavaScript

import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("elevenlabs/sound-effects", {
  input: {
    "loop": false,
    "text": "Old grandfather clock ticking steadily, then chiming three times",
    "output_format": "mp3_44100_128",
    "duration_seconds": 8,
    "prompt_influence": 0.3
  },
});
console.log(result);

Python

import os
import requests

headers = {"Authorization": f"Key {os.environ['MRUN_API_KEY']}"}

submitted = requests.post(
    "https://queue.modelrunner.run/elevenlabs/sound-effects",
    headers=headers,
    json={
      "loop": false,
      "text": "Old grandfather clock ticking steadily, then chiming three times",
      "output_format": "mp3_44100_128",
      "duration_seconds": 8,
      "prompt_influence": 0.3
    },
).json()

# Poll submitted["status_url"] until "COMPLETED", then:
result = requests.get(submitted["response_url"], headers=headers).json()

Input parameters

Input parameters of ElevenLabs Sound Effects V2
NameTypeRequiredDescription
textstringyesThe text describing the sound effect to generate.
duration_secondsnumbernoLength of the generated effect in seconds (0.5–22). Leave unset to let the model choose the optimal duration from the prompt.
prompt_influencenumbernoHow closely the output follows the prompt (0–1). Higher is more literal and on-prompt; lower allows more variation. Default: 0.3.
output_formatenumnoOutput audio format, named as codec_samplerate_bitrate. One of: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192, pcm_8000, pcm_16000, pcm_22050, pcm_24000, pcm_44100, pcm_48000, ulaw_8000, alaw_8000, opus_48000_32, opus_48000_64, opus_48000_96, opus_48000_128, opus_48000_192. Default: "mp3_44100_128".
loopbooleannoGenerate a sound effect that loops smoothly, for seamless ambience and beds. Default: false.

Machine-readable: OpenAPI schema · llms.txt

Use ElevenLabs Sound Effects V2 from Claude & Cursor (MCP)

Point Claude Code, Claude Desktop, Cursor, or any MCP client at the ModelRunner MCP server and ElevenLabs Sound Effects V2 becomes a tool your assistant can call directly — it authorizes via OAuth (no API key in config) and runs this model with the run_model tool using the endpoint elevenlabs/sound-effects.

MCP client config (Claude Desktop, Cursor)

{
  "mcpServers": {
    "modelrunner": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp

Then ask your assistant, for example: “Run elevenlabs/sound-effects on ModelRunner to generate sound”. MCP setup guide.

Model Detayları

Model Detayları

ElevenLabs Sound Effects, kısa bir metin prompt’unu bir ses efektine dönüştürür ve barındırılan bir MP3 olarak döndürür. Duymak istediğiniz sesi tarif edin — tek bir Foley vuruşu, bir ortam sesi katmanı, bir arayüz bip sesi, sinematik bir whoosh ya da bir yaratık kükremesi — model de ona uyan sesi üretir. Güçlü yanı, kayıt almadan ya da sample kullanmadan, düz bir dille yazılmış açıklamadan doğrudan kullanılabilir ses tasarımına geçmesidir; klip uzunluğunu ve sonucun prompt’unuza ne kadar sıkı bağlı kalacağını isteğe bağlı olarak ayarlayabilir, kesintisiz ortam sesleri ve katmanlar için loop modunu kullanabilirsiniz.

## En uygun olduğu işler - Metin açıklamasından Foley ve tek seferlik efektler (ayak sesleri, darbeler, çarpan kapılar, kırılan cam) - Ortam sesi katmanları ve arka plan sesleri (yağmur, orman, kalabalık, şehir trafiği) — kesintisiz döngü için `loop` değerini true yapın - Arayüz ve oyun sesleri (bildirimler, coin’ler, power-up’lar, geçişler) - Sinematik ses tasarımı öğeleri (riser’lar, whoosh’lar, stinger’lar, braam’lar) - Elinizde kayıt yokken hızlıca geçici ya da nihai SFX elde etmek

## Şu durumlarda başka bir model seçin - Metinden konuşma ya da anlatım gerekiyorsa — bir text-to-speech modeli kullanın - Melodisi, ritmi ve şarkı yapısı olan müzik istiyorsanız — bir müzik üretim modeli kullanın - Mevcut bir kayıttaki konuşmayı temizlemeniz ya da ayrıştırmanız gerekiyorsa — bir ses izolasyonu modeli kullanın

## İpuçları - Prompt’u soyut değil, somut ve sese odaklı tutun ("ağır ahşap kapı gıcırdayarak açılıyor, sonra çarpıyor") - Modelin doğal uzunluğu prompt’unuza göre seçmesi için `duration_seconds` alanını boş bırakın; yalnızca tam bir klip uzunluğu gerektiğinde ayarlayın (0.5–22 saniye) - Prompt’a birebir sadık bir sonuç için `prompt_influence` değerini 1’e doğru yükseltin; daha fazla çeşitlilik ve yaratıcı yorum için 0’a doğru düşürün (varsayılan 0.3) - Art arda ekleyerek kullanacağınız ortam ve arka plan sesleri için `loop` değerini true yapın; böylece başlangıç ve bitiş temiz biçimde birleşir - Metin prompt’u en fazla 450 karakter olabilir — bir sahne senaryosu değil, istediğiniz tek efekti tarif edin

## Sınırlamalar - Yalnızca konuşma dışı ses üretir; anlaşılır bir sözlü diyalog üretmez - İstek başına en uzun klip süresi 22 saniyedir

ModelRunner JavaScript client ile çalıştırmak için: ```js import { modelrunner } from "@modelrunner/client";

const result = await modelrunner.subscribe("elevenlabs/sound-effects", { input: { text: "heavy wooden door creaking open, then slamming shut", duration_seconds: 4, prompt_influence: 0.3, loop: false, }, }); ```