Sfx Elevenlabs

Step 1: API Key Check

if [ -z "$ELEVENLABS_API_KEY" ]; then
  echo "❌ ELEVENLABS_API_KEY not set."
  echo ""
  echo "Get your key at: https://elevenlabs.io/app/settings/api-keys"
  echo "Then set it:     export ELEVENLABS_API_KEY=sk_..."
  echo "Or add to:       ~/.claude/.env"
  exit 1
fi

Step 2: Build Request

PROMPT="$1"
DURATION="${DURATION:-null}"          # null = auto-detect
INFLUENCE="${INFLUENCE:-0.3}"
LOOP="${LOOP:-false}"
MODEL="eleven_text_to_sound_v2"
FORMAT="${FORMAT:-mp3_44100_128}"
OUTPUT="${OUTPUT_PATH:-/tmp/sfx-elevenlabs-$(date +%s).mp3}"

Step 3: Call the API

curl -s -X POST "https://api.elevenlabs.io/v1/sound-generation?output_format=${FORMAT}" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(python3 -c "
import json, sys
data = {
    'text': '''$PROMPT''',
    'model_id': '$MODEL',
    'prompt_influence': $INFLUENCE,
    'loop': $LOOP
}
dur = $DURATION
if dur != 'null' and dur is not None:
    data['duration_seconds'] = float(dur)
print(json.dumps(data))
")" \
  --output "$OUTPUT"

Step 4: Verify Output

if [ ! -f "$OUTPUT" ] || [ "$(wc -c < "$OUTPUT")" -lt 100 ]; then
  echo "❌ Sound effect generation failed. Response:"
  cat "$OUTPUT" 2>/dev/null
  exit 1
fi

DURATION_ACTUAL=$(ffprobe -v quiet -show_entries format=duration -of csv=p=0 "$OUTPUT" 2>/dev/null | cut -d. -f1)
SIZE=$(wc -c < "$OUTPUT" | tr -d ' ')

Step 5: Report

✅ Sound effect generated
   Prompt:    <first 80 chars>...
   Model:     eleven_text_to_sound_v2
   Duration:  <N>s
   Loop:      <true|false>
   Influence: <0-1>
   Size:      <N> KB
   Output:    <output path>
   Play:      open <output path>

Test Command

# Quick test — generates a 2-second click sound
export $(grep ELEVENLABS_API_KEY ~/.claude/.env)
curl -s -X POST "https://api.elevenlabs.io/v1/sound-generation" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "short UI button click", "duration_seconds": 1, "prompt_influence": 0.5}' \
  --output /tmp/sfx-test.mp3 && \
echo "✅ API key works" && open /tmp/sfx-test.mp3

Environment Variables

Constraints

• Duration: 0.5–30 seconds per generation
• Looping: only supported on v2 model (eleven_text_to_sound_v2)
• Prompt quality matters: be specific about the sound, its environment, and character

Example Prompts

Integration with Other Skills

• generate-video — SFX for transitions, intros, outros in Remotion videos
• music-elevenlabs — combine SFX with background music for full audio design
• audio-mix — layer SFX over voice and music tracks

See Also

• ElevenLabs Sound Effects API
• ElevenLabs Sound Effects overview