Sound effect generator API

A sound effect from a description, as an MP3 of 0.5 to 30 seconds, or one that loops without a seam (loop: true) for ambience and engines. Without seconds the model picks the length; the job is held at 30 s and charged for the length it came back. Search the free library first (search_assets, type audio).

Tool id sound-effect-generator on the REST API (POST https://3dvalley.com/api/v1/jobs); MCP tool generate_sound_effect on https://3dvalley.com/mcp. Paid in credits (1 credit = $0.01), taken when the job starts and given back if it fails. The general rules (keys, idempotency, waiting, webhooks) are in the API docs.

The free CC0 library holds sound effects already: GET /api/v1/assets?type=audio&q=door+creak (MCP: search_assets with type: "audio") before paying for one.

Models and prices

Model	Name	Price	Time	What it is
elevenlabs-sfx (default)	ElevenLabs Sound Effects	1 credit per 2 seconds	about 8 s	A sound effect from a description, 0.5 to 30 seconds, or one that loops without a seam.

Input

Field	Required
prompt	yes	The sound: "heavy wooden door creaking open, then slamming shut". Up to 450 characters.

Options

Option	Type	Values
seconds	number	from 0.5 to 30	The length in seconds. Without it the model picks one.
loop	boolean	true or false	Make it loop without a seam. Default false.
prompt_influence	number	from 0 to 1	0 to 1: how closely it keeps to the words; higher varies less. The default is 0.3.

Output

Files: audio. audio is the MP3 (128 kbit/s, 44.1 kHz). stats.seconds is its length. A job without seconds is held at the longest and charged for the length it came back (credits.charged).

Example

curl -X POST https://3dvalley.com/api/v1/jobs \
  -H "Authorization: Bearer $THREEDVALLEY_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=50" \
  -H "Content-Type: application/json" \
  -d '{"tool":"sound-effect-generator","input":{"prompt":"heavy wooden door creaking open, then slamming shut"},"options":{"seconds":4}}'

From an MCP client:

generate_sound_effect({"prompt":"heavy wooden door creaking open, then slamming shut","seconds":4})

Limits

• max_prompt: 450
• min_seconds: 0.5
• max_seconds: 30