---
title: "GET /suno/v2/fetch"
method: GET
path: "/suno/v2/fetch"
---

# GET /suno/v2/fetch

`GET /suno/v2/fetch`

## Query parameters

- `jobId` string, required

## Response `200`

Request successful

- object
  - `status` 'ON_QUEUE' | 'SUCCESS' | 'FAILED', required
  - `message` string, required — Response message
  - `jobId` string — Task ID
  - `data` union
    - object — Audio task result
      - `jobId` string — Task ID
      - `action` string — Task type
      - `progress` string — Task progress
      - `mv` string — Model to use
      - `quota` string — Quota consumed
      - `hookUrl` string — Callback URL
      - `musics` object[] — Audio list
        - `musicId` string — Music ID
        - `gpt_description_prompt` string — Inspiration-mode prompt
        - `prompt` string — Lyrics
        - `title` string — Title
        - `tags` string — Style tags
        - `display_tags` string — Display tags
        - `imageUrl` string — Cover image
        - `imageLargeUrl` string — Large cover image
        - `audioUrl` string — Audio file
        - `videoUrl` string — Video file
        - `duration` number — Audio duration
        - `negativeTags` string — Style tags to avoid
        - `styleWeight` number — Style weight
        - `weirdnessConstraint` number — Weirdness weight
        - `audioWeight` number — Audio URL
        - `createdAt` string — Created at
    - object — Lyrics task result
      - `jobId` string — Task ID
      - `model` string — Model to use
      - `progress` string — Task progress
      - `quota` string — Quota consumed
      - `hookUrl` string — Callback URL
      - `lyrics` object[] — Lyrics list
        - `prompt` string — Lyrics
        - `title` string — Title
        - `tags` string — Style tags
    - object — Create voice task result
      - `jobId` string — Task ID
      - `name` string — Voice name
      - `persona_id` string — voice id
      - `quota` string — Quota consumed
      - `hookUrl` string — Callback URL

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)