Suno 음악 생성 Beta

모델 이름

하위 호환성: 이전에 통합된 모델명(예: suno-v5, suno-v4.5, suno-v4.5plus, suno-v4.5all, suno-v4)은 계속 사용 가능하며, 해당 -beta 버전으로 자동 매핑됩니다

사용 가능한 옵션:

• suno-v5-beta: V5 최신 버전 (기본 권장), Voice Persona 지원, 뛰어난 음악 표현력, 더 빠른 생성, 프롬프트 최대 5000자, 스타일 최대 1000자
• suno-v4.5plus-beta: V4.5+ 향상 버전, 더 풍부한 톤, 새로운 창작 방법, 최대 8분, 프롬프트 최대 5000자, 스타일 최대 1000자
• suno-v4.5all-beta: V4.5 전체 기능 버전, 더 스마트한 프롬프트, 더 빠른 생성, 최대 8분, 프롬프트 최대 5000자, 스타일 최대 1000자
• suno-v4.5-beta: V4.5 버전, 더 스마트한 프롬프트, 더 빠른 생성, 최대 8분, 프롬프트 최대 5000자, 스타일 최대 1000자
• suno-v4-beta: V4 버전, 향상된 보컬 품질, 최대 4분, 프롬프트 최대 3000자, 스타일 최대 200자

커스텀 모드 활성화

설명:

• false: 심플 모드, prompt만 제공하면 AI가 가사와 스타일을 자동 생성
• true: 커스텀 모드, style, title, 가사 등을 세밀하게 제어 가능

커스텀 모드 필수 파라미터:

• style: 필수
• title: 필수
• prompt: instrumental=false일 때 필수 (가사로 사용)

인스트루멘탈 음악 생성 (보컬 없음)

설명:

• false: 보컬이 포함된 음악 생성
• true: 보컬 없는 인스트루멘탈/배경 음악 생성

참고:

• 비커스텀 모드에서는 이 파라미터가 필수 필드에 영향을 주지 않습니다
• 커스텀 모드에서 true로 설정하면 prompt가 선택 사항이 됩니다

프롬프트, 원하는 음악 내용을 설명합니다

비커스텀 모드 (custom_mode=false):

• 필수, 음악 설명으로 사용되며 AI가 가사와 스타일을 자동 생성
• 최대 길이: 500자

커스텀 모드 (custom_mode=true):

• instrumental=false일 때 필수, 정확한 가사로 사용
• instrumental=true일 때 선택 사항
• 최대 길이: V4는 3000자, V4.5+는 5000자

가사 형식 제안:

• [Verse], [Chorus], [Bridge] 등의 태그로 가사 구조를 구성하세요

음악 스타일 지정

설명:

• 사용자 정의 모드(custom_mode=true)에서 필수
• 음악의 장르, 분위기 또는 예술적 방향을 정의합니다
• 영어로 쉼표로 구분된 태그 사용을 권장합니다

문자 제한:

• V4: 최대 200자
• V4.5+: 최대 1000자

일반적인 스타일 태그:

• 장르: pop, rock, jazz, classical, electronic, hip-hop, r&b, country, folk
• 분위기: happy, sad, energetic, calm, romantic, dark, uplifting
• 악기: piano, guitar, drums, bass, violin, saxophone, synthesizer
• 보컬: male vocals, female vocals, choir, harmonies
• 템포: slow, fast, upbeat, groovy, 120bpm

곡 제목

설명:

• 사용자 정의 모드(custom_mode=true)에서 필수
• 플레이어 인터페이스 및 파일명에 표시됩니다
• 최대 길이: 80자

제외 스타일, 피하고 싶은 음악 스타일이나 특성을 지정합니다

예시:

• heavy metal, screaming, sad
• rap, fast tempo

보컬 성별 선호

옵션:

• m: 남성 목소리
• f: 여성 목소리

참고:

• custom_mode=true일 때만 적용됩니다
• 이 매개변수는 확률만 높이며, 지정된 성별이 반드시 따라지는 것을 보장하지 않습니다

스타일 가중치, 지정된 스타일에 대한 준수도를 제어합니다

범위: 0.0 ~ 1.0, 소수점 한 자리

설명:

• 높은 값일수록 지정된 스타일에 더 가깝게 준수합니다
• 0 값은 미설정으로 처리됩니다

기이함 제약, 출력의 창의성/실험적 정도를 제어합니다

범위: 0.0 ~ 1.0, 소수점 한 자리

설명:

• 높은 값일수록 더 창의적이고 실험적인 출력
• 낮은 값일수록 더 전통적이고 보수적인 출력
• 0 값은 미설정으로 처리됩니다

오디오 가중치, 오디오 특성의 가중치를 제어합니다

범위: 0.0 ~ 1.0, 소수점 한 자리

설명:

• 0 값은 미설정으로 처리됩니다

Persona ID, 이미 생성된 Persona 스타일을 이번 음악 생성에 적용합니다

custom_mode=true일 때만 사용 가능합니다. Suno Persona 생성 API를 통해 획득하며, 적용 후 일관된 보컬 및 스타일 특성을 유지할 수 있습니다

획득 방법: Persona 작업 완료 후 result_data.persona_id에서 가져옵니다

Persona 적용 방식

옵션:

1. style_persona: 스타일 지향형, 음악 스타일 특성(편곡, 리듬, 음색)에 중점, 모든 모델 버전 지원
2. voice_persona: 보컬 지향형, 보컬 특성(음색, 창법, 음역)에 중점, V5만 지원

custom_mode=true일 때만 사용 가능하며, 일반적으로 persona_id와 함께 사용합니다. voice_persona 사용 시 모델이 suno-v5-beta여야 하며, 그렇지 않으면 오류가 반환됩니다

작업 완료 알림을 위한 HTTPS 콜백 URL

콜백 단계:

• 콜백 프로세스는 세 단계로 구성: text (텍스트 생성), first (첫 번째 트랙 완료), complete (모두 완료)
• 경우에 따라 text 및 first 단계가 건너뛰어지고 complete가 직접 반환될 수 있음

보안 제한:

• HTTPS 프로토콜만 지원
• 내부 IP 주소로의 콜백 금지
• URL 길이는 2048자를 초과할 수 없음

콜백 메커니즘:

• 타임아웃: 10초
• 실패 시 최대 3회 재시도
• 콜백 URL이 2xx 상태 코드를 반환하면 성공으로 간주

작업 생성 타임스탬프

작업 ID, 작업 상태 및 결과를 조회하는 데 사용됩니다

실제 사용된 모델 이름

작업 유형

작업 진행률 (0-100)

작업 상태

작업 출력 유형