Check job status
Poll the durable queue status until a job completes, fails, or is canceled.
AudioLasso jobs run through a durable queue. After you submit a job, poll the status_url until it finishes.
Polling is the base contract. It works from browsers, servers, scripts, cron jobs, and agents, and it lets any process resume from the same request_id.
Poll the status URL
curl "https://audiolasso.dev/v1/queue/requests/req_01jabc/status?logs=true" \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY"Status values
| Status | Meaning |
|---|---|
IN_QUEUE | The job is queued and waiting to start |
IN_PROGRESS | AudioLasso is processing the job |
COMPLETED | Output files are ready |
FAILED | The job failed and includes an error |
CANCELED | The job was canceled and its credit reservation was released |
The status response includes result_url. When logs=true, it also includes short progress messages.
When the job is done
When status becomes COMPLETED, fetch the result:
curl https://audiolasso.dev/v1/queue/requests/req_01jabc/result \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY"The result contains target and residual files:
{
"request_id": "req_01jabc",
"model": "audio/separate",
"status": "COMPLETED",
"data": {
"target": {
"url": "https://...",
"content_type": "audio/wav",
"file_name": "target.wav"
},
"residual": {
"url": "https://...",
"content_type": "audio/wav",
"file_name": "residual.wav"
},
"sample_rate": 44100
}
}Cancel queued or running work
curl -X POST https://audiolasso.dev/v1/queue/requests/req_01jabc/cancel \
-H "Authorization: Bearer $AUDIOLASSO_API_KEY"Cancellation is idempotent after the request reaches CANCELED. A request that already completed or failed returns 409 REQUEST_TERMINAL.
Optional alternatives
Use streaming when a live client wants status updates over one connection.
Use webhooks when a backend should receive a completion callback instead of running its own polling loop.