# Suno SFX V5 - Core.Today AI API

> Suno V5 sound effect generation. Creates two short sound effect variants from a text description, with optional loop mode, tempo, and musical key controls. Ideal for UI sounds, game audio, and video foley.

- **Provider**: Suno
- **Model ID**: suno/sfx-v5
- **Category**: Audio & TTS
- **Credits**: 29 per generation (2 variants)
- **Speed**: Fast
- **Quality**: High

## Features
- Two SFX variants per generation
- Seamless loop mode for game/ambient audio
- Tempo (BPM) and musical key controls
- Fast generation (typically under a minute)
- Text-to-sound with a single prompt

## Use Cases
- UI and notification sounds
- Game sound effects and ambient loops
- Video foley and transitions
- Podcast stingers and idents
- Prototype sound design

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **prompt**: string - Description of the sound effect to generate (max 500 chars)

### Optional
- **soundLoop**: boolean - Generate a seamlessly loopable sound (default false)
- **soundTempo**: integer - Tempo in BPM, 1-300 (omit for auto)
- **soundKey**: string - Musical key, e.g. Any, C, Cm, D, Dm (default Any)
- **grabLyrics**: boolean - Capture lyrics/subtitle timing if the sound contains vocals (default false)

## Examples

### UI notification sound
Generate a short sound effect from a plain-text description
```json
{
  "model": "suno/sfx-v5",
  "input": {
    "prompt": "single soft door knock, dry room"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Describe the source, texture, and space (e.g. 'metallic click, small room, dry').
- Use soundLoop=true for game ambience that must repeat seamlessly.
- Each generation returns two variants; pick the better one.

## Documentation
https://docs.sunoapi.org/suno-api/generate-sounds