Sing Over Instrumental Using Prompt and Lyrics

This endpoint allows users to sing over an instrumental audio track using a text prompt and lyrics. It supports either a file upload or a URL to the input audio and generates a vocal overlay based on the provided lyrics and style.

post/v1/sing_over_instrumental

Request

  • Base URL
    https://api.musicgpt.com/api/public
  • Auth
    API key in header Authorization

Request body multipart/form-data

OR

Example request

{
  "audio_url": "https://bucket.s3.amazonaws.com/audio.mp3",
  "prompt": "Sing emotional vocals over a soft piano instrumental.",
  "lyrics": "Never mind I'll find someone like you...",
  "gender": "female",
  "webhook_url": "https://yourdomain.com/webhook"
}

Response

Successfully initiated sing over instrumental task

successboolean
messagestring
task_idstring
conversion_id_1string
conversion_id_2string
etainteger

Estimated processing time in seconds

credit_estimatenumber float

Example response

{
  "success": true,
  "message": "Sing Over Instrumental request submitted successfully",
  "task_id": "task-abcde12345",
  "conversion_id_1": "over-instrumental-1",
  "conversion_id_2": "over-instrumental-2",
  "eta": 45,
  "credit_estimate": 50
}

Changes

No recorded changes to this operation across all 1 revision of this API.