Sign in

v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Get Cover Generation Details

Get detailed information about Cover generation tasks.

Usage Guide

  • Use this interface to check Cover generation task status
  • Access generated cover image URLs upon completion
  • Track processing progress and any errors that may occur

Status Description

  • 0: 待执行 (Pending)
  • 1: 成功 (Success)
  • 2: 生成中 (Generating)
  • 3: 生成失败 (Generation failed)

Developer Notes

  • Cover image URLs are only available when status is SUCCESS in the response
  • Error codes and messages are provided for failed tasks
  • After successful generation, cover images are retained for 14 days
get/api/v1/suno/cover/record-info

Query parameters

taskIdstring required

Unique identifier of the Cover generation task to retrieve. This is the taskId returned when creating the Cover generation task.

Response

Success

code200 | 400 | 401 | 402 | 404 | 409 | 422 | 429 | 455 | 500

Response status code

  • 200: Success - Request processed successfully
  • 400: Format error - Parameters are not in valid JSON format
  • 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 - Request rate limit exceeded for this resource
  • 455: Service unavailable - System currently undergoing maintenance
  • 500: Server error - Unexpected error occurred while processing request
msgstring

Error message when code != 200

Example response

{
  "msg": "success"
}