@taskmagic/apps-soundverse
v0.1.0
Published
AI music, vocals and audio analysis with [Soundverse](https://www.soundverse.ai).
Readme
Soundverse
AI music, vocals and audio analysis with Soundverse.
Docs index: https://help.soundverse.ai/llms.txt
API overview: https://help.soundverse.ai/api_documentation.md
Base URL: https://api.soundverse.ai
Do not build against
https://help.soundverse.ai/api-reference/openapi.json— it is still Mintlify's "Plant Store" sample template and describes none of this API.
Connection: an API key from the API Dashboard, sent as Authorization: Bearer <key>.
Soundverse documents no key prefix, so the connection screen does not claim one.
Actions
| Action | Endpoint | Docs |
|---|---|---|
| Generate Song | POST /v7/generate/song/sync | ai-song-gen-v7 |
| Generate Instrumental Music | POST /v6/generate/music/sync | ai-music-gen-v6 |
| Generate Singing Vocals | POST /v2/generate/ai-singing-gen | ai-singing-gen-v2 |
| Separate Stems | POST /v1/generate/stem-separation/{type} | stem-separation |
| Get Generation Status | GET /v5/status?message_id= | api_documentation |
Every route above has been probed with a deliberately bad key and answers 403 — the route exists and only the credential was rejected. A 404 would mean the route does not exist.
Streaming vs sync
Each generation route has a default variant that streams Server-Sent Events and a /sync twin
that returns one JSON body. A flow step cannot hold a stream open, so this piece always calls
/sync. The trade-off is that the step blocks until the audio is ready.
Get Generation Status re-checks a message_id afterwards — useful for resuming a generation
started elsewhere, or re-reading a result without paying to generate it again.
Billing
Generation is billed per call, and Soundverse documents no idempotency mechanism — a step
retry generates and bills again. Earlier versions of this piece sent an Idempotency-Key header
and claimed it deduplicated; nothing in the docs supports that, so the header is gone rather than
left as a false guarantee.
There is no account/balance endpoint. Check credit in the API Dashboard.
No triggers
Soundverse publishes no webhook or subscription API.
