Model
suno-ai/sound
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Sound description (e.g. "dog barking in street") |
mv | string | Yes | — | Model version (e.g. chirp-fenix) |
title | string | No | — | Sound title |
negative_tags | string | No | — | Tags to avoid |
bpm | int | No | — | Tempo / beats per minute (1–300) |
key | string | No | — | Musical key (see Valid Keys) |
type | string | No | "one-shot" | "one-shot" or "loop" |
custom_model | object | No | — | Required when mv is chirp-custom. Inline custom model — { "name": string, "audio_urls": string[] }. See Music Generation › Custom Model |
Valid Keys
| Mode | Keys |
|---|---|
| Major | C C# D D# E F F# G G# A A# B |
| Minor | Cm 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": "processing"
}
}