Sign in

v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Create Suno Cover Task

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
post/api/v1/suno/cover/generate

Request body

taskIdstring required

Original music task ID, should be the taskId returned by the music generation interface.

callBackUrlstring 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
  • Alternatively, you can use the Get Cover Details interface to poll task status

Example request

{
  "taskId": "73d6128b3523a0079df10da9471017c8",
  "callBackUrl": "https://api.example.com/callback"
}

Response

Success

code200 | 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
msgstring

Error message when code != 200

Example response

{
  "msg": "success"
}