개요

Suno API 문서

기본 정보

API 엔드포인트

• 기본 주소:

  https://{BASE_URL}/suno/submit/music
  https://{BASE_URL}/suno/fetch

모델 지원

지원 모델

• chirp-v3-0 (버전 v3.0)
• chirp-v3-5 (버전 v3.5)
• chirp-v4 (버전 v4.0)
• chirp-auk (버전 v4.5)
• chirp-v5 (버전 v5.0)

콜백 알림

• notify_hook 콜백 URL 지원
• 요구 사항:
  • 메서드: POST
  • 수신 데이터: task 데이터 구조

사용 단계

1. Suno 작업 생성

2. 작업 진행 상황 조회

데이터 구조

Task 객체

필드	타입	예시	설명
task_id	string	f4a94d75-087b-4bb1-bd45-53ba293faf96	작업 ID
action	string	MUSIC	작업 유형: MUSIC(곡 생성), LYRICS(가사 생성)
status	string	SUCCESS	작업 상태: NOT_START(미시작), SUBMITTED(제출됨), QUEUED(대기), IN_PROGRESS(진행 중), FAILURE(실패), SUCCESS(성공)
submitTime	number	1689231405854	제출 시각
startTime	number	1689231442755	시작 시각
finishTime	number	1689231544312	종료 시각
failReason	string	[Invalid parameter] Invalid value	실패 사유(실패 시)
data	object	-	데이터: 음악(배열), 가사(단일 객체)

음악 이어쓰기

• 작업을 지정하려면 task_id 매개변수가 필요합니다