API

music-mastering

Brings a mix up to the loudness and true-peak ceiling of a chosen platform (Spotify/YouTube −14 LUFS, Apple −16, club −9 …), with a tonal style on top. Runs entirely in the caller's own browser — our servers do none of the work, which is why it is priced as a browser-lane call and not per megabyte. Reports measured LUFS, true peak and LRA for both the original and the result, so an agent can verify the outcome instead of trusting it.

v1 beta browser · 3 tokens

Call it

POST https://timbrica.com/v1/tools/music-mastering/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <your retry-safe key>
Content-Type: application/json

Input

FieldTypeRequiredNotes
target string no Loudness target of the platform the track is going to. streaming = −14 LUFS / −1 dBTP (Spotify, YouTube), apple = −16 / −1, amazon = −14 / −2, club = −9 / −1, podcast = −16 / −1.5, cd = −9 / −0.3, broadcast = −23 / −1 (EBU R128). Omit for streaming.
one of: streaming, apple, amazon, club, podcast, cd, broadcast
default: streaming
style string no Tonal character applied on top of the loudness match. `transparent` adds nothing and tracks the target most closely; `auto` lets the tool pick from the material.
one of: auto, transparent, warm, punchy, clear, open, loud, aimusic
default: transparent
format string no Delivery format. WAV is the distributor-safe default; MP3 is 320 kbps.
one of: wav, flac, mp3
default: wav

Browser recipe

This tool runs in your own browser. The work order you receive carries this recipe with the placeholders filled in; the selectors below are a versioned contract, not implementation detail — they do not change without a version bump.

{
    "engine": "dom",
    "steps": [
        {
            "action": "upload",
            "selector": "[data-tmb-api=\"input-file\"]",
            "accept": [
                ".mp3",
                ".wav",
                ".flac",
                ".ogg",
                ".m4a",
                ".aac",
                ".opus",
                ".aiff",
                ".wma"
            ]
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"target\"][data-target=\"{{target}}\"]",
            "optional": true
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"style\"][data-style=\"{{style}}\"]",
            "optional": true
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"run\"]"
        },
        {
            "action": "wait",
            "selector": "[data-tmb-api=\"download\"][data-tmb-format=\"{{format}}\"]",
            "timeout_s": 900,
            "appears": "after_run"
        },
        {
            "action": "click",
            "selector": "[data-tmb-api=\"download\"][data-tmb-format=\"{{format}}\"]",
            "appears": "after_run"
        }
    ],
    "result": {
        "kind": "download",
        "settles": "automatically"
    }
}

Errors it can return

validation_failed  insufficient_tokens 

History

  • v1 — 2026-08-06 — Initial release (browser lane).

This contract cannot change without a new version and a line above: a test compares the published schema, pricing and limits against a committed lockfile and fails the build otherwise. Subscribe to /v1/changelog to be told when something moves.