Spatial9 Documentation
Official Spatial9 documentation. Quickstarts, product guides, MCP, A2A and REST API references, enterprise and open-source pipelines, immersive formats, mixing standards and the science of 3D sound.
Getting started
What Spatial9 is, the core ideas behind immersive audio and how to make your first mix.
- Introduction to Spatial9: What Spatial9 does, who it is for, and how the platform, the engine and the integrations fit together.
- Quickstart: your first immersive mix: Turn a stereo song or a set of stems into an immersive mix, check it on headphones and export it.
- Core concepts: Objects, beds, channels, scenes, rendering, binaural and loudness: the vocabulary used throughout these docs.
- Choose the right workflow: Compare the app, AI assistants (MCP), agents (A2A), the REST API and the Acoustic Digital Twin, and pick the one that fits.
Products
How each Spatial9 product works, what it accepts and what it delivers.
- Spatializer for Music: Inputs, processing stages, controls, movement design, effects and export targets for music.
- Spatializer for Video: How Spatial9 places sound to follow the picture, and how to deliver immersive video soundtracks.
- ADM to Eclipsa Audio converter: Convert a Dolby Atmos ADM BWF master into Eclipsa Audio (IAMF) and a YouTube-ready MP4, free.
- Acoustic Digital Twin (ADT): Real-time stereo-to-immersive rendering for cars, devices, streaming and broadcast, and how it is deployed.
- Spatial9 Education and Academy: The free Academy, the classroom studio, Learn Your Way accessible guides, certificates and academic plans.
Developers and agents
MCP, A2A and REST references, limits, Agent Skills, automation and enterprise pipelines.
- MCP server reference: Connect Spatial9 to ChatGPT, Claude, Gemini, Cursor and any MCP client: endpoint, authentication, tools and examples.
- A2A agent reference: The Spatial9 Agent2Agent endpoint: agent card, skills, tasks, idempotency, streaming and push notifications.
- REST API reference: Authentication, resumable uploads, render jobs, status polling and downloads over HTTP.
- Limits, quotas and errors: Concurrency, daily render and task limits, file size rules, retries, idempotency and error handling.
- Agent Skills: The free SKILL.md library that teaches coding agents to use Spatial9, how to install it and what each skill does.
- Agent frameworks: Use Spatial9 from LangGraph, CrewAI, AutoGen, the OpenAI Agents SDK, Google ADK and other agent frameworks.
- Workflow automation: n8n, Zapier and Make: Build no-code and low-code pipelines that send audio to Spatial9 and deliver the results.
- Enterprise data platforms: Run governed spatial audio pipelines on Databricks, Snowflake, Google Vertex AI and Amazon Bedrock.
- Databricks Solutions Accelerator: A deployable Databricks project that routes tracks through MCP, A2A or the REST API with a shared audit trail.
- Open-source real-time pipeline: A reference pipeline built only on open-source tools: MinIO, Kafka, FFmpeg, Valkey and server-sent events.
Formats and delivery
Eclipsa Audio, IAMF, Dolby Atmos, ADM, Ambisonics, binaural and where to publish.
- Immersive audio formats compared: Eclipsa Audio, Dolby Atmos, Sony 360 Reality Audio, MPEG-H, DTS:X and Apple Spatial Audio side by side.
- Eclipsa Audio and IAMF reference: The open IAMF container: audio elements, mix presentations, codecs, profiles and how Eclipsa Audio uses it.
- ADM BWF files: The Audio Definition Model and Broadcast Wave files: structure, metadata and how to validate a master.
- Ambisonics: Scene-based audio: orders, channel ordering, normalization, decoding and when to use it.
- Binaural rendering, headphones and speakers: HRTFs, head tracking, headphone and speaker playback, and how to check a mix on both.
- Publishing and delivery: Where immersive audio can be published, what each platform expects and how to deliver to YouTube.
Mixing standards
Professional rules for immersive mixes, stems, upmixing and genre approaches.
- Immersive mixing best practices: Ten non-negotiable rules for mixing music in 3D, with checks you can run on every mix.
- Creative thinking and listener fatigue: Methods for generating spatial ideas while keeping long listening sessions comfortable.
- Upmixing stereo vs mixing from stems: When to upmix a finished stereo master, when to work from stems, and how stem separation fits in.
- Preparing and exporting stems: File formats, naming, alignment and headroom rules for stems that spatialize cleanly.
- Genre guides: How spatial approaches change by genre, with links to more than 200 genre-specific guides.
Science and research
Psychoacoustics, the spatial audio ontology and the research behind the engine.
- How we hear in 3D: Interaural cues, spectral cues, distance, precedence and the psychoacoustic limits every mix must respect.
- Spatial audio ontology: The formal model Spatial9 uses to describe sources, scenes, positions, motion and renders.
- Spatial inference and GravityLLM: How the engine decides where each sound goes, and how the model learns from mixes.
- AI spatial audio research: A structured map of the research behind AI spatial audio and where Spatial9 builds on it.
Reference
Answers to common questions and fixes for common problems.
- FAQ and troubleshooting: Answers to the most common questions and step-by-step fixes for common problems.