Cover Art - Unifically

Generate artwork for a clip. Each request returns two images. The basic tier is free and accepts up to four reference images. The advanced tier produces more detailed images, is billed, and works from the prompt alone. Try it in the browser: Suno Cover Art API playground.

Model

suno-ai/cover-art

Parameters

Parameter	Type	Required	Description
`clip_id`	string	Yes	Clip the artwork belongs to
`prompt`	string	Yes	Description of the artwork
`quality`	string	No	`basic` (default) or `advanced`
`aspect_ratio`	string	No	Aspect ratio such as `1:1`. Default: `1:1`
`image_urls`	string[]	No	Up to 4 reference image URLs (PNG, JPEG, or WebP, 10 MB max each). `basic` only
`image_ids`	string[]	No	Up to 4 IDs of images from earlier cover-art results, to remix them. `basic` only

image_urls and image_ids count toward the same limit of four references. Reference images go through content moderation before generation.

Example - Prompt only

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-art",
    "input": {
      "clip_id": "1901ec96-72c6-4c26-8e56-91028ca6070d",
      "prompt": "melancholic cinematic album cover, empty room, soft light",
      "quality": "advanced"
    }
  }'

Example - Reference images

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-art",
    "input": {
      "clip_id": "1901ec96-72c6-4c26-8e56-91028ca6070d",
      "prompt": "same mood, painted style",
      "image_urls": [
        "https://example.com/reference-1.jpg",
        "https://example.com/reference-2.jpg"
      ]
    }
  }'

Response

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

Result

{
  "task_id": "abc123def456",
  "status": "completed",
  "images": [
    { "id": "e36f8b72-…", "url": "https://…/cover-1.jpeg", "thumbnail_url": "https://…/cover-1.jpeg" },
    { "id": "19b12b6e-…", "url": "https://…/cover-2.jpeg", "thumbnail_url": "https://…/cover-2.jpeg" }
  ]
}

Use an image id in image_ids to iterate on a result.

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.