---
title: "Generate background music"
method: POST
path: "/v1/music/generate"
tags: ["Music"]
---

# Generate background music

`POST /v1/music/generate`

## Request

- Base URL: `https://www.postquick.ai/api`
- URL: `https://www.postquick.ai/api/v1/music/generate`
- Auth: HTTP bearer

Generate music through the same Lyria service as the dashboard and save a hosted WAV in your media library. Does not publish or change any video. No separate music-credit allowance currently exists; normal API rate limits apply.

## Request body

- object
  - `prompt` string, required
  - `duration` integer
  - `bpm` integer
  - `mood` string

## Response `200`

Successful response.

- object
  - `success` true, required
  - `data` object, required
    - `audioUrl` string, uri, required
    - `duration` number, required
    - `trackName` string, required

## Other responses

- `400`: Invalid input.
- `404`: Not found or not owned.
- `409`: Content changed or cannot be edited in its current state.

---

[API](https://skmtc.dev/postquick/apis/postquickai-api.md) · [All operations](https://skmtc.dev/postquick/apis/postquickai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postquick/apis/postquickai-api/revisions/d9bc2bcf3042?raw)