Generate Music

Generate original music using AI. Supports both inspiration mode (text description) and custom mode (lyrics, style, title).

Endpoint Overview

POST/api/v1/audio/music

Two Generation Modes:

Inspiration Mode: Use gpt_description_prompt to generate music from a text description. The model will automatically write lyrics and pick a style.
Custom Mode: Use prompt, style, and title for detailed control over the exact song output.

Credits: 5–12 credits per generation depending on the model tier.

Parameters

Common Parameters

Parameter	Type	Required	Description
`model`	string	Optional	AI model to use. Options: suno-v3-5, suno-v4-0, suno-v4-0-vip, suno-v4-0-pro, suno-v4-5, suno-v5-0. (Default: suno-v3-5)
`make_instrumental`	boolean	Optional	Generate instrumental music without vocals. (Default: false)
`callback_url`	string	Optional	Optional webhook URL to receive real-time results via POST.

Inspiration Mode

Generate music from a text description.

Parameter	Type	Required	Description
`gpt_description_prompt`	string	Required	Text description of the music you want to generate. Max length: 400 chars.

Custom Mode

Generate music with custom lyrics, style, and title.

Parameter	Type	Required	Description
`prompt`	string	Required	Custom lyrics or detailed prompt. Max length: 3000 chars (5000 chars for v4-5).
`style`	string	Optional	Musical style/genre. Max length: 200 chars (1000 chars for v4-5/v5-0).
`title`	string	Optional	Song title. Max length: 80 characters.
`tags`	string	Optional	Negative tags to avoid in generation.

Example Request

cURL (Custom Mode)

bash

curl -X POST "https://apiin.one/api/v1/audio/music" \
  -H "Authorization: Bearer aio_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v4-5",
    "prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
    "style": "pop, upbeat, electronic, 120 bpm",
    "title": "Summer Dreams",
    "make_instrumental": false
  }'

Example Response

This API returns a task ID immediately. You must poll the Feed endpoint to get the final audio URLs.

json

{
  "task_id": "gen123abc456def789ksv",
  "status": "pending",
  "model": "suno-v4-5",
  "created_at": "2026-02-24T12:00:00Z"
}

Error Handling

Status Code	Type	Required	Description
`400`	invalid_request	Optional	Invalid parameters, missing required fields, or validation error.
`401`	authentication_error	Optional	Invalid or missing API key.
`402`	insufficient_credits	Optional	Insufficient balance to perform generation.