---
title: "Create music generation task"
method: POST
path: "/v1/music/generations"
tags: ["Audio"]
---

# Create music generation task

`POST /v1/music/generations`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/music/generations`
- Auth: HTTP bearer

Creates a music generation task using Suno. Returns a task ID for polling.

## Headers

- `X-TokenLab-Delivery-Policy` 'auto' | 'verified' | 'official'

## Request body

- object
  - `model` string
  - `prompt` string: Music description. Required for music, lyrics, upload-cover, and upload-extend requests; omit for add-instrumental.
  - `title` string
  - `tags` string
  - `negative_tags` string: Styles to avoid. Required when audio_operation is add-instrumental.
  - `action` 'MUSIC' | 'LYRICS'
  - `mv` 'chirp-v3-5' | 'chirp-v4' | 'chirp-v4-5' | 'chirp-v4.5' | 'chirp-v4-5plus' | 'chirp-v4.5plus' | 'chirp-v4-5all' | 'chirp-v4.5all' | 'chirp-v5' | 'chirp-v5-5' | 'chirp-v5.5': Official Suno model version. Required when creating music (action omitted or MUSIC); omit for lyrics-only requests.
  - `make_instrumental` boolean: Generate instrumental output without vocals.
  - `audio_url` string, uri: Publicly reachable reference or uploaded audio URL. Defaults to upload-cover when audio_operation is omitted.
  - `audio_operation` 'upload-cover' | 'upload-extend' | 'add-instrumental': Uploaded-audio mode. upload-extend requires continue_at; add-instrumental requires audio_url, title, tags, and negative_tags.
  - `continue_clip_id` string: Clip ID to continue when extending an existing generation.
  - `continue_at` number: Timestamp in seconds for continuation flows. Required when audio_operation is upload-extend.

## Response `200`

Task created

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `503`: The requested Delivery tier is temporarily unavailable.

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)