# Suno SFX V5

> 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-sfx
- **Model ID**: suno/sfx-v5
- **Category**: music_generation
- **Credits**: 29 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `soundLoop` (boolean, optional): Generate a seamlessly loopable sound (default false)
- `soundTempo` (integer, optional): Tempo in BPM (omit for auto) (Range: min: 1, max: 300)
- `grabLyrics` (boolean, optional): Capture lyrics/subtitle timing if the sound contains vocals (default false)
- `prompt` (string, **required**): Description of the sound effect to generate (max 500 chars)
- `soundKey` (string, optional): Musical key, e.g. Any, C, Cm, D, Dm ... (default Any)

## Example Request

```json
{
  "model": "suno/sfx-v5",
  "input": {
    "prompt": "single soft door knock, dry room"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

suno, sfx, sound-effects, audio, foley

## Documentation

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