Batch

Run one analysis route over up to 20 URLs in a single call

One route over up to 20 sources in a single call: same engine, same metering as the single routes. Each item counts as one call plus its bytes, and a rate or quota stop ends the loop and is reported on the item where it fired. Provide urls and/or objectPaths, max 20 combined.

post/v1/batch

Request

  • Base URL: https://audiolab.tools
  • URL: https://audiolab.tools/v1/batch
  • Auth: HTTP bearer

Request body

urlsstring[]

Public http(s) URLs to audio files.

objectPathsstring[]

Storage objects minted via /api/upload-url under this key's key/<keyHash>/ namespace, for local files with no public URL. Readable for about an hour, so a second question about the same file needs no re-upload, then swept.

endpoint'mixlab/analyze' | 'mixlab/check-target' | 'mixlab/timeseries' | 'mixlab/spectrum' | 'voicelab/qa' | 'voicelab/segments' | 'signallab' | 'signallab/index'

Which analysis route to run for every URL.

argsobject

Optional route-specific extras (e.g. target, waveformPoints), applied to every URL.

namestring

Optional session name; stored on every item's event (meta.batch) so history can group the run.

Response

Batch processed. Individual URLs can still have failed; check each item's ok.

endpointstring required

The analysis route that ran.

countinteger required

Processed items; shorter than the request when a rate or quota stop fired.

batchIdstring

Unique id for this run; every item's event carries it in meta.batch.

namestring

The session name, when provided.

Example response

{
  "results": [
    {
      "url": "https://audiolab.tools/reference/is-original.mp3"
    }
  ]
}

Changes

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