Crazyrouter의 Suno SDK는 단일 모델이 아니라, 여러 음악 생성 및 편집 태스크 (Task)를 묶은 모델 패밀리 (Model Family)로 취급하는 것이 자연스럽습니다.

주요 모델은 다음과 같습니다.

suno/generate
suno/extend
suno/upload-extend
...

실무 구현에서는 처음부터 모든 것을 UI에 노출해서는 안 됩니다. 먼저 suno/generate를 안정화하고, 그 결과로 얻어지는 audio_url이나 태스크 ID (Task ID)를 확인한 뒤 파생 기능을 개방하는 것이 안전합니다.

1. suno/generate
2. 생성 결과의 audio_url 다운로드 검증
3. audioId / audio_url / task_id 저장
...

왜냐하면 후속 기능은 전 단계의 생성 결과에 의존하는 경우가 많기 때문입니다. generate의 결과에 안정적인 오디오 URL이나 ID가 없다면, extend나 cover는 UI 상에서 활성화해서는 안 됩니다.

Suno 통합 태스크 (Unified Task)에서는 버전을 model_version으로 지정합니다.

V5_5
V5
V4_5PLUS
...

이전 루트에서 사용되는 mv와 혼동하지 않도록 주의해야 합니다.

suno/generate는 가장 먼저 연결해야 할 기본 기능입니다.

용도:

가사로부터 곡을 만들기
음악 스타일 설명을 통해 데모 곡 만들기
광고나 영상용 짧은 음악 생성하기
...

최소 테스트에서는 태스크 전송과 폴링 (Polling)에 더해, resultJson.data[0].audio_url의 다운로드까지 확인합니다.

extend는 기존 음원을 연장하는 기능, cover는 기존 음원을 다른 스타일로 변환하는 기능이라고 생각하면 이해하기 쉽습니다.

두 기능 모두 다음 정보에 의존합니다.

원래의 audio URL
원래의 task_id
상위 단계에서 반환하는 audioId 상당의 식별자

이러한 정보가 없는 경우, 프론트엔드 (Frontend)에서 버튼을 표시하더라도 실패율만 높아질 뿐입니다.

타임스탬프 가사나 보컬 분리 (Vocal Separation)는 생성 본체보다 필드 의존성이 강한 기능입니다. 첫 릴리스 (Release)에서는 옵션으로 취급하여, 소수의 실제 데이터로 검증한 뒤 공개하는 것을 권장합니다.

체크 항목	합격 조건
전송	task_id가 반환됨
폴링 (Polling)	종료 상태를 올바르게 처리함
다운로드	audio_url이 HTTP 200을 반환함
파일 검증	audio/* 타입이며 충분한 크기임
파생 기능	필요한 ID와 URL이 저장되어 있음
실패 분류	task_failed와 content_unavailable을 구분함

Suno SDK는 우선 generate를 안정화하는 것부터 시작해야 합니다. 태스크가 성공한 것만으로는 불충분하며, audio_url의 취득, 다운로드, 저장까지가 최소한의 실무 단위입니다.

그 후에 extend, cover, 타임스탬프 가사, 보컬 분리를 단계적으로 개방하는 것이 사고를 가장 줄일 수 있는 진행 방식입니다.