---
title: "Sing Over Instrumental Using Prompt and Lyrics"
method: POST
path: "/v1/sing_over_instrumental"
---

# Sing Over Instrumental Using Prompt and Lyrics

`POST /v1/sing_over_instrumental`

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.

## Response `200`

Successfully initiated sing over instrumental task

- object
  - `success` boolean
  - `message` string
  - `task_id` string
  - `conversion_id_1` string
  - `conversion_id_2` string
  - `eta` integer — Estimated processing time in seconds
  - `credit_estimate` number, float

## Other responses

- `422` — Validation Error
- `500` — Server Error

---

[API](https://skmtc.net/musicgpt/apis/musicgpt-api.md) · [All operations](https://skmtc.net/musicgpt/apis/musicgpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musicgpt/musicgpt-api/versions/6753dccf4c5d/schema)