---
title: "Create Suno Cover Task"
method: POST
path: "/api/v1/suno/cover/generate"
---

# Create Suno Cover Task

`POST /api/v1/suno/cover/generate`

Generate personalized cover images based on original music tasks.

### Usage Guide
- Use this interface to create personalized cover images for generated music
- Requires the taskId of the original music task
- Each music task can only generate a Cover once; duplicate requests will return the existing taskId
- Results will be notified through the callback URL upon completion

### Parameter Details
- `taskId` identifies the unique identifier of the original music generation task
- `callBackUrl` receives callback address for completion notifications

### Developer Notes
- Cover image file URLs will be retained for 14 days
- If a Cover has already been generated for this music task, a 400 status code and existing taskId will be returned
- It's recommended to call this interface after music generation is complete

## Request body

- object
  - `taskId` string, required — Original music task ID, should be the taskId returned by the music generation interface.
  - `callBackUrl` string, uri, required — URL address for receiving Cover generation task completion updates. This parameter is required for all Cover generation requests. - The system will send POST requests to this URL when Cover generation is complete, including task status and results - Your callback endpoint should be able to accept JSON payloads containing cover image URLs - For detailed callback format and implementation guide, see [Cover Generation Callbacks](https://docs.sunoapi.org/suno-api/cover-suno-callbacks) - Alternatively, you can use the Get Cover Details interface to poll task status

## Response `200`

Success

- object
  - `code` 200 | 400 | 401 | 402 | 404 | 409 | 422 | 429 | 455 | 500 — Response status code - **200**: Success - Request processed successfully - **400**: Validation error - Cover already generated for this task - **401**: Unauthorized - Authentication credentials missing or invalid - **402**: Insufficient credits - Account doesn't have enough credits for this operation - **404**: Not found - Requested resource or endpoint doesn't exist - **409**: Conflict - Cover record already exists - **422**: Validation error - Request parameters failed validation checks - **429**: Rate limited - Your call frequency is too high. Please try again later. - **455**: Service unavailable - System currently undergoing maintenance - **500**: Server error - Unexpected error occurred while processing request Build failed - Cover image generation failed
  - `msg` string — Error message when code != 200

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)