Suno API Reference

Generate Music Cover

Generate AI cover images for completed music tracks, then poll the cover task for final artwork URLs.

Base URL

https://apiin.one/api/v1

Use the unified API in One gateway for all Suno routes.

Workflow

Generate + status

Create a cover task, then poll by task ID.

Credits

1 credit

Charged per cover generation request.

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

Generate Cover

Start a cover generation task for an existing music track.

Use a completed music generation task ID to create cover image candidates.

Body ParametersJSON

task_id:string

The task ID returned from the original music generation endpoint.

bash

1	curl -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	"task_id": "gen123213213213123bksv"
6	}'

json

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

Poll for completed cover image URLs.

Use the task ID returned from the generate endpoint to fetch current status and final images.

Body ParametersJSON

task_id:string

The cover task ID returned from /cover/generate.

bash

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

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	}