Get API Key Get API
Docs

Mastering

- Master an already generated song to improve audio quality, clarity, and overall texture.

  • Reference the source track: specified by task_id + audio_index, no need to record any extra id
  • Async task: submitting returns a task_id; poll GET /v1/music/tasks/:task_id for the result
Info

Source Audio Reference: No additional IDs are needed for tracks based on existing songs. Just pass task_id (the task ID from the previous run of this task) + audio_index (which result track in the data.result.music[] list, 1-based, default is 1).

Note

This endpoint does not accept version parameters, so please do not pass in version. The task is charged based on suno@remaster.

Request example

curl -X POST https://api.openveer.com/v1/music/generations/remaster \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "task_id": "task_01ABC",
    "audio_index": 1
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All endpoints require authentication using a Bearer Token

Get an API Key:

Visit the API Key management page to get your API Key

Add the following to the request headers when using it:

Authorization: Bearer YOUR_API_KEY

Body

model string

Audio model. Currently pass suno (defaults to suno if omitted).

task_id string

Our task_id of the job that produced the source track. If missing or the source cannot be resolved, a 400 is returned at submission time.

audio_index integer

Selects a track from the source task's data.result.music[] array (1-based; default 1).

variation_category string

Remaster intensity: subtle / normal / high.

audio_format string

Output audio format: mp3 / m4a / wav.

Note

This interface does not support the fields custom_model_id, max_mode, or variety, or target duration.

Note

Result: This is an asynchronous task. After submission, you will get task_id and then poll GET /v1/music/tasks/{task_id} every 3–5 seconds until status becomes completed or failed (music generation typically takes 30–120s; during generation, status may be pending or processing, and progress is a whole number between 0 and 100 that does not guarantee fixed changes). Once completed, retrieve the optimized audio_url from data.result.music[]. If it fails, data.error.message will contain the reason, and the deducted amount will be automatically refunded.

Response

code integer

Response status code

data array
Returned data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier (used to poll GET /v1/music/tasks/{task_id} for the result)

This documentation is built and hosted on Mintlify, a developer documentation platform.