Create Options

Official suno.com Create mapped to /suno/v2/generate. Slider / Max Mode fields below are optional — omit them to keep previous behavior and pricing. task=create itself has two modes (Custom vs Simple). See Generate Music. Do not send agentic_thinking or create_mode.

Custom vs Simple (`task=create`)

Official Create	How to hit it
Custom (you write lyrics)	Non-empty `prompt`
Simple (idea box)	Omit `prompt` (or `""`), omit `persona`, and send at least one of `gpt_description_prompt` / `audio_refs` / `attached_styles` / `attached_lyrics` / `image_urls` / `video_url`

Empty prompt with none of those six fields stays Custom.

Official Simple UI	API
Idea text box	`gpt_description_prompt`
Attach existing songs (1–4 chips)	`audio_refs` — `clip_id` required; ByModel (no same-account requirement)
Attached style paragraph	`attached_styles`
Pinned lyrics (stays Simple)	`attached_lyrics` — keep `prompt` empty; a non-empty `prompt` ignores this field
Images (1–5)	`image_urls`
One reference video	`video_url` — one mp4 URL

audio_refs with prompt or persona is HTTP 400. Other-user clips may be remix / non-commercial download.

Use with Generate Music. Check fields per task via Generate Schema.

Official UI → API

Official Create	API field	Notes
Max Mode	`max_mode`	`true` = more compute, more consistent song. 2× official credits; platform bills 2× when `max_mode=true`. Default omit / `false` = current price. Supported on song-generation tasks (`create` / `extend` / `cover` / `mashup` / `add_stems`, …). *`true` on `gen_stem_` or `sound` returns HTTP 400**
Personalize / My Taste	`use_personalization`	Uses the picked official account’s taste profile. Effect is not guaranteed (pool accounts may have no taste data). Default omit / `false`
Vocal Gender	`vocal_gender`	`m` / `f`. Omit = no preference
Exclude styles	`negative_tags`	string or string[]
Style Influence	`controls.style_weight`	0~1
Weirdness	`controls.weirdness_constraint`	0~1; higher = more experimental
Variety	`controls.aug_creativity`	Integer 0~4. `2` = Normal (suno.com default), `4` = slider max. Omit = official default
Duration Custom	`controls.duration`	Seconds 10~360. Auto = omit. chirp-v55 / chirp-v6+; older / `chirp-custom:*` ignore it
Audio influence (cover / extend)	`controls.audio_weight`	0~1

max_mode: true doubles user billing via a platform cost rule. Do not send it unless you intend the extra cost.

Example

curl -X POST https://api.mountsea.ai/suno/v2/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "task": "create",
    "model": "chirp-v6",
    "prompt": "[Verse]\nHello world...",
    "tags": "Pop, Happy",
    "negative_tags": "Sad, Slow",
    "vocal_gender": "f",
    "max_mode": false,
    "use_personalization": false,
    "controls": {
      "style_weight": 0.29,
      "weirdness_constraint": 0.37,
      "aug_creativity": 2,
      "duration": 110
    }
  }'