FOR DEVELOPERS
Sonvi API
Bring the Sonvi catalog into your own product. Search and stream AI-generated songs, upload new tracks and let your users rate, favorite and request songs, all through one REST API.
Read the API reference · Request an API key
What you can do
Browse the catalog
Full-text search, trending and latest lists, genres, languages, recommendations and song details with lyrics.
Scope: catalog:read
Stream and download
Stream audio with HTTP range requests, download MP3 files and load cover images.
Scope: media:read
Upload songs
Upload MP3s with metadata and lyrics on behalf of your users and follow their moderation status.
Scope: tracks:write
Engage your users
Ratings, reports, favorites, song requests and “your song is ready” notifications, kept separate for each of your users.
Scope: social:write
Acting for your users
Send your own user ID in the X-End-User-Id header. Sonvi creates a matching account on first use, so ratings, favorites and uploads stay per person and never mix with other partners.
Rate limits
Each key allows 120 requests per minute by default. Every response reports the remaining quota in X-RateLimit-* headers, and higher limits are available on request.
Quick start
Keep your key on your server and send it in the X-API-Key header:
curl "https://api.sonvi.ai/api/search?q=love&limit=5" \
-H "X-API-Key: sk_live_xxxxxxxx_your_secret" \
-H "X-End-User-Id: user-123"Get an API key
Keys are issued by the Sonvi team. Email us with your product, expected traffic and the scopes you need.