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

Parameter	Typ	Erforderlich	Beschreibung
`taskId`	string	Erforderlich	The task ID of the original music generation. This is the workId returned from the /v2/generate endpoint.

cURL Example

bash

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

Response Example

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2"
  }
}

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

Parameter	Typ	Erforderlich	Beschreibung
`task_id`	string	Erforderlich	The cover task ID returned from /v2/cover/generate

cURL Example

bash

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

Response Example

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cover123123213213b880d2",
    "status": "SUCCESS",
    "images": [
      "https://tempcover.storage.com/s/123.png",
      "https://tempcover.storage.com/s/456.png"
    ],
    "created_at": "2026-02-24T12:00:30Z"
  }
}

Error Handling

Status Code	Typ	Erforderlich	Beschreibung
`400`	bad_request	Optional	Cover already generated for this task, or invalid params.
`401`	authentication_error	Optional	Invalid or missing API key.
`404`	not_found	Optional	Original music task or cover task not found.