Skip to main content
GET
Suno V6 공통 규칙 및 작업 조회
모든 Suno 생성, 편집 및 도구 API는 비동기 작업을 사용합니다. 작업 제출 후 task_id를 받고 이 페이지의 API로 결과를 조회합니다.

인증

string
필수
Bearer Token 인증: Authorization: Bearer <YOUR_API_KEY>.
API Key 관리 페이지에 접속하여 API Key를 발급받으세요.

V6 버전 및 모델 선택

공개 모델은 다음 버전을 지원합니다.
  • v6
  • v6-wild
  • v6-mini
기본 생성 엔드포인트는 version 또는 모델 생성 작업이 반환한 custom_model_id 중 하나가 필요합니다. 버전을 지원하는 편집 작업은 version 생략 시 v6를 사용합니다. 공개 versioncustom_model_id는 함께 보낼 수 없습니다.
custom: true는 커스텀 가사 모드를, custom_model_id는 학습된 커스텀 모델을 선택합니다. 둘은 다른 개념이며 커스텀 가사 모드가 자동으로 커스텀 모델 요금으로 바뀌지는 않습니다.

V6 공통 생성 옵션

다음 필드는 개별 엔드포인트에 명시된 경우에만 보내세요. 작업이 지원하지 않는 필드는 생략하고 모든 작업에 max_mode: false를 보내지 마세요. variety와 Max 모드는 독립적이므로 variety: "max"를 선택해도 Max 과금이 활성화되지 않습니다.

텍스트 및 가중치 제한

작업 엔드포인트의 새 요청은 weirdness를 사용하고 weirdness_constraint는 호환 별칭입니다. 기본 생성은 계속 weirdness_constraint를 사용합니다. 텍스트 길이는 Unicode 문자 수로 계산합니다.

참조 소스 트랙

기존 작품 기반 작업:
  • task_id: 출력 오디오 트랙의 API Mart 작업 ID.
  • audio_index: 소스 작업 조회 응답의 data.result.music[] 내 원래 위치입니다. 1부터 시작하며 기본값은 1입니다.
배열에 반환된 수만큼 표시하고 결과 수를 2개로 고정하지 마세요. 화면 표시 순서를 바꾸더라도 후속 작업은 원래 결과 배열의 트랙 인덱스를 사용해야 합니다.
새 요청은 task_id + audio_index로 소스 트랙을 참조하며 audio_id, music_id, audio_url로 대체할 수 없습니다. 소스 작업을 찾지 못하거나 인덱스가 범위를 벗어나면 400이 반환됩니다.

제출 응답

data[0].task_id에서 작업 ID를 읽습니다. submitted는 작업이 접수되었다는 뜻일 뿐 최종 오디오나 다른 결과물이 이미 있다는 의미는 아닙니다.

작업 조회

GET /v1/music/tasks/{task_id} ?language=zh를 붙이면 지원되는 실패 메시지 번역을 받을 수 있습니다. 이 파라미터는 곡이나 가사의 언어를 바꾸지 않습니다.
string
필수
제출 API가 반환한 작업 ID.
처음 약 3초 기다린 뒤 data.statuscompleted 또는 failed가 될 때까지 5~10초마다 조회하는 것을 권장합니다. 페이지를 새로고침한 뒤에도 같은 작업 ID를 사용할 수 있습니다. 네트워크 시간 초과 때문에 유료 POST 요청을 자동 재전송하지 마세요.

조회 응답

integer
응답 상태 코드.
object
작업 정보.

결과 처리

  • 음악 관련 결과는 보통 data.result.music[]에 있지만 다운로드, 가사, MIDI, Persona, 커스텀 모델 등은 각기 다른 결과 구조를 사용합니다.
  • duration은 실제 길이이며 소수일 수 있습니다. 입력한 목표 길이와 최종 결과가 정확히 일치한다고 보장되지 않습니다.
  • 가중치 반환값 0은 유효합니다. JavaScript의 falsy 판정 때문에 숨기지 마세요.
  • audio_url.mp3로 끝난다고 보장되지 않습니다. API가 반환한 실제 URL로 재생하거나 다운로드하세요.
  • status="unknown"이면 작업 ID를 유지하고 수동 새로고침을 허용하되 새 작업을 자동 생성하지 마세요.
AbortController는 브라우저 요청과 폴링을 중단할 수 있지만 서버 작업은 취소하지 않습니다. 현재 제출된 Suno 작업을 취소하는 API는 없습니다.