Skip to main content
Generate a cover version of an existing song or uploaded audio.

​
Model

suno-ai/cover

​
Parameters

ParameterTypeRequiredDescription
mvstringYesModel version
custombooleanYesSimple or custom mode
clip_idstringNoExisting Suno clip ID
audio_urlstringNoAudio file URL
gpt_description_promptstringNoSimple mode description
promptstringNoCustom mode prompt
titlestringNoTitle for cover
make_instrumentalbooleanNoGenerate instrumental
custom_modelobjectNoRequired when mv is chirp-custom. Inline custom model — { "name": string, "audio_urls": string[] }. See Music Generation › Custom Model

​
Example - Cover Existing Clip

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/cover",
    "input": {
      "mv": "chirp-bluejay",
      "custom": false,
      "clip_id": "5a6bb955-1536-4f43-877a-b4aa9fb18a4e",
      "gpt_description_prompt": "Jazz style cover with saxophone"
    }
  }'

​
Example - Upload and Cover

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/cover",
    "input": {
      "mv": "chirp-bluejay",
      "custom": true,
      "audio_url": "https://example.com/audio.mp3",
      "prompt": "Acoustic guitar cover with soft vocals",
      "title": "Acoustic Cover"
    }
  }'

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}