Esfera DevelopersSpatial audio, converted from your own pipeline

Send a master, get back an IAMF file. One REST API, a TypeScript SDK and a command-line tool, built on the same encoder that powers Esfera.

Quickstart

API reference

import { Esfera } from "@esfera/sdk";

const esfera = new Esfera({ apiKey: process.env.ESFERA_API_KEY });

const job = await esfera.conversions.create({
  file: "master.wav",
  preset: "esfera",
});
await job.wait({ onProgress: (c) => console.log(c.status, c.progress) });
await job.download("master.iamf");

npm install -g @esfera/cli
esfera login
esfera convert master.wav --preset esfera -o master.iamf

curl -X POST "https://api.esfera.audio/v1/conversions" \
  -H "Authorization: Bearer $ESFERA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filename":"master.wav","durationSec":1800,"preset":"esfera"}'

Your masters, as they are

ADM masters keep their beds and objects. Ambisonic masters, first to third order, go in as they are. Pick a preset and the encoder writes the IAMF profile that fits.

Built to be scripted

Safe retries with idempotency keys, signed webhooks for every state change, a rate limit you can read from the headers, and one stable error shape.

A contract, not a moving target

`/v1` does not change under you. Breaking changes ship as `/v2`, beside it. The SDK and CLI are generated against the same OpenAPI document this reference is built from.