---
title: "Earthsong Sonify"
method: POST
path: "/api/v1/cross/earthsong/sonify"
tags: ["EarthSong Sonification"]
---

# Earthsong Sonify

`POST /api/v1/cross/earthsong/sonify`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/cross/earthsong/sonify`
- Auth: none declared

Generate full sonification parameters for a location.

Returns per-channel audio synthesis parameters (frequency, amplitude,
pan, ADSR envelope, effects) for client-side Web Audio API rendering.
Does NOT return actual audio -- synthesis is done in the browser.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- EarthSongRequest: Request body for EarthSong sonification.
  - `lat` number, required: Latitude (WGS-84) for Earth state sampling
  - `lon` number, required: Longitude (WGS-84) for Earth state sampling
  - `preset` string: Sonification preset: meditation, discovery, minimal, full_orchestra
  - `duration_seconds` number: Target sonification duration in seconds

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)