---
title: "Generate a music track (sync or async)"
method: POST
path: "/music"
---

# Generate a music track (sync or async)

`POST /music`

## Request

- Base URL: `https://varosity.ai/api`
- URL: `https://varosity.ai/api/music`
- Auth: HTTP bearer

## Request body

- MusicRequest
  - `modelId` string, required
  - `prompt` string, required
  - `durationSec` integer, required
  - `tags` string[]

## Response `200`

Track ID + audio URL (sync) or providerJobId (async)

## Other responses

- `409`: Provider not configured

---

[API](https://skmtc.dev/varosity/apis/varosity-ai-api.md) · [All operations](https://skmtc.dev/varosity/apis/varosity-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/varosity/apis/varosity-ai-api/revisions/049ca5f80d22?raw)