Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unifically.com/llms.txt

Use this file to discover all available pages before exploring further.

Generate sound effects (not music) using Suno AI.

​
Model

suno-ai/sound

​
Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes—Sound description (e.g. "dog barking in street")
mvstringYes—Model version (e.g. chirp-fenix)
titlestringNo—Sound title
negative_tagsstringNo—Tags to avoid
bpmintNo—Tempo / beats per minute (1–300)
keystringNo—Musical key (see Valid Keys)
typestringNo"one-shot""one-shot" or "loop"

​
Valid Keys

ModeKeys
MajorC C# D D# E F F# G G# A A# B
MinorCm C#m Dm D#m Em Fm F#m Gm G#m Am A#m Bm

​
Example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/sound",
    "input": {
      "prompt": "dog barking in street",
      "mv": "chirp-fenix",
      "title": "Dog Bark",
      "type": "one-shot",
      "bpm": 120,
      "key": "Am"
    }
  }'

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}
Status response uses the same clip format as Music Generation.