작업 조회
작업 ID로 Suno MJ 작업의 상태와 결과를 조회합니다. 작업 유형에 따라 결과 필드가 다릅니다.
제출 인터페이스에서 반환한 작업 ID로 작업 상태와 결과를 조회합니다.
작업 ID 및 트랙 ID
| 식별자 | 용도 |
|---|---|
jobId / job_id | 상태 및 결과 조회에 사용하는 작업 ID입니다. 해당 제출 인터페이스의 실제 응답에서 읽습니다. |
music_id / musicId | 커버, 이어 만들기, 보컬 추가 또는 반주 추가에 사용하는 트랙 ID입니다. |
참조 오디오 업로드는 동기 및 비동기 방식을 지원합니다. 동기 업로드에 성공하면 트랙 ID를 직접 반환하며 비동기 업로드 완료 후 트랙 ID는 조회 응답의 data.data.data.musics[].musicId에 있습니다. 트랙 ID를 작업 ID로 사용하여 조회하지 않습니다. 여러 작업은 작업 일괄 조회를 사용할 수 있습니다.
상태 및 결과
| 상태 | 의미 |
|---|---|
NOT_START | 작업이 생성되었으나 아직 처리를 시작하지 않았습니다. |
QUEUED | 작업이 대기열에 있습니다. |
ON_QUEUE | 대기 중입니다. |
SUCCESS | 작업이 성공했습니다. 해당 유형의 결과를 읽습니다. |
FAILED | 작업이 실패했습니다. 작업에서 반환한 오류 정보를 확인합니다. |
제출 응답의 status: SUCCESS는 요청 접수 성공을 나타내며 비동기 작업 완료를 의미하지 않습니다. 조회 응답의 최상위 code: success는 조회 요청 성공을 나타내며 작업 상태는 data.status에서 읽습니다. 음악 생성 또는 비동기 업로드 작업이 완료되면 트랙은 data.data.data.musics[]에 있습니다. 각 트랙의 musicId는 후속 작업에 사용하고 audioUrl은 오디오를 가리킵니다. 제목이 없으면 title은 null일 수 있습니다. 다른 작업 유형의 결과 필드는 다를 수 있으므로 이 구조를 그대로 적용하면 안 됩니다.
콜백 알림
제출 요청에 hookUrl을 선택적으로 입력하여 플랫폼이 전달하는 작업 알림을 받을 수 있습니다. 콜백 주소는 80, 443, 8080, 8443 포트만 지원합니다.
hookUrl을 입력하지 않으면 작업을 직접 조회할 수 있으며 상태 업데이트에는 지연이 있을 수 있습니다. 콜백을 설정한 뒤에도 조회 인터페이스로 결과를 받을 수 있습니다. 콜백 구성은 제출 요청의 hookUrl을 기준으로 하며 조회 응답의 data.hookUrl로 콜백 주소를 판단하지 않습니다.