Audio

Create music generation task

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

post/v1/music/generations

Request

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

Headers

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

Per-request Delivery policy. Overrides the API key and Workspace defaults. Auto tries TokenLab Verified first and may switch once to Official only before output, request acceptance, or persistent resource creation.

Request body

modelstring
promptstring

Music description. Required for music, lyrics, upload-cover, and upload-extend requests; omit for add-instrumental.

titlestring
tagsstring
negative_tagsstring

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_instrumentalboolean

Generate instrumental output without vocals.

audio_urlstring 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_idstring

Clip ID to continue when extending an existing generation.

continue_atnumber

Timestamp in seconds for continuation flows. Required when audio_operation is upload-extend.

Response

Task created

Changes

No recorded changes to this operation across all 1 revision of this API.