Suno API
activeFull-featured AI music generation platform. Supports text-to-music, extend tracks, upload audio covers, generate cover images, and timestamped lyrics. 7 API endpoints.
Quick Start
Send a request to the Suno API:
| 1 | curl -X POST https://apiin.one/api/v1/audio/music \ |
| 2 | -H "Authorization: Bearer YOUR_API_KEY" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "model": "chirp-v4-5", |
| 6 | "prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm", |
| 7 | "style": "pop, upbeat", |
| 8 | "make_instrumental": false, |
| 9 | "title": "Summer Days" |
| 10 | }' |
API Endpoint
/api/v1/audio/musicSend a POST request with your API key to generate content using Suno.
Headers
Bearer YOUR_API_KEY
application/json
Body Parameters
Model identifier: suno
Music description (inspiration mode) or lyrics (custom mode). Max 5000 chars.
Text description for inspiration mode. Max 400 chars for v4.
Model: chirp-v4-0 (5cr), chirp-v4-5 (10cr), chirp-v4-5-plus (10cr), chirp-v5 (12cr) Defaults to chirp-v3-5.
Music style/genre (custom mode). Max 1000 chars.
Track title. Max 80–100 chars.
Generate instrumental only (no vocals) Defaults to false.
Preferred vocal gender: male or female
Style adherence strength (0–1)
Creative deviation control (0–1)
Audio feature balance (0–1)
Webhook URL for result notification
Available Endpoints
8 endpoints available for this model. All endpoints use the same API key.
Example Request
| 1 | { |
| 2 | "model": "chirp-v4-5", |
| 3 | "prompt": "A cheerful pop song about summer days, with catchy melody and upbeat rhythm", |
| 4 | "style": "pop, upbeat", |
| 5 | "make_instrumental": false, |
| 6 | "title": "Summer Days" |
| 7 | } |
Example Response
Successful task creation response.
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "gen2abc123def456bksv", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
Check Task Status
For asynchronous tasks, poll the status endpoint to check when your task is complete:
/api/v1/tasks/{task_id}Returns the current status of a generation task. Poll until status is 'completed' or 'failed'.
| 1 | curl https://apiin.one/api/v1/tasks/task_abc123 \ |
| 2 | -H "Authorization: Bearer aio_your_key" |
Use Cases
- ✓Generate original music from text prompts or custom lyrics
- ✓Extend existing tracks with new content or different styles
- ✓Upload audio files and create AI cover versions
- ✓Generate album cover images for tracks
- ✓Get word-level timestamped lyrics for karaoke/player UIs
- ✓Build AI-powered music creation tools and apps
API Tester
Test the Suno API directly from your browser:
Error Codes
| 1 | { |
| 2 | "error": { |
| 3 | "code": 400, |
| 4 | "message": "Invalid parameters", |
| 5 | "type": "invalid_request" |
| 6 | } |
| 7 | } |
Frequently Asked Questions
How much does the Suno API cost?
Credits depend on model and endpoint: chirp-v4 = 5cr, chirp-v4.5 = 10cr, chirp-v5 = 12cr. Upload-cover = 8–12cr. Cover images = 1cr. Timestamped lyrics = 2cr.
What API endpoints are available?
7 endpoints: /v2/generate (create music), /v2/extend (extend tracks), /v2/feed (poll status), /v2/cover/generate+status (cover images), /v2/upload-cover/generate+status (audio covers), /v2/timestamped-lyrics (word-level lyrics).
Can I extend an existing song?
Yes. Use /v2/extend with a completed task ID. Supports inherit mode (seamless continuation) or custom mode (change style/lyrics).
Can I upload my own audio and create a cover?
Yes. Use /v2/upload-cover/generate to upload audio (max 8 min) and generate an AI cover with new vocals, style, and lyrics.
What model versions are available?
chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v4-5-all, and chirp-v5. Each version offers different quality tiers and pricing.
Do I need a separate Suno account?
No. API in One handles all provider authentication. You only need one API in One key.
Why Use Suno Through API in One?
Related Models
Ready to use Suno?
Get Your API Key →