Producer Tier

Automate Processing with the API

One endpoint, one API key. POST a file and a preset — get the processed audio back. Built for Make.com, Zapier, and custom pipelines.

Authentication

Generate an API key from your account (Producer tier required — one key per account, shown once at generation). Send it with every request:

X-API-Key: your_api_key

Lost the key? Generate a new one — this revokes the old key automatically.

POST /api/process-batch

Synchronous processing for texture, scene, and fidelity presets. Multipart form:

  • file — WAV or MP3, up to 50 MB / 5 minutes
  • preset — one of the preset IDs below
curl -X POST https://www.kromasound.com/api/process-batch \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@track.wav" \
  -F "preset=tube-saturation" \
  -o processed.wav

The response is the processed file. Useful headers:

  • Content-Typeaudio/wav (or the processed format)
  • Content-Dispositionattachment; filename of the output
  • X-Kroma-Credits-RemainingYour balance after this job
  • X-Kroma-Preset / X-Kroma-KindEcho of what was processed

Available presets

tube-saturationAnalog Warmth — tube-style warmth and chest resonance
tape-flutterLo-Fi Cassette — tape wow & flutter, aged texture
creators-punchDusty Vinyl — vinyl crackle and needle noise
worn-feltWorn Felt — softened highs, woody vintage character
live-dynamicsLive Room — small-venue space and transient snap
broadcast-warmthBroadcast Desk — radio broadcast presence
midnight-clubMidnight Club — through-the-wall club submersion
cinematic-washCinematic Wash — massive reverb, IMAX-scale space
pristine-clearPristine Clear — mastering-grade clarity and air
kinetic-subKinetic Sub — sub-bass impact and compression

Stem modes (stem-mixer, studio-acapella, persona-vocal…) run on the async job queue and are not available on this endpoint — they'll return 400 use_async_queue.

Errors

401Missing or invalid X-API-Key
403API access is a Producer-tier feature, or media kind not allowed on your tier
400Missing file/preset, unsupported type, or an async stem mode was requested
402Insufficient credits
413File over 50 MB (batch endpoint limit)

Errors are JSON: {"detail": "..."}. Failed backend jobs refund the credit automatically.

Credits

Each processed audio file costs 1 credit, charged before the job starts and refunded automatically if processing fails. Check your remaining balance in the X-Kroma-Credits-Remaining response header on every call.

Get an API key →

Sign in, upgrade to Producer, generate your key in account settings.