Audio analysis as an API.

Request

Send a public url (up to 150 MB), a small file as the multipart field file or as the raw body with an audio content type (about 4.5 MB), or an objectPath after a signed upload. A file you send is uploaded to the API: see /privacy for what is kept.

Example

curl https://audiolab.tools/v1/mixlab/analyze \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/mixlab/analyze",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/mixlab/analyze", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

MixLab analysis (mirrors the engine AnalysisResult type). The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 422 File could not be decoded as audio. unsupported_format, room_not_measurable
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Send a public url (up to 150 MB), a small file as the multipart field file or as the raw body with an audio content type (about 4.5 MB), or an objectPath after a signed upload. A file you send is uploaded to the API: see /privacy for what is kept.

Example

curl https://audiolab.tools/v1/voicelab/qa \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/samples/voice/speech-female-plain.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/voicelab/qa",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/samples/voice/speech-female-plain.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/voicelab/qa", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/samples/voice/speech-female-plain.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

VoiceLab speech-quality analysis (mirrors the engine VoiceAnalysis type). The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 422 File could not be decoded as audio. unsupported_format, room_not_measurable
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Send a public url (up to 150 MB), a small file as the multipart field file or as the raw body with an audio content type (about 4.5 MB), or an objectPath after a signed upload. A file you send is uploaded to the API: see /privacy for what is kept.

Example

curl https://audiolab.tools/v1/analyze/profile \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3", "profile": "basic"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/analyze/profile",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3", "profile": "basic"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/analyze/profile", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3", profile: "basic" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

The answer is keyed by lens id and holds only the lenses the profile needs, each with its value, so there is no fixed field list. Every lens, its status and its margin is in the catalogue; the profile basic is free.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 422 File could not be decoded as audio. unsupported_format, room_not_measurable
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Send a public url (up to 150 MB), a small file as the multipart field file or as the raw body with an audio content type (about 4.5 MB), or an objectPath after a signed upload. A file you send is uploaded to the API: see /privacy for what is kept.

Example

curl https://audiolab.tools/v1/signallab \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/signallab",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/signallab", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

SignalLab indexer output (mirrors the engine SignalIndex type). The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 422 File could not be decoded as audio. unsupported_format, room_not_measurable
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Send a public url (up to 150 MB), a small file as the multipart field file or as the raw body with an audio content type (about 4.5 MB), or an objectPath after a signed upload. A file you send is uploaded to the API: see /privacy for what is kept.

Example

curl https://audiolab.tools/v1/signallab/sample \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/cal-1k-sine.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/signallab/sample",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/cal-1k-sine.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/signallab/sample", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/cal-1k-sine.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

One sound from a sample library. character and loop are mutually exclusive: a single hit fills character, material with several onsets fills loop, and the other is null. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 422 File could not be decoded as audio. unsupported_format, room_not_measurable
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Example

curl https://audiolab.tools/v1/mixlab/check-target \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3", "target": "spotify"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/mixlab/check-target",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3", "target": "spotify"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/mixlab/check-target", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3", target: "spotify" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

Pass/fail verdict for a loudness target check, with concrete deltas and an ffmpeg loudnorm fix command. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Example

curl https://audiolab.tools/v1/mixlab/timeseries \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/mixlab/timeseries",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/mixlab/timeseries", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

Loudness and waveform data over time, for graphing or visualization. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Example

curl https://audiolab.tools/v1/mixlab/spectrum \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/reference/is-original.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/mixlab/spectrum",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/reference/is-original.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/mixlab/spectrum", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/reference/is-original.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

FFT spectrum bins plus band energies and spectral descriptors. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Example

curl https://audiolab.tools/v1/voicelab/segments \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://audiolab.tools/samples/voice/speech-female-plain.mp3"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/voicelab/segments",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={"url": "https://audiolab.tools/samples/voice/speech-female-plain.mp3"},
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/voicelab/segments", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://audiolab.tools/samples/voice/speech-female-plain.mp3" }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

Voiced regions with timestamps. For auto-trim and chapter generation. It finds where speech is, not who is speaking or where the speaker changes. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 402 A limit of your plan was reached: the calls or the data of the month, or a preset that needs a paid plan. The body carries usage where it applies. quota_exceeded, data_quota_exceeded, profile_requires_paid_plan, voice_minutes_exhausted
• 413 File too large for the route, or a recording too long to decode. file_too_large, track_too_long
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Request

Example

curl https://audiolab.tools/v1/batch \
  -H "Authorization: Bearer $AUDIOLAB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://audiolab.tools/reference/is-original.mp3", "https://audiolab.tools/reference/is-muddy.mp3"], "endpoint": "mixlab/analyze"}'

import os
import requests

r = requests.post(
    "https://audiolab.tools/v1/batch",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    json={
        "urls": [
            "https://audiolab.tools/reference/is-original.mp3",
            "https://audiolab.tools/reference/is-muddy.mp3",
        ],
        "endpoint": "mixlab/analyze",
    },
    timeout=300,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/batch", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    urls: [
      "https://audiolab.tools/reference/is-original.mp3",
      "https://audiolab.tools/reference/is-muddy.mp3",
    ],
    endpoint: "mixlab/analyze",
  }),
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

The answer of /v1/batch. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 400 Malformed request, a URL we could not use, or a parameter that is not valid. url_not_allowed, url_fetch_failed, invalid_json, missing_input, invalid_parameter, batch_too_large, upload_not_found
• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key

Example

curl https://audiolab.tools/v1/usage \
  -H "Authorization: Bearer $AUDIOLAB_KEY"

import os
import requests

r = requests.get(
    "https://audiolab.tools/v1/usage",
    headers={"Authorization": f"Bearer {os.environ['AUDIOLAB_KEY']}"},
    timeout=30,
)
if not r.ok:
    # error.code says what happened: https://audiolab.tools/docs/errors
    raise RuntimeError(r.json()["error"]["code"])
print(r.json())

const res = await fetch("https://audiolab.tools/v1/usage", {
  headers: { Authorization: `Bearer ${process.env.AUDIOLAB_KEY}` },
});
const body = await res.json();
// On an error, body.error.code says what happened: https://audiolab.tools/docs/errors
if (!res.ok) throw new Error(body.error.code);
console.log(body);

Response

Where a key stands this month. The same numbers as /account. The word next to a number says how far to trust it (the five statuses); a margin says how far it can be off. Add "measureStatus": true to the request to get the same status and margin inside the answer.

Errors

• 401 Invalid or revoked API key. /v1/batch and /v1/usage always need a key; the analysis routes also run without one, as a small keyless trial. invalid_api_key
• 429 Too many requests this minute. See Retry-After. rate_limited
• 500 Something went wrong on our side. The details are logged and never sent to you. storage_unavailable, analysis_error

Every error carries a stable code and a docs_url: the cause, the fix and an example for each.

Try it with your key