참조 오디오 업로드

공개적으로 접근할 수 있는 참조 오디오 URL을 제출하여 커버, 이어 만들기 또는 보컬 추가에 사용할 트랙 ID를 받습니다.

이 인터페이스는 JSON의 audio_url을 받으며 Multipart 파일 업로드가 아닙니다. is_async로 동기 또는 비동기 처리를 선택합니다.

POST/suno/mj/submit/upload

인증

bearerAuth

인증Bearer <token>

Authorization: Bearer your-api-key로 인증합니다.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

audio_url*string

공개적으로 접근할 수 있는 오디오 주소입니다.

is_async?boolean

비동기 업로드 여부이며 기본값은 false입니다. 동기 업로드에 성공하면 일반적으로 music_id를 직접 반환합니다.

기본값false

hookUrl?string

선택적 사용자 콜백 주소입니다. 80, 443, 8080, 8443 포트만 지원하며 입력하면 플랫폼이 알림을 전달합니다.

응답 본문

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/upload' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/reference-vocal.wav",
  "is_async": false
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "music_id": "MUSIC_ID"
  }
}

업로드 결과 처리

동기 업로드: is_async=false(기본값). 성공 후 data.music_id에서 트랙 ID를 읽습니다.
비동기 업로드: is_async=true. 제출 성공 후 data.jobId를 저장하고 작업 조회로 작업 완료를 기다립니다. 완료된 트랙 ID는 data.data.data.musics[].musicId에 있습니다.

비동기 응답의 status: SUCCESS는 작업 접수만 의미하며 업로드 처리가 완료되었다는 뜻은 아닙니다. 트랙 ID를 스타일 커버, 노래 이어 만들기 또는 보컬 추가의 music_id에 입력합니다. 작업 ID는 트랙 ID를 대신할 수 없습니다.

인증

요청 본문

응답 본문

200application/json

400application/json

업로드 결과 처리

`application/json`

`application/json`