# Tunova

> Prepaid REST API + MCP server for Suno AI music generation (models v6, v5.5).
> You pay only for songs that actually render: 1 song = 10 tokens, lyrics = 2 tokens;
> a failed render auto-refunds. Auth is a single `X-API-Key` header. 50 free tokens on
> signup, no card. This host (api.tunova.ai) is the API; sign up + billing live at https://tunova.ai.

## Docs
- [API reference](https://api.tunova.ai/docs): endpoints, auth, errors, HMAC-signed webhooks
- [OpenAPI 3.1 spec](https://api.tunova.ai/openapi.json): machine-readable, the source of truth
- [MCP server](https://api.tunova.ai/mcp): POST JSON-RPC (streamable-http); tools generate_song, wait_for_song, check_song; same `X-API-Key`
- [Authentication](https://api.tunova.ai/.well-known/auth.md): how to get and use a key

## Workflow
- POST /api/generate `{"prompt":"..."}` (optional `model`: v6 | v5.5) → 202 `{job_id, status_url}`.
- Use `model: "v6"` for Suno v6. `v5.5` remains a compatibility alias for the same v6 model, at the same cost; omitted-model requests keep their existing default.
- Read the current partner token balance with GET /api/balance using the same X-API-Key.
- Poll GET /api/jobs/{job_id} every ~10s (a render takes ~1-3 min) until `status: "complete"` → `clips[].audio_url`. `status: "failed"` refunds the 10 tokens automatically.
- Custom lyrics: POST /api/custom_generate `{"prompt": <your lyrics>, "tags": <style>, "title": <title>}`.
- Lyrics only: POST /api/lyrics (2 tokens). Send an `Idempotency-Key`; the normal response is synchronous, while an in-progress recovery returns a job id you can poll without another provider submission.

## Pricing (prepaid tokens, billed only on a successful render)
- Starter: $10 = 1,000 tokens — 100 songs ($0.10/song)
- Plus: $25 = 2,750 tokens — 275 songs (~$0.091/song) · +10% bonus
- Pro: $50 = 6,000 tokens — 600 songs (~$0.083/song) · +20% bonus
- Max: $100 = 13,000 tokens — 1,300 songs (~$0.077/song) · +30% bonus
- Tokens never expire. No subscription. Crypto top-up (USDT, BTC and more via OxaPay).
- Sign up at https://tunova.ai/sign-up for 50 free tokens (no card).

## Optional
- [Terms](https://tunova.ai/terms)
- [Privacy](https://tunova.ai/privacy)
- [Refunds](https://tunova.ai/refunds)