Upload Cover (Audio-to-Audio)

Generate new music using your own uploaded audio as a starting point. Supports non-custom and custom modes.

1. Generate from Upload

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

First, upload your audio via the Suno web interface or a standard upload API to get an audio_id.

Then, call this API using the audio_id as the source. You can choose to extend it as-is or override the style with custom parameters.

Length Limits: Uploaded audio must be between 6 and 60 seconds.

Credits: 5-12 credits based on the model variation generated.

Required Parameters

Parâmetro	Tipo	Obrigatório	Descrição
`audio_id`	string	Obrigatório	The ID of the uploaded audio file.

Optional / Custom Mode Parameters

Parâmetro	Tipo	Obrigatório	Descrição
`custom_mode`	boolean	Opcional	Set to true to use custom settings (prompt, style, title). (Padrão: false)
`prompt`	string	Opcional	Lyrics or detailed prompt. Required if custom_mode is true.
`style`	string	Opcional	Musical style/genre for the generated track.
`title`	string	Opcional	Title of the generated track.
`callback_url`	string	Opcional	Webhook URL to get the result asynchronously.

cURL Example

bash

curl -X POST "https://apiin.one/api/v1/audio/music/upload-cover/generate" \
  -H "Authorization: Bearer aio_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_id": "aud123456789",
    "custom_mode": true,
    "prompt": "Here are some new lyrics for the intro...",
    "style": "acoustic pop"
  }'

Response Example

json

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "upl987654321bksv"
  }
}

2. Check Status

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

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

Request Parameters

Parâmetro	Tipo	Obrigatório	Descrição
`task_id`	string	Obrigatório	The task ID returned from /upload-cover/generate

cURL Example

bash

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

Response Example

json

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "upl987654321bksv",
    "status": "complete",
    "clips": [
      {
        "id": "song_abc",
        "audio_url": "https://audiopipe.suno.ai/?item_id=song_abc",
        "image_url": "https://cdn2.suno.ai/image_abc.jpeg"
      }
    ],
    "created_at": "2026-02-24T12:00:30Z"
  }
}

Error Handling

Status Code	Tipo	Obrigatório	Descrição
`400`	invalid_request	Opcional	Missing audio_id, or uploaded audio length does not meet guidelines (6-60s).
`401`	authentication_error	Opcional	Invalid or missing API key.
`404`	not_found	Opcional	Audio ID or task ID not found.