| Aufforderung | string | A description of the desired audio content. The prompt will be strictly used as the lyrics and sung in the generated track. Max 5000 characters for V6 models. | Hard-hitting rap track with aggressive beat and confident male vocals about winning. |
| Stil | string | Music style specification for the generated audio. | Classical |
| Benutzerdefinierter Modus | boolean | . | true |
| Modell | Enum (10 Optionen) | The AI model version to use for generation. V6 offers enhanced musical expression and natural vocals, V6_MINI is a lightweight/fast variant, and V6_WILD pushes creative boundaries for bolder expression. | V6 |
| Dauer (Sekunden) | int | Track duration in seconds (optional). Range 10–360. Supported in custom mode with model V5_5, V6, V6_MINI, or V6_WILD. Leave unset to let the model choose the duration. | 20 |
| Personen-ID | string | Personen-ID ID () . person_model . | - |
| Personenmodell | Enum (2 Optionen) | What kind of persona_id this is. Set to voice_persona when persona_id is a cloned voice ID from suno-voice-clone. Requires model V5, V5_5, V6, V6_MINI, or V6_WILD. | - |
| Referenzieren Sie Audio-URLs | array | Reference audio track(s) whose melody, rhythm, and mood should inspire the generated music (optional). Duration 6s–30min, up to 500MB per file. Only used in Non-custom Mode (custom_mode set to false); combined with video_urls, must not exceed 10 total attachments. | undefined |
| target URL | array | Reference video whose atmosphere and story should inspire the generated music (optional). MP4/MOV/WEBM, up to 1 file, max 100MB, max 241s. Only used in Non-custom Mode (custom_mode set to false); combined with audio_urls, must not exceed 10 total attachments. | undefined |