API

music-mastering

Поднимает микс до громкости и потолка true peak выбранной площадки (Spotify/YouTube −14 LUFS, Apple −16, клуб −9 …) и добавляет тональный характер. Целиком работает в браузере вызывающего — наши серверы этой работы не делают, поэтому цена — как у браузерной полосы, а не за мегабайт. Сообщает измеренные LUFS, true peak и LRA и исходника, и результата, чтобы агент мог проверить итог, а не верить на слово.

Вызов

POST https://timbrica.com/v1/tools/music-mastering/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <ваш ключ для безопасного повтора>
Content-Type: application/json

Вход

Входной файл

Файл ставит ваш браузер на шаге рецепта `upload`. Через /v1/uploads его загружать не нужно.
принимает: .mp3, .wav, .flac, .ogg, .m4a, .aac, .opus, .aiff, .wma

Рецепт для браузера

Этот тул работает в вашем собственном браузере. Заказ-наряд, который вы получите, несёт этот рецепт с подставленными значениями; селекторы ниже — версионированный контракт, а не деталь реализации: без новой версии они не меняются.

{
    "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"
    }
}

Что обязывает сделать каждое действие — других рецепты не используют:

На каждом шаге проверяйте селектор abort_when из заказ-наряда (html[data-tmb-run="failed"]). Если он сработал, тул отказался от задачи — например, видео не стало бы меньше. Остановитесь и запросите запуск через GET: error.detail скажет почему. Токены не списываются.

Какие ошибки может вернуть

validation_failed  insufficient_tokens 

История

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

Контракт не может измениться без новой версии и строки выше: тест сверяет опубликованную схему, цены и лимиты с закоммиченным lock-файлом и иначе роняет сборку. Подпишитесь на /v1/changelog, чтобы узнавать об изменениях.