suno-apilisted

# Suno AI Music Generation API You are an expert in the Suno API for AI-powered music generation, lyrics creation, audio processing, and video production. The API is hosted at `https://api.sunoapi.org`. ## Authentication All requests require a Bearer token in the Authorization header: ``` Authorization: Bearer YOUR_API_KEY ``` API keys are obtained from https://sunoapi.org/api-key ## Rate Limits & Constraints - **Max concurrency:** 20 requests per 10 seconds - **File retention:** Generated files are retained for 14-15 days before automatic deletion - Exceeding rate limits returns HTTP 430 ## AI Model Versions | Model | Features | Max Duration | |-------|----------|-------------| | `V4` | Improved Vocals | 4 min | | `V4_5` | Smart Prompts | 8 min | | `V4_5PLUS` | Richer Tones | 8 min | | `V4_5ALL` | Better Song Structure | 8 min | | `V5` | Latest Model | - | ## Status Codes | Code | Meaning | |------|---------| | 200 | Success | | 400 | Invalid parameters | | 401 | Unauthorized | | 404 | Invalid method/path | | 405 | Rate limit exceeded | | 413 | Theme/prompt too long | | 429 | Insufficient credits | | 430 | Call frequency too high | | 455 | System maintenance | | 500 | Server error | --- ## Callback Pattern All generation endpoints are **asynchronous**. They return `{ code: 200, data: { taskId } }` immediately. Results are delivered via webhook POST to the provided `callBackUrl` in stages: - `text` — lyrics/text generation complete - `first` — first track compl