> ## 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.

# Cover Art

> Generate album artwork for a Suno clip from a prompt, optionally guided by reference images. See parameters, pricing, response fields, and API examples.

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.

## 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

```bash theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```

## Result

```json theme={null}
{
  "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.

<Note>
  **Volume discounts** are available for almost all models. Reach out at [contact@unifically.com](mailto:contact@unifically.com) to discuss custom pricing.
</Note>