Quickstart
Start using the AudioLasso API with an API key and a single audio separation request.
AudioLasso is a queue-based API for isolating specific sounds from audio or video with plain-language prompts.
1. Create an API key
Sign in and create a key from the dashboard:
New keys are shown once. Copy the key and store it in your environment:
export AUDIOLASSO_API_KEY="al_..."2. Submit a separation job
Use audio_url for public HTTPS media:
curl -X POST https://audiolasso.dev/v1/queue/audio/separate \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"audio_url": "https://example.com/audio.wav",
"prompt": "isolate the lead vocal"
}
}'The API returns a queued request:
{
"request_id": "req_01jabc",
"status": "IN_QUEUE",
"model": "audio/separate",
"status_url": "https://audiolasso.dev/v1/queue/requests/req_01jabc/status",
"stream_url": "https://audiolasso.dev/v1/queue/requests/req_01jabc/status/stream",
"result_url": "https://audiolasso.dev/v1/queue/requests/req_01jabc/result"
}3. Poll for the result
curl https://audiolasso.dev/v1/queue/requests/req_01jabc/status \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY"When status is COMPLETED, fetch the result:
curl https://audiolasso.dev/v1/queue/requests/req_01jabc/result \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY"