---
title: "Generate Custom Music"
method: POST
path: "/v1/MusicAI"
deprecated: true
---

# Generate Custom Music

`POST /v1/MusicAI`

> **Deprecated.**

Create music powered by AI using just a prompt, lyrics, or a defined music style.

## Request body

- object
  - `prompt` string — A natural language prompt for music generation. Keep it under 280 characters for guaranteed results, but detailed—the clearer and more descriptive it is, the better the outcome.
  - `music_style` string — Style of music to generate (e.g., Rock, Pop)
  - `lyrics` string — Custom lyrics for the generated music
  - `title` string — Title of the generated music track
  - `make_instrumental` boolean — Whether to make the music instrumental
  - `vocal_only` boolean — Whether to generate only vocals of output audio
  - `gender` string — Gender of the voice model
  - `voice_id` string — Voice model to convert generated audio
  - `generate_album_cover` boolean — Whether to generate an album cover for the generated audio
  - `webhook_url` string — URL for callback upon completion

## Response `200`

Successful response

- object
  - `success` boolean
  - `message` string
  - `task_id` string
  - `conversion_id_1` string
  - `conversion_id_2` string
  - `eta` integer

## Other responses

- `402` — Payment Required
- `500` — Internal 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)
