API

audio-trim

Вырезает заданный отрезок из загруженного аудиофайла и отдаёт результат файлом для скачивания. Сначала загрузите вход через POST /v1/uploads. АСИНХРОННО: вызов отвечает 202 с id запуска — опрашивайте GET /v1/runs/{id} или зарегистрируйте вебхук.

v2 beta server · 5 ток.

Цена (server): 2 ток. за МБ входа, не меньше 5 за вызов; с Премиумом −5 %, с округлением вверх. Точная сумма для вашего файла: POST /v1/tools/audio-trim/estimate.

Вызов

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

Вход

ПолеТипОбязательноеПояснение
audio object да Загруженный входной файл. Загрузите его через POST /v1/uploads (multipart `file` или JSON {"url":"…"}).
trim_start number нет Начало оставляемого отрезка, в секундах.
по умолчанию: 0
trim_end number нет Конец оставляемого отрезка, в секундах. Не передавайте — останется до конца.
format string нет Формат результата. По умолчанию — формат входа.
одно из: mp3, wav, ogg, flac, m4a, aac, opus, wma, aiff, webm
bitrate integer нет Битрейт результата, кбит/с, для форматов со сжатием.
fade_in number нет Длина нарастания, секунды.
fade_out number нет Длина затухания, секунды.

Входной файл

Загрузите файл через POST /v1/uploads (multipart `file` или JSON {"url": "…"}) и передайте {"file_id": "<id>"} в каждом из перечисленных полей.
поля с файлом: audio

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

validation_failed  input_too_large  insufficient_tokens  internal_error 

История

  • v2 — 2026-08-03 — Now asynchronous: returns 202 + run id instead of blocking. Media work no longer occupies a web worker shared with live visitors. Poll GET /v1/runs/{id} or use a webhook.
  • v1 — 2026-07-30 — Initial release (server lane, staged file input).

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