작업 일괄 조회

각 ID는 트랙 결과가 아니라 제출 인터페이스의 작업 응답에서 가져와야 합니다. 단일 작업 조회, 상태 및 콜백 규칙은 작업 조회를 참고합니다.

요청이 성공하면 data는 작업 결과 목록이며 각 항목의 status는 해당 작업의 상태를 나타냅니다. 반환 순서는 요청의 ids와 같다고 보장하지 않습니다. 응답 항목에 task_id가 있으면 이 필드로 원본 작업을 연결하며 배열 위치로 짝을 맞추지 않습니다.

POST/suno/mj/fetch

인증

bearerAuth

인증Bearer <token>

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

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

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

ids*array<string>

조회할 작업 ID 목록입니다.

응답 본문

`application/json`

`text/plain`

curl --request POST 'https://api.agtcloud.cn/suno/mj/fetch' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": [
    "JOB_ID_1",
    "JOB_ID_2"
  ]
}'

{
  "code": "success",
  "message": "",
  "data": [
    {
      "status": "SUCCESS",
      "action": "COVER",
      "task_id": "JOB_ID_2",
      "progress": "100%",
      "data": {
        "status": "SUCCESS",
        "jobId": "JOB_ID_2",
        "data": {
          "jobId": "JOB_ID_2",
          "musics": [
            {
              "musicId": "MUSIC_ID_2",
              "audioUrl": "https://example.com/audio-2.mp3"
            }
          ]
        }
      }
    },
    {
      "status": "SUCCESS",
      "action": "EXTEND",
      "task_id": "JOB_ID_1",
      "progress": "100%",
      "data": {
        "status": "SUCCESS",
        "jobId": "JOB_ID_1",
        "data": {
          "jobId": "JOB_ID_1",
          "musics": [
            {
              "musicId": "MUSIC_ID_1",
              "audioUrl": "https://example.com/audio-1.mp3"
            }
          ]
        }
      }
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400text/plain

`application/json`

`text/plain`