{"protocolVersion":"0.3.0","name":"Spatial9 Spatial Audio Agent","description":"Turns a stereo song or a video into immersive Eclipsa Audio (IAMF) with a binaural headphone version, separates songs into instrument stems, converts Dolby (AC-3, E-AC-3, TrueHD) and ADM BWF files to Eclipsa Audio, and makes a free 30-second chorus headphone preview. Renders run in the background: a song usually takes 10 to 20 minutes. Follow a task with message/stream or tasks/resubscribe (streams through spatial9.ai close after about 20 seconds; call tasks/resubscribe again to keep following), register a push notification webhook (https, public host, port 443), or poll tasks/get every 30 to 60 seconds. Each render uses one project from the Spatial9 plan of the signed-in account and is refunded if it fails. Limits: 3 renders at once, 20 per 24 hours.","url":"https://spatial9.ai/a2a","preferredTransport":"JSONRPC","additionalInterfaces":[{"url":"https://spatial9.ai/a2a","transport":"JSONRPC"}],"provider":{"organization":"Spatial9","url":"https://spatial9.ai"},"iconUrl":"https://spatial9.ai/favicon-512.png","version":"1.17.0","documentationUrl":"https://spatial9.ai/blog/agentic-ai-platforms-a2a-spatial9-integrations","capabilities":{"streaming":true,"pushNotifications":true,"stateTransitionHistory":false},"securitySchemes":{"spatial9_key":{"type":"http","scheme":"bearer","description":"A personal Spatial9 key (starts with s9_) created at https://spatial9.ai/connect. Send it as Authorization: Bearer s9_... or X-API-Key."},"spatial9_oauth":{"type":"oauth2","description":"Sign in to Spatial9 with OAuth 2.1 and PKCE. Clients register at the registration endpoint first.","flows":{"authorizationCode":{"authorizationUrl":"https://spatial9.ai/oauth/authorize","tokenUrl":"https://spatial9.ai/oauth/token","scopes":{"spatial_audio":"Create and read your Spatial9 renders"}}}}},"security":[{"spatial9_key":[]},{"spatial9_oauth":["spatial_audio"]}],"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["application/json","audio/wav","video/mp4","application/octet-stream"],"skills":[{"id":"spatial_audio","name":"Make immersive Eclipsa Audio","description":"Stereo song (WAV, MP3, FLAC, AIFF, M4A): separates the instruments, places them in 3D and delivers Eclipsa Audio (IAMF), Eclipsa Audio in MP4, a YouTube-ready MP4 and a binaural WAV, plus a stage player link. Video (MP4, MOV, WEBM): delivers the YouTube-ready MP4 with Eclipsa Audio inside, a 3rd-order Ambisonics WAV and a headphone version. Optional data fields: source_url, upload_id, media_type (\"music\" or \"video\"), title, style, include_video, include_binaural.","tags":["spatial audio","immersive audio","Eclipsa Audio","IAMF","binaural","music","video"],"examples":["Make an immersive mix of https://example.com/song.wav","Turn this video soundtrack into spatial audio: https://example.com/clip.mp4"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","audio/wav","video/mp4","application/octet-stream"]},{"id":"split_stems","name":"Split a song into stems","description":"Separates a mixed song into instrument stems and delivers each one as a WAV file. Usually 4 to 8 minutes. Optional data fields: source_url, upload_id, title.","tags":["stem separation","stems","music"],"examples":["Split https://example.com/song.mp3 into stems"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","audio/wav"]},{"id":"convert_dolby","name":"Convert Dolby or ADM to Eclipsa Audio","description":"Converts AC-3, E-AC-3, TrueHD or an ADM BWF master to Eclipsa Audio. For AC-3, E-AC-3 and TrueHD the speaker channels (up to 7.1) are decoded; the Dolby Atmos height and object layer is not kept. ADM BWF masters keep their beds and objects through the Spatial9 Spatializer. Optional data fields: source_url, upload_id, title.","tags":["Dolby","ADM BWF","conversion","Eclipsa Audio"],"examples":["Convert this Dolby file to Eclipsa Audio: https://example.com/film.ec3"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","application/octet-stream","video/mp4","audio/wav"]},{"id":"preview_chorus","name":"Free chorus headphone preview","description":"Free, uses no project: finds the chorus of a song and returns a 30-second binaural headphone WAV. Usually under two minutes. Optional data fields: source_url, upload_id, start.","tags":["preview","binaural","free"],"examples":["Preview the chorus of https://example.com/song.wav in spatial audio"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","audio/wav"]},{"id":"upload_link","name":"Get an upload link","description":"Returns an upload_id and a direct_upload_url (HTTP PUT, up to 2 GB, valid 2 hours) for a file that is not online yet. Data fields: filename (required), media_type.","tags":["upload"],"examples":["I need to upload song.wav"],"inputModes":["text/plain","application/json"],"outputModes":["application/json"]}]}