LogoAPI in One
Back to Suno Model

Generate Music Cover

Generate AI cover images for your generated music tracks. Consumes 1 credit per request.

1. Generate Cover

POST/api/v1/audio/music/cover/generate

Start a cover generation task for an existing music track.

  • Requires a completed music generation task ID.
  • Generates 2 different style images for selection.
  • Credits: 1 credit per request.

Request Parameters

Body ParametersJSON
taskId:string

The task ID of the original music generation. This is the workId returned from the /v2/generate endpoint.

cURL Example

bash
1curl -X POST "https://apiin.one/api/v1/audio/music/cover/generate" \
2 -H "Authorization: Bearer aio_your_api_key_here" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "taskId": "gen123213213213123bksv"
6 }'

Response Example

json
1{
2 "code": 200,
3 "msg": "success",
4 "data": {
5 "taskId": "cover123123213213b880d2"
6 }
7}

2. Check Status

GET/api/v1/audio/music/cover/status?task_id={task_id}

Poll for the status of your cover generation task using the task_id returned from the generate endpoint.

Request Parameters

Body ParametersJSON
task_id:string

The cover task ID returned from /v2/cover/generate

cURL Example

bash
1curl -X GET "https://apiin.one/api/v1/audio/music/cover/status?task_id=cover123123213213b880d2" \
2 -H "Authorization: Bearer aio_your_api_key_here"

Response Example

json
1{
2 "code": 200,
3 "msg": "success",
4 "data": {
5 "taskId": "cover123123213213b880d2",
6 "status": "SUCCESS",
7 "images": [
8 "https://tempcover.storage.com/s/123.png",
9 "https://tempcover.storage.com/s/456.png"
10 ],
11 "created_at": "2026-02-24T12:00:30Z"
12 }
13}

Error Handling

Body ParametersJSON
400:optional bad_request

Cover already generated for this task, or invalid params.

401:optional authentication_error

Invalid or missing API key.

404:optional not_found

Original music task or cover task not found.