Beatoven.ai is an Indian generative-music startup (Bengaluru, founded 2021) building text-to-music and text-to-sound-effects models for video creators, podcasters, game developers, and brands. Its Maestro Music and Maestro SFX models render royalty-free background tracks and foley from natural-language prompts, with downloads delivered as mp3, aac, or wav plus separately rendered stems (bass, chords, melody, percussion). Beatoven is Fairly Trained certified.
URL: Visit APIs.json
Run: Capabilities Using Naftiko
- AI, Artificial Intelligence, Music, Music Generation, Generative Audio, Text To Music, Text To SFX, Royalty-Free Music, Background Music, Video Creators, Podcasts, Stems, Fairly Trained, India
- Created: 2026-05-24
- Modified: 2026-05-24
Asynchronous REST API for composing tracks from natural-language prompts.
POST /api/v1/tracks/compose returns a task_id; poll GET /api/v1/tasks/{task_id}
until status is composed. The completed response returns a master track_url
plus a stems_url object with bass, chords, melody, and percussion URLs.
Supports mp3, aac, and wav output and an optional looping flag.
Bearer-token auth.
Base URL: https://public-api.beatoven.ai
Human URL: https://github.com/Beatoven/public-api/blob/main/docs/api-spec.md
- Documentation - API Spec
- Documentation - API product page
- OpenAPI
- JSON Schema - Track
- JSON Schema - Compose Request
- JSON-LD
- Spectral Rules
- Example - Compose Request
- Example - Compose Response
- Example - Task Status Response
- Naftiko Capability - Tracks (Compose)
- Naftiko Capability - Tasks (Status)
- GitHub - public-api
- Python SDK
- Python compose example
- Make.com integration
| Verb | Path | Operation |
|---|---|---|
| POST | /api/v1/tracks/compose | Compose A Track From A Prompt |
| GET | /api/v1/tasks/{task_id} | Get Composition Task Status |
- Plans and Pricing - Trial, Creator ($10/mo), Visionary ($20/mo), Pay-as-You-Go ($3/minute), and Public API (contract).
- Rate Limits - Per-customer quotas issued at API key provisioning. The public API spec does not document a 429 throttling response; clients must poll task status rather than retry compose.
- FinOps - FOCUS-aligned cost model. Two billing surfaces: per-seat subscription + downloaded-minutes (web product), and contract-priced enterprise (API).
HTTP Authorization: Bearer <BEATOVEN_API_KEY> on every request. Keys are
issued via the API dashboard or by
emailing hello@beatoven.ai.
curl -X POST https://public-api.beatoven.ai/api/v1/tracks/compose \
-H "Authorization: Bearer ${BEATOVEN_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"prompt":{"text":"30 seconds peaceful lo-fi chill hop track"},"format":"wav","looping":false}'The response contains a task_id; poll until composed:
curl -H "Authorization: Bearer ${BEATOVEN_API_KEY}" \
https://public-api.beatoven.ai/api/v1/tasks/${TASK_ID}- Python SDK - async/await client, install via
pip install -e "git+https://github.com/Beatoven/public-api.git/#subdirectory=sdk". - Make.com - Create and Compose Track, Composition Status, and generic API Call modules.
- Kin Lane - kin@apievangelist.com - apievangelist.com