| 프롬프트 | 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. |
| 스타일 | string | Music style specification for the generated audio. | Classical |
| 모델 | 열거형(10 옵션) | 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 |
| 기간(초) | 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 |
| 사람 모델 | 열거형(2 옵션) | 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. | - |
| 참조 오디오 URL | 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 |