Używaj ElevenLabs Sound Effect V2 przez Rivya Public API v1 z identyfikatorem modelu elevenlabs-sound-effect-v2, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIWejście tekstowe gotoweAudio

Identyfikator modelu API

elevenlabs-sound-effect-v2

Wejścia

text

Files API

Niewymagane dla żądania minimalnego

Kredyty bazowe

Możliwość

Audio

Rozliczenia

METERED

Limit promptu

5000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	elevenlabs-sound-effect-v2	Użyj elevenlabs-sound-effect-v2 jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 5000 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
loop	select	Nie	false	-	false, true	Pętla
duration_seconds	number	Nie	3	min 0.5 / max 22 / step 0.5	-	Czas trwania w sekundach
prompt_influence	number	Nie	0.3	min 0 / max 1 / step 0.05	-	Wpływ promptu
output_format	select	Nie	mp3_44100_128	-	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	Format wyjściowy

Żądanie minimalne

{
  "model": "elevenlabs-sound-effect-v2",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "loop": "false",
    "duration_seconds": 3,
    "prompt_influence": 0.3,
    "output_format": "mp3_44100_128"
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "id": "task_elevenlabs_sound_effect_v2_example",
  "status": "queued",
  "model": "elevenlabs-sound-effect-v2",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found