Generate Music
Generate original music with Suno models using inspiration mode or custom lyrics, style, and title controls.
Use the unified API in One gateway for all Suno routes.
Send your API key in the Authorization header.
Cost depends on selected Suno model tier.
/api/v1/audio/musicCreate Music Task
Start a new Suno music generation task.
This endpoint supports two generation modes. Inspiration mode uses a compact description and lets the model infer lyrics and style. Custom mode gives you direct control over lyrics, musical style, title, and instrumental output.
- Use gpt_description_prompt for inspiration mode.
- Use prompt, style, and title for custom mode.
- Poll the Feed API or generic task status endpoint for final audio URLs.
Common Parameters
AI model to use. Options: chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5, chirp-v5-5. Defaults to chirp-v3-5.
Generate instrumental music without vocals. Defaults to false.
Optional webhook URL to receive real-time results via POST.
Inspiration Mode
Generate music from a text description.
Text description of the music you want to generate. Max length: 400 chars.
Custom Mode
Generate music with custom lyrics, style, and title.
Custom lyrics or detailed prompt. Max length: 3000 chars (5000 chars for v4-5).
Musical style/genre. Max length: 200 chars (1000 chars for v4-5/v5-0).
Song title. Max length: 80 characters.
Negative tags to avoid in generation.
cURL Example
| 1 | curl -X POST "https://apiin.one/api/v1/audio/music" \ |
| 2 | -H "Authorization: Bearer aio_your_api_key_here" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "model": "chirp-v4-5", |
| 6 | "prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me", |
| 7 | "style": "pop, upbeat, electronic, 120 bpm", |
| 8 | "title": "Summer Dreams", |
| 9 | "make_instrumental": false |
| 10 | }' |
Task Response
The API returns a task ID immediately. Poll the Feed endpoint to retrieve final audio outputs.
| 1 | { |
| 2 | "task_id": "gen123abc456def789ksv", |
| 3 | "status": "pending", |
| 4 | "model": "chirp-v4-5", |
| 5 | "created_at": "2026-02-24T12:00:00Z" |
| 6 | } |
Error Handling
API in One uses consistent authentication, credit, and validation errors across Suno endpoints.
Invalid parameters, missing required fields, or validation error.
Invalid or missing API key.
Insufficient balance to perform generation.