Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.whisul.com/llms.txt

Use this file to discover all available pages before exploring further.

Whisul’s AI music generation API turns plain-text prompts into original songs. You describe the music you want — a genre, a mood, or stems — and Whisul generates a full audio track along with cover art, BPM, duration, and tags. Whether you are a content creator looking for background music or an artist prototyping new ideas, Whisul gives you a simple two-endpoint API to generate music programmatically.

Quickstart

Make your first API call and get a generated song URL in under 5 minutes.

Authentication

Learn how to obtain your API key and authenticate every request.

Submit a composition

POST a text prompt to /generate to kick off an async music generation job.

Poll for results

GET /jobs/{job_id} to check job status and retrieve your audio URL.

​
How it works

Whisul uses an asynchronous job model. When you submit a prompt, the API immediately returns a job_id — generation runs in the background. You then poll the job status endpoint until the job completes, at which point the response includes everything you need to use the track.

​
What you get back

A completed job returns the following in the result object:
  • song_url — a direct link to the generated audio file
  • image_url — AI-generated cover art for the track
  • bpm — tempo of the generated song
  • duration — length of the track in seconds
  • title — an auto-generated title
  • tags — descriptive tags for the track

​
The two endpoints

EndpointPurpose
POST /generateSubmit a text prompt and receive a job_id
GET /jobs/{job_id}Check job status and retrieve the result when complete

​
Who it’s for

Whisul is designed for:
  • Content creators who need royalty-free background music for videos, podcasts, or social content
  • Artists and producers who want to quickly prototype musical ideas from text descriptions
  • Developers building games, apps or platforms that require generated audio
Ready to generate your first track? Head to the quickstart to make your first API call.