# 生成 & 查询

{% hint style="danger" %}
此文档已停止维护，最新文档地址：<https://docs.ttapi.io>
{% endhint %}

### 生成音乐

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/suno/v1/music` &#x20;

通过文字提示词或者自定义歌词生成音乐，**注：每次请求生成两首音乐，不可拆分，**[定价详见](https://docs-zh.mjapiapp.com/ttapi-zhong-wen-wen-dang#suno-ding-jia)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="229">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td>mv</td><td>string</td><td>是</td><td><p>使用模型<br>suno使用模型，支持 <code>chirp-v3-0</code> <code>chirp-v3-5</code> <code>chirp-v4</code> <code>chirp-v4-5</code></p><p><code>chirp-v4-5+</code>  <code>chirp-v5</code>  <br><br> </p><p><code>chirp-v4-5-all</code><br><br><br>默认<code>chirp-v4-5+</code></p></td></tr><tr><td>custom</td><td>boolean</td><td>是</td><td>音频是否自定义<br>true - 音频将从歌词中生成 <br>false - 音频将根据灵感模式提示词生成</td></tr><tr><td>instrumental</td><td>boolean</td><td>是</td><td>是否生成纯音乐<br>true 为生成纯音乐，true的情况下会忽略自定义歌词 默认为false</td></tr><tr><td>gpt_description_prompt</td><td>string</td><td>否</td><td>灵感模式提示词<br>根据此提示词自动生成歌词</td></tr><tr><td>prompt</td><td>string</td><td>否</td><td>歌词，自定义模式专用</td></tr><tr><td>title</td><td>string</td><td>否</td><td>标题，自定义模式专用</td></tr><tr><td>tags</td><td>string</td><td>否</td><td>风格标签，自定义模式专用，最大长度200字符</td></tr><tr><td>negative_tags</td><td>string</td><td>否</td><td>不希望生成的风格标签<br>自定义模式专用</td></tr><tr><td>style_weight</td><td>number</td><td>否</td><td>音频风格权重 0-1之间<br>自定义模式专用</td></tr><tr><td>weirdness_constraint</td><td>number</td><td>否</td><td>音频奇妙度权重 0-1之间<br>自定义模式专用</td></tr><tr><td>audio_weight</td><td>number</td><td>否</td><td>音频权重 0-1之间，自定义模式专用</td></tr><tr><td>auto_lyrics</td><td>boolean</td><td>否</td><td>是否自动生成歌词<br>自定义模式专用。<br><code>false</code> - 使用输入的歌词生成音乐
<br><code>true</code> - 根据输入的歌词进行二次创作，与灵感模式提示词效果一致<br>默认<code>false</code></td></tr><tr><td>vocal_gender</td><td>string</td><td>否</td><td>音色性别 <br><code>Male</code> - 男性<br><code>Female</code> - 女性</td></tr><tr><td>persona_id</td><td>string</td><td>否</td><td>歌手风格ID</td></tr><tr><td>isStorage</td><td>boolean</td><td>否</td><td>是否转存，false即返回官方源地址。<br>可选值 <code>true</code>  <code>false</code>，默认<code>true</code></td></tr><tr><td>hookUrl</td><td>string</td><td>否</td><td>回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致</td></tr><tr><td><del>generateVideo（废弃）</del></td><td>boolean</td><td>否</td><td><del>是否需要生成音频的同时生成视频，可选值 <code>true</code></del>  <del><code>false</code>，默认<code>false</code></del></td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}
```

{% endtab %}
{% endtabs %}

### 生成歌词

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/suno/v1/lyrics`

根据提示词生成歌词，[定价详见](https://docs-zh.mjapiapp.com/ttapi-zhong-wen-wen-dang#suno-ding-jia)

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="178">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td>prompt</td><td>string</td><td>是</td><td>提示词</td></tr><tr><td>lyrics_model</td><td>string</td><td>否</td><td>歌词模型 <br>可选范围：<code>classic</code>  <code>remi</code><br>默认：<code>classic</code></td></tr><tr><td>hookUrl</td><td>string</td><td>否</td><td>回调通知地址，当设置此参数，任务成功或者失败将会向该地址发送一个post请求，携带数据与查询任务结果返回一致</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}
```

{% endtab %}
{% endtabs %}

### 上传音频

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/suno/v1/upload`

上传音频至suno，得到music\_id用以完成后续操作

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Body**

<table><thead><tr><th width="178">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>audio_url</code></td><td>string</td><td>是</td><td>音频地址<br><strong>必须是可公开访问的音频地址</strong></td></tr><tr><td>is_async</td><td>boolean</td><td>否</td><td><p>是否异步<br><code>false</code> - 同步等待<br><code>true</code> - 异步查询</p><p>默认：<code>false</code></p></td></tr><tr><td>hookUrl</td><td>string</td><td>否</td><td>回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "status": "SUCCESS",
    "message": "success",
    "data": {
        "music_id": "51dd4085-7cbb-4b18-bba2-7e14f37299d4"
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "status": "FAILED",
  "message": "error message",
  "data": {}
}
```

{% endtab %}
{% endtabs %}

### 查询任务结果

<mark style="color:red;">`GET`</mark> `https://api.ttapi.io/suno/v1/fetch`

通过jobId查询当前音乐&歌词生成结果，免费接口

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Query参数**

<table><thead><tr><th width="178">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td>jobId</td><td>string</td><td>是</td><td>生成的音乐或者歌词的jobId</td></tr></tbody></table>

**Response**

异步回调josn结构与fetch接口查询返回结构一致

{% hint style="info" %}
生成音乐接口、延伸音乐接口、延伸音乐合并接口、音乐翻版、添加声线、添加伴奏、替换片段 返回的数据格式是一致的
{% endhint %}

{% tabs %}
{% tab title="200（音乐生成结果）" %}

```json
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
    "data": {
        "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
        "action": "extend",
        "progress": "100%",
        "mv": "chirp-v3-0",
        "quota": "5",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "a7d3712d-2507-4d87-80d0-b60bb375a049",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "audioUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp3",
                "videoUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp4"
            },
            {
                "musicId": "ab763675-b371-44d5-ae1b-6aea35fe4403",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "audioUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp3",
                "videoUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp4"
            }
        ]
    }
}

```

{% endtab %}

{% tab title="200（歌词生成结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "f106f560-e148-4ea0-ab1a-d94e11a0f4f5",
    "data": {
        "jobId": "f106f560-e148-4ea0-ab1a-d94e11a0f4f5",
        "action": "lyrics",
        "progress": "100%",
        "prompt": "海阔天空",
        "text": "[Verse]\n在风中呼喊我还在等候\n远方的光芒犹如梦幻泡影\n世界太大我却无路可走\n海阔天空却迷失了方向\n\n[Verse 2]\n天边的云朵飘散在风中\n岁月像水流淌不停冲动\n心中的欲望如野火燃烧\n走向远方不问前路远\n\n[Chorus]\n海阔天空我的心依然自由\n穿越黑暗寻找那道光芒\n海浪拍打着心灵的执着\n信念无畏在风雨中闯荡\n\n[Verse 3]\n心灵的旅行无边的冲突\n找不到归途没有终点站\n生命的狂欢如烟花绽放\n梦醒时分泪洒满眼眶\n\n[Bridge]\n不怕跌倒不怕失去\n心中执念一路到底\n回头看那脚印深深\n海阔天空无怨无悔\n\n[Chorus]\n海阔天空我的心依然自由\n穿越黑暗寻找那道光芒\n海浪拍打着心灵的执着\n信念无畏在风雨中闯荡",
        "title": "海阔天空",
        "quota": "1",
        "hookUrl": "https://webhook-test.com/a9b086dc0e5a18c26053791aa93bd2c7"
    }
}
```

{% endtab %}

{% tab title="200（词曲分离结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "1d3cf729-df97-4667-bdfe-95ce6527d3c3",
    "data": {
        "jobId": "1d3cf729-df97-4667-bdfe-95ce6527d3c3",
        "action": "stems",
        "progress": "100%",
        "mv": "chirp-v4",
        "quota": "6",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "afb73934-840f-4dc1-abc4-51c505454b5a",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/ffaaa2ae-bef5-4ba7-8f19-b974681533ee.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/ffaaa2ae-bef5-4ba7-8f19-b974681533ee.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/992cb1f5-2822-4808-b3bf-2dfba006eb08.mp3",
                "videoUrl": "https://cdn1.suno.ai/afb73934-840f-4dc1-abc4-51c505454b5a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "c5c244b9-7f1f-4c1d-95a6-2665be9fc6ff",
                "prompt": "",
                "title": " (Instrumental)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/991735fc-b958-4721-aea1-e770d9c61b4b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/991735fc-b958-4721-aea1-e770d9c61b4b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/1fb9326d-319d-4a7b-a056-8556eec68a22.mp3",
                "videoUrl": "https://cdn1.suno.ai/c5c244b9-7f1f-4c1d-95a6-2665be9fc6ff.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "e19082ac-02e7-443d-8978-8812e721f821",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/820c2f91-6ce1-4473-92fe-21fbff49f711.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/820c2f91-6ce1-4473-92fe-21fbff49f711.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/86f36d64-4b17-453d-a023-7a85526ae51f.mp3",
                "videoUrl": "https://cdn1.suno.ai/e19082ac-02e7-443d-8978-8812e721f821.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "689af2d9-30a7-4161-9b3e-d4eade8e2372",
                "prompt": "",
                "title": " (Instrumental)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2a9cffaa-9372-4666-84a5-f6decb1b6a1a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2a9cffaa-9372-4666-84a5-f6decb1b6a1a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/564ed981-3b40-4483-bfb2-387e98d39a97.mp3",
                "videoUrl": "https://cdn1.suno.ai/689af2d9-30a7-4161-9b3e-d4eade8e2372.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.922Z"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="200（全轨道词曲分离结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "2beb7b93-5835-4613-8b0b-23b199f1736c",
    "data": {
        "jobId": "2beb7b93-5835-4613-8b0b-23b199f1736c",
        "action": "stems-all",
        "progress": "100%",
        "mv": "chirp-v4",
        "quota": "60",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "6af2cd86-b5c6-4f6e-8bf5-814ab4d1f43d",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2cceb69f-7c01-491d-8591-5b6ff16a25d8.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2cceb69f-7c01-491d-8591-5b6ff16a25d8.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/3457b854-7ae9-48d7-b714-6d2a8b120b2f.mp3",
                "videoUrl": "https://cdn1.suno.ai/6af2cd86-b5c6-4f6e-8bf5-814ab4d1f43d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "29e80885-d2e0-4ccc-b693-5ce2164dcc9d",
                "prompt": "I love Chinese dumplings",
                "title": " (Backing Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/d584d792-7916-4d5d-887b-db15d9aeaf73.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/d584d792-7916-4d5d-887b-db15d9aeaf73.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/dfa84e67-4cc2-426b-a143-05fefc7b5258.mp3",
                "videoUrl": "https://cdn1.suno.ai/29e80885-d2e0-4ccc-b693-5ce2164dcc9d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c148ceb2-18c7-41db-812a-310023e52c6d",
                "prompt": "",
                "title": " (Drums)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/3d8a9950-1f8f-4996-b80e-272c47f73864.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/3d8a9950-1f8f-4996-b80e-272c47f73864.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/f09d6348-988c-4963-8b1c-8c9589b28790.mp3",
                "videoUrl": "https://cdn1.suno.ai/c148ceb2-18c7-41db-812a-310023e52c6d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "ce68071d-41b3-4410-bcd1-cf43af3df8a7",
                "prompt": "",
                "title": " (Bass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/0e0b2952-95f8-4f50-bc8c-34f0c04e8e13.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/0e0b2952-95f8-4f50-bc8c-34f0c04e8e13.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/3886a827-0eb2-4d8b-a971-cde490bf2bd9.mp3",
                "videoUrl": "https://cdn1.suno.ai/ce68071d-41b3-4410-bcd1-cf43af3df8a7.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f050cdfc-f6d7-4b14-9fa4-f23dfc9a04e9",
                "prompt": "",
                "title": " (Guitar)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/8bd88696-36d1-430c-bdbf-d451d96a8bf6.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/8bd88696-36d1-430c-bdbf-d451d96a8bf6.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ee739d87-d729-45fa-a26c-794fe88dd4cd.mp3",
                "videoUrl": "https://cdn1.suno.ai/f050cdfc-f6d7-4b14-9fa4-f23dfc9a04e9.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "81875dc7-95ec-43b7-b922-dcd658d16623",
                "prompt": "",
                "title": " (Keyboard)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/25544230-14c4-4d5a-a5b5-5540fcc0b788.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/25544230-14c4-4d5a-a5b5-5540fcc0b788.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/fbdf864a-c84b-4cc7-b99c-cf369515e63d.mp3",
                "videoUrl": "https://cdn1.suno.ai/81875dc7-95ec-43b7-b922-dcd658d16623.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "50f6533d-24a5-444b-8ff6-eb90c6e53f8f",
                "prompt": "",
                "title": " (Percussion)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/6638fa08-a4fe-4e00-a0a0-0944c2489bbf.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/6638fa08-a4fe-4e00-a0a0-0944c2489bbf.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/82cc8d36-d613-47ff-a8b8-acd3bb5412b4.mp3",
                "videoUrl": "https://cdn1.suno.ai/50f6533d-24a5-444b-8ff6-eb90c6e53f8f.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f32449c1-e925-478b-9b6a-b6194f0ab9c4",
                "prompt": "",
                "title": " (Strings)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/63d44752-884e-41b9-bd9c-121ce63a35ea.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/63d44752-884e-41b9-bd9c-121ce63a35ea.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/d627c677-8079-4374-892f-0242619f34ff.mp3",
                "videoUrl": "https://cdn1.suno.ai/f32449c1-e925-478b-9b6a-b6194f0ab9c4.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c0976857-59a4-4d2c-8f48-def6d226cdb4",
                "prompt": "",
                "title": " (Synth)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/fd4047a4-a79f-447b-b2ef-45533364169a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/fd4047a4-a79f-447b-b2ef-45533364169a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/294d2dbe-2d32-4e6a-b78e-c22d90c6d48c.mp3",
                "videoUrl": "https://cdn1.suno.ai/c0976857-59a4-4d2c-8f48-def6d226cdb4.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "005fcad5-057c-4ed5-9304-1f6291b6299a",
                "prompt": "",
                "title": " (FX)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/d91a9461-3960-42bc-b536-332d1177f40f.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/d91a9461-3960-42bc-b536-332d1177f40f.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/8cc0400a-219b-48d8-9b45-2a52b9a9d6c3.mp3",
                "videoUrl": "https://cdn1.suno.ai/005fcad5-057c-4ed5-9304-1f6291b6299a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "104639f4-f765-46d2-9463-20ddfd9d154a",
                "prompt": "",
                "title": " (Brass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/82c8be69-c087-47e0-9682-a598d4425d3d.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/82c8be69-c087-47e0-9682-a598d4425d3d.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/74898169-d82d-4553-b651-84ceb7b37363.mp3",
                "videoUrl": "https://cdn1.suno.ai/104639f4-f765-46d2-9463-20ddfd9d154a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "91ed72ea-ebe8-4bff-9836-885fef3568ac",
                "prompt": "",
                "title": " (Woodwinds)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/5c00e7e8-f03e-48ab-8a11-67df32ed2d32.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/5c00e7e8-f03e-48ab-8a11-67df32ed2d32.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ca371b58-09cc-40b4-939c-0e3a65a8bcb4.mp3",
                "videoUrl": "https://cdn1.suno.ai/91ed72ea-ebe8-4bff-9836-885fef3568ac.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "3b1f3c2d-5890-4be7-8f06-eb53ab41cad1",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2f9e59b6-6100-4fcb-bcdf-934b688d2f61.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2f9e59b6-6100-4fcb-bcdf-934b688d2f61.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/169356be-52d2-48d8-b47c-1f3763743397.mp3",
                "videoUrl": "https://cdn1.suno.ai/3b1f3c2d-5890-4be7-8f06-eb53ab41cad1.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f8ce8626-ed70-41fa-8bbb-deb973332307",
                "prompt": "I love Chinese dumplings",
                "title": " (Backing Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/48f13c5b-6bae-4225-a39c-fcf2fea698a0.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/48f13c5b-6bae-4225-a39c-fcf2fea698a0.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/f9d12551-fb0d-4f1a-945a-977ad41ca7a3.mp3",
                "videoUrl": "https://cdn1.suno.ai/f8ce8626-ed70-41fa-8bbb-deb973332307.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c8bd3c46-934c-4846-8f1c-16061d7a4d5b",
                "prompt": "",
                "title": " (Drums)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b0e4905a-4c86-4000-8ff6-1ff62f1ecf5e.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b0e4905a-4c86-4000-8ff6-1ff62f1ecf5e.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e5998e05-cf20-4abe-aef6-b217d95757c9.mp3",
                "videoUrl": "https://cdn1.suno.ai/c8bd3c46-934c-4846-8f1c-16061d7a4d5b.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c17d810e-1950-4e39-ac1d-e181a04cad0d",
                "prompt": "",
                "title": " (Bass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b03a31da-0b94-4adc-9429-ba4df90d7584.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b03a31da-0b94-4adc-9429-ba4df90d7584.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e00ce75a-c847-4fea-ac6d-7d42db75961a.mp3",
                "videoUrl": "https://cdn1.suno.ai/c17d810e-1950-4e39-ac1d-e181a04cad0d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "3114e5f6-2ce8-4c1d-be4e-d7f0f519d4d5",
                "prompt": "",
                "title": " (Guitar)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/66c75297-1e10-4232-aea4-de614e1ab10a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/66c75297-1e10-4232-aea4-de614e1ab10a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/9ce92548-7dca-4c53-bc41-1af3f2e8ac1c.mp3",
                "videoUrl": "https://cdn1.suno.ai/3114e5f6-2ce8-4c1d-be4e-d7f0f519d4d5.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "1f56ae07-766c-4f74-b592-3138162d1164",
                "prompt": "",
                "title": " (Keyboard)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2fa1bf06-835e-477c-81ce-25637a96ea6b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2fa1bf06-835e-477c-81ce-25637a96ea6b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/185bb343-d58a-4c48-9d88-ac0e838b32fa.mp3",
                "videoUrl": "https://cdn1.suno.ai/1f56ae07-766c-4f74-b592-3138162d1164.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "9080cf08-3dce-40d3-aec9-8aa04a0b6ee9",
                "prompt": "",
                "title": " (Percussion)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/fdc0a3d8-fd05-46e2-a2cb-a45bf8bf27bd.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/fdc0a3d8-fd05-46e2-a2cb-a45bf8bf27bd.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/63be387d-11ff-4986-91e3-6dba56b0c557.mp3",
                "videoUrl": "https://cdn1.suno.ai/9080cf08-3dce-40d3-aec9-8aa04a0b6ee9.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "97a9fdcc-d218-4d29-8dee-c6a8d170c908",
                "prompt": "",
                "title": " (Strings)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/60b096fd-5926-459c-8567-dd529a770a6b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/60b096fd-5926-459c-8567-dd529a770a6b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ccb615ac-9074-4514-a649-d46ed598343e.mp3",
                "videoUrl": "https://cdn1.suno.ai/97a9fdcc-d218-4d29-8dee-c6a8d170c908.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "4b9cdd53-97cd-4258-b80e-f88b9292f772",
                "prompt": "",
                "title": " (Synth)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/e803a471-6141-4edb-a102-0ff555dcdcb2.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/e803a471-6141-4edb-a102-0ff555dcdcb2.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/2bedb413-72e1-4615-954a-b21970d0be54.mp3",
                "videoUrl": "https://cdn1.suno.ai/4b9cdd53-97cd-4258-b80e-f88b9292f772.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "db88f0c6-164c-4253-a691-4f440dadf54d",
                "prompt": "",
                "title": " (FX)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/f0738202-d776-402d-ad0c-42ed136dee7d.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/f0738202-d776-402d-ad0c-42ed136dee7d.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e6278017-89bc-4881-8474-0c4d5244e6be.mp3",
                "videoUrl": "https://cdn1.suno.ai/db88f0c6-164c-4253-a691-4f440dadf54d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c8cf1de0-e074-403f-b231-606cc7441a4e",
                "prompt": "",
                "title": " (Brass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b2b73eb8-7d25-4d54-bdc3-7f8826f94c79.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b2b73eb8-7d25-4d54-bdc3-7f8826f94c79.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/6a2e4335-447e-4646-a1ab-50278ef25417.mp3",
                "videoUrl": "https://cdn1.suno.ai/c8cf1de0-e074-403f-b231-606cc7441a4e.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "e677522d-7429-4bda-9e6d-ac2a23fd1e99",
                "prompt": "",
                "title": " (Woodwinds)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b06890d7-e4e8-4c0c-addf-92e9340846e4.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b06890d7-e4e8-4c0c-addf-92e9340846e4.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e3f35b21-bf59-4f31-8dbe-4ecb3503e347.mp3",
                "videoUrl": "https://cdn1.suno.ai/e677522d-7429-4bda-9e6d-ac2a23fd1e99.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.026Z"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

### 查询任务结果-V2

{% hint style="info" %}
注意：v2版本目前对比v1仅歌词查询结果返回结构不一致
{% endhint %}

<mark style="color:red;">`GET`</mark> `https://api.ttapi.io/suno/v2/fetch`

通过jobId查询当前音乐&歌词生成结果，免费接口

**Headers**

| Name         | Value                  |
| ------------ | ---------------------- |
| Content-Type | `application/json`     |
| TT-API-KEY   | `用于请求授权 TT-API 的API密钥` |

**Query参数**

<table><thead><tr><th width="178">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td>jobId</td><td>string</td><td>是</td><td>生成的音乐或者歌词的jobId</td></tr></tbody></table>

**Response**

异步回调josn结构与fetch接口查询返回结构一致

{% hint style="info" %}
生成音乐接口、延伸音乐接口、延伸音乐合并接口、音乐翻版、添加声线、添加伴奏、替换片段 返回的数据格式是一致的
{% endhint %}

{% tabs %}
{% tab title="200（音乐生成结果）" %}

```json
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
    "data": {
        "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
        "action": "extend",
        "progress": "100%",
        "mv": "chirp-v3-0",
        "quota": "5",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "a7d3712d-2507-4d87-80d0-b60bb375a049",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "audioUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp3",
                "videoUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp4"
            },
            {
                "musicId": "ab763675-b371-44d5-ae1b-6aea35fe4403",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "audioUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp3",
                "videoUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp4"
            }
        ]
    }
}

```

{% endtab %}

{% tab title="200（歌词生成结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "f4907b32-f172-4a7b-a60a-ed715c3ceb0c",
    "data": {
        "jobId": "f4907b32-f172-4a7b-a60a-ed715c3ceb0c",
        "progress": "100%",
        "model": "remi",
        "quota": "0.30",
        "hookUrl": null,
        "lyrics": [
            {
                "prompt": "[Verse 1]\n小猫跳一跳\n尾巴画个圈\n小狗追着跑\n舌头伸半边\n一前一后\n草地被踩扁\n摔成一团\n都笑翻在那边\n\n[Chorus]\n小猫小狗转个圈\n你追我呀我追谁\n胡子抖抖耳朵飞\n一整天都玩不累\n小猫小狗转个圈\n滚进阳光的被窝里\n鼻子贴着小肚皮\n睡着还在偷偷笑你\n\n[Verse 2]\n窗台一束光\n灰尘慢慢飘\n小狗叼着绳\n小猫叼着毛\n一人一头\n谁也不肯让\n突然松开\n一起冲向走廊\n\n[Chorus]",
                "title": "小猫小狗转个圈",
                "tags": "[\"Bright playful pop with acoustic guitar and ukulele, light percussion taps and handclaps. Female vocals, bouncy mid‑tempo groove that sways. Verses stay minimal and cute; chorus blooms with stacked “na-na”s and childlike gang shouts. Soft bells and hummed outro to keep it warm and cozy.\"]"
            },
            {
                "prompt": "[Verse 1]\n一只小猫\n跳上软软小沙发\n一只小狗\n叼着球跑到它家\n鼻子碰碰\n胡子痒痒笑开花\n你追我啊\n小爪小爪乱刹车\n\n[Chorus]\n小猫小狗一起玩耍\n一跳一翻像在飞呀\n滚在草地上脸上全是泥巴\n汪汪喵喵唱成一首歌啦\n小猫小狗一起玩耍\n太阳看了都在笑呀\n今天明天每天都是同一话\n最爱就是和你疯玩到晚霞\n\n[Verse 2]\n一只小猫\n躲在纸箱小城堡\n一只小狗\n转了三圈才找到\n尾巴摇摇\n像个不会停的表\n伸出爪爪\n拍一拍说别乱跑\n\n[Chorus]\n\n[Bridge]\n累了就靠在一起\n喝一口水再继续\n你舔舔它的耳朵\n它拍拍你的脊背说\n“别走哦 别走哦”\n\n[Chorus]",
                "title": "小猫小狗大冒险",
                "tags": "[\"Bouncy acoustic pop with a playful children’s-song feel. Ukulele and light percussion drive a simple groove; glockenspiel doubles the hook. Female vocals up front, with call-and-response gang shouts on the chorus. Short bridge strips to claps and bass, then everything pops back in for a big, catchy final refrain.\"]"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="200（词曲分离结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "1d3cf729-df97-4667-bdfe-95ce6527d3c3",
    "data": {
        "jobId": "1d3cf729-df97-4667-bdfe-95ce6527d3c3",
        "action": "stems",
        "progress": "100%",
        "mv": "chirp-v4",
        "quota": "6",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "afb73934-840f-4dc1-abc4-51c505454b5a",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/ffaaa2ae-bef5-4ba7-8f19-b974681533ee.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/ffaaa2ae-bef5-4ba7-8f19-b974681533ee.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/992cb1f5-2822-4808-b3bf-2dfba006eb08.mp3",
                "videoUrl": "https://cdn1.suno.ai/afb73934-840f-4dc1-abc4-51c505454b5a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "c5c244b9-7f1f-4c1d-95a6-2665be9fc6ff",
                "prompt": "",
                "title": " (Instrumental)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/991735fc-b958-4721-aea1-e770d9c61b4b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/991735fc-b958-4721-aea1-e770d9c61b4b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/1fb9326d-319d-4a7b-a056-8556eec68a22.mp3",
                "videoUrl": "https://cdn1.suno.ai/c5c244b9-7f1f-4c1d-95a6-2665be9fc6ff.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "e19082ac-02e7-443d-8978-8812e721f821",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/820c2f91-6ce1-4473-92fe-21fbff49f711.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/820c2f91-6ce1-4473-92fe-21fbff49f711.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/86f36d64-4b17-453d-a023-7a85526ae51f.mp3",
                "videoUrl": "https://cdn1.suno.ai/e19082ac-02e7-443d-8978-8812e721f821.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.921Z"
            },
            {
                "musicId": "689af2d9-30a7-4161-9b3e-d4eade8e2372",
                "prompt": "",
                "title": " (Instrumental)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2a9cffaa-9372-4666-84a5-f6decb1b6a1a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2a9cffaa-9372-4666-84a5-f6decb1b6a1a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/564ed981-3b40-4483-bfb2-387e98d39a97.mp3",
                "videoUrl": "https://cdn1.suno.ai/689af2d9-30a7-4161-9b3e-d4eade8e2372.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:17:27.922Z"
            }
        ]
    }
}
```

{% endtab %}

{% tab title="200（全轨道词曲分离结果）" %}

```
{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "2beb7b93-5835-4613-8b0b-23b199f1736c",
    "data": {
        "jobId": "2beb7b93-5835-4613-8b0b-23b199f1736c",
        "action": "stems-all",
        "progress": "100%",
        "mv": "chirp-v4",
        "quota": "60",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "6af2cd86-b5c6-4f6e-8bf5-814ab4d1f43d",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2cceb69f-7c01-491d-8591-5b6ff16a25d8.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2cceb69f-7c01-491d-8591-5b6ff16a25d8.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/3457b854-7ae9-48d7-b714-6d2a8b120b2f.mp3",
                "videoUrl": "https://cdn1.suno.ai/6af2cd86-b5c6-4f6e-8bf5-814ab4d1f43d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "29e80885-d2e0-4ccc-b693-5ce2164dcc9d",
                "prompt": "I love Chinese dumplings",
                "title": " (Backing Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/d584d792-7916-4d5d-887b-db15d9aeaf73.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/d584d792-7916-4d5d-887b-db15d9aeaf73.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/dfa84e67-4cc2-426b-a143-05fefc7b5258.mp3",
                "videoUrl": "https://cdn1.suno.ai/29e80885-d2e0-4ccc-b693-5ce2164dcc9d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c148ceb2-18c7-41db-812a-310023e52c6d",
                "prompt": "",
                "title": " (Drums)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/3d8a9950-1f8f-4996-b80e-272c47f73864.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/3d8a9950-1f8f-4996-b80e-272c47f73864.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/f09d6348-988c-4963-8b1c-8c9589b28790.mp3",
                "videoUrl": "https://cdn1.suno.ai/c148ceb2-18c7-41db-812a-310023e52c6d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "ce68071d-41b3-4410-bcd1-cf43af3df8a7",
                "prompt": "",
                "title": " (Bass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/0e0b2952-95f8-4f50-bc8c-34f0c04e8e13.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/0e0b2952-95f8-4f50-bc8c-34f0c04e8e13.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/3886a827-0eb2-4d8b-a971-cde490bf2bd9.mp3",
                "videoUrl": "https://cdn1.suno.ai/ce68071d-41b3-4410-bcd1-cf43af3df8a7.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f050cdfc-f6d7-4b14-9fa4-f23dfc9a04e9",
                "prompt": "",
                "title": " (Guitar)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/8bd88696-36d1-430c-bdbf-d451d96a8bf6.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/8bd88696-36d1-430c-bdbf-d451d96a8bf6.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ee739d87-d729-45fa-a26c-794fe88dd4cd.mp3",
                "videoUrl": "https://cdn1.suno.ai/f050cdfc-f6d7-4b14-9fa4-f23dfc9a04e9.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "81875dc7-95ec-43b7-b922-dcd658d16623",
                "prompt": "",
                "title": " (Keyboard)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/25544230-14c4-4d5a-a5b5-5540fcc0b788.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/25544230-14c4-4d5a-a5b5-5540fcc0b788.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/fbdf864a-c84b-4cc7-b99c-cf369515e63d.mp3",
                "videoUrl": "https://cdn1.suno.ai/81875dc7-95ec-43b7-b922-dcd658d16623.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "50f6533d-24a5-444b-8ff6-eb90c6e53f8f",
                "prompt": "",
                "title": " (Percussion)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/6638fa08-a4fe-4e00-a0a0-0944c2489bbf.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/6638fa08-a4fe-4e00-a0a0-0944c2489bbf.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/82cc8d36-d613-47ff-a8b8-acd3bb5412b4.mp3",
                "videoUrl": "https://cdn1.suno.ai/50f6533d-24a5-444b-8ff6-eb90c6e53f8f.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f32449c1-e925-478b-9b6a-b6194f0ab9c4",
                "prompt": "",
                "title": " (Strings)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/63d44752-884e-41b9-bd9c-121ce63a35ea.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/63d44752-884e-41b9-bd9c-121ce63a35ea.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/d627c677-8079-4374-892f-0242619f34ff.mp3",
                "videoUrl": "https://cdn1.suno.ai/f32449c1-e925-478b-9b6a-b6194f0ab9c4.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c0976857-59a4-4d2c-8f48-def6d226cdb4",
                "prompt": "",
                "title": " (Synth)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/fd4047a4-a79f-447b-b2ef-45533364169a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/fd4047a4-a79f-447b-b2ef-45533364169a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/294d2dbe-2d32-4e6a-b78e-c22d90c6d48c.mp3",
                "videoUrl": "https://cdn1.suno.ai/c0976857-59a4-4d2c-8f48-def6d226cdb4.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "005fcad5-057c-4ed5-9304-1f6291b6299a",
                "prompt": "",
                "title": " (FX)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/d91a9461-3960-42bc-b536-332d1177f40f.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/d91a9461-3960-42bc-b536-332d1177f40f.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/8cc0400a-219b-48d8-9b45-2a52b9a9d6c3.mp3",
                "videoUrl": "https://cdn1.suno.ai/005fcad5-057c-4ed5-9304-1f6291b6299a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "104639f4-f765-46d2-9463-20ddfd9d154a",
                "prompt": "",
                "title": " (Brass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/82c8be69-c087-47e0-9682-a598d4425d3d.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/82c8be69-c087-47e0-9682-a598d4425d3d.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/74898169-d82d-4553-b651-84ceb7b37363.mp3",
                "videoUrl": "https://cdn1.suno.ai/104639f4-f765-46d2-9463-20ddfd9d154a.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "91ed72ea-ebe8-4bff-9836-885fef3568ac",
                "prompt": "",
                "title": " (Woodwinds)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/5c00e7e8-f03e-48ab-8a11-67df32ed2d32.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/5c00e7e8-f03e-48ab-8a11-67df32ed2d32.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ca371b58-09cc-40b4-939c-0e3a65a8bcb4.mp3",
                "videoUrl": "https://cdn1.suno.ai/91ed72ea-ebe8-4bff-9836-885fef3568ac.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "3b1f3c2d-5890-4be7-8f06-eb53ab41cad1",
                "prompt": "I love Chinese dumplings",
                "title": " (Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2f9e59b6-6100-4fcb-bcdf-934b688d2f61.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2f9e59b6-6100-4fcb-bcdf-934b688d2f61.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/169356be-52d2-48d8-b47c-1f3763743397.mp3",
                "videoUrl": "https://cdn1.suno.ai/3b1f3c2d-5890-4be7-8f06-eb53ab41cad1.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "f8ce8626-ed70-41fa-8bbb-deb973332307",
                "prompt": "I love Chinese dumplings",
                "title": " (Backing Vocals)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/48f13c5b-6bae-4225-a39c-fcf2fea698a0.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/48f13c5b-6bae-4225-a39c-fcf2fea698a0.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/f9d12551-fb0d-4f1a-945a-977ad41ca7a3.mp3",
                "videoUrl": "https://cdn1.suno.ai/f8ce8626-ed70-41fa-8bbb-deb973332307.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c8bd3c46-934c-4846-8f1c-16061d7a4d5b",
                "prompt": "",
                "title": " (Drums)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b0e4905a-4c86-4000-8ff6-1ff62f1ecf5e.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b0e4905a-4c86-4000-8ff6-1ff62f1ecf5e.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e5998e05-cf20-4abe-aef6-b217d95757c9.mp3",
                "videoUrl": "https://cdn1.suno.ai/c8bd3c46-934c-4846-8f1c-16061d7a4d5b.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c17d810e-1950-4e39-ac1d-e181a04cad0d",
                "prompt": "",
                "title": " (Bass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b03a31da-0b94-4adc-9429-ba4df90d7584.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b03a31da-0b94-4adc-9429-ba4df90d7584.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e00ce75a-c847-4fea-ac6d-7d42db75961a.mp3",
                "videoUrl": "https://cdn1.suno.ai/c17d810e-1950-4e39-ac1d-e181a04cad0d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "3114e5f6-2ce8-4c1d-be4e-d7f0f519d4d5",
                "prompt": "",
                "title": " (Guitar)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/66c75297-1e10-4232-aea4-de614e1ab10a.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/66c75297-1e10-4232-aea4-de614e1ab10a.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/9ce92548-7dca-4c53-bc41-1af3f2e8ac1c.mp3",
                "videoUrl": "https://cdn1.suno.ai/3114e5f6-2ce8-4c1d-be4e-d7f0f519d4d5.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "1f56ae07-766c-4f74-b592-3138162d1164",
                "prompt": "",
                "title": " (Keyboard)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/2fa1bf06-835e-477c-81ce-25637a96ea6b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/2fa1bf06-835e-477c-81ce-25637a96ea6b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/185bb343-d58a-4c48-9d88-ac0e838b32fa.mp3",
                "videoUrl": "https://cdn1.suno.ai/1f56ae07-766c-4f74-b592-3138162d1164.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "9080cf08-3dce-40d3-aec9-8aa04a0b6ee9",
                "prompt": "",
                "title": " (Percussion)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/fdc0a3d8-fd05-46e2-a2cb-a45bf8bf27bd.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/fdc0a3d8-fd05-46e2-a2cb-a45bf8bf27bd.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/63be387d-11ff-4986-91e3-6dba56b0c557.mp3",
                "videoUrl": "https://cdn1.suno.ai/9080cf08-3dce-40d3-aec9-8aa04a0b6ee9.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "97a9fdcc-d218-4d29-8dee-c6a8d170c908",
                "prompt": "",
                "title": " (Strings)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/60b096fd-5926-459c-8567-dd529a770a6b.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/60b096fd-5926-459c-8567-dd529a770a6b.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/ccb615ac-9074-4514-a649-d46ed598343e.mp3",
                "videoUrl": "https://cdn1.suno.ai/97a9fdcc-d218-4d29-8dee-c6a8d170c908.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "4b9cdd53-97cd-4258-b80e-f88b9292f772",
                "prompt": "",
                "title": " (Synth)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/e803a471-6141-4edb-a102-0ff555dcdcb2.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/e803a471-6141-4edb-a102-0ff555dcdcb2.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/2bedb413-72e1-4615-954a-b21970d0be54.mp3",
                "videoUrl": "https://cdn1.suno.ai/4b9cdd53-97cd-4258-b80e-f88b9292f772.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "db88f0c6-164c-4253-a691-4f440dadf54d",
                "prompt": "",
                "title": " (FX)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/f0738202-d776-402d-ad0c-42ed136dee7d.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/f0738202-d776-402d-ad0c-42ed136dee7d.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e6278017-89bc-4881-8474-0c4d5244e6be.mp3",
                "videoUrl": "https://cdn1.suno.ai/db88f0c6-164c-4253-a691-4f440dadf54d.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "c8cf1de0-e074-403f-b231-606cc7441a4e",
                "prompt": "",
                "title": " (Brass)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b2b73eb8-7d25-4d54-bdc3-7f8826f94c79.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b2b73eb8-7d25-4d54-bdc3-7f8826f94c79.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/6a2e4335-447e-4646-a1ab-50278ef25417.mp3",
                "videoUrl": "https://cdn1.suno.ai/c8cf1de0-e074-403f-b231-606cc7441a4e.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.025Z"
            },
            {
                "musicId": "e677522d-7429-4bda-9e6d-ac2a23fd1e99",
                "prompt": "",
                "title": " (Woodwinds)",
                "tags": "",
                "imageUrl": "https://cdn.ttapi.io/suno/2025-06-27/b06890d7-e4e8-4c0c-addf-92e9340846e4.jpg",
                "imageLargeUrl": "https://cdn.ttapi.io/suno/2025-06-27/b06890d7-e4e8-4c0c-addf-92e9340846e4.jpg",
                "audioUrl": "https://cdn.ttapi.io/suno/2025-06-27/e3f35b21-bf59-4f31-8dbe-4ecb3503e347.mp3",
                "videoUrl": "https://cdn1.suno.ai/e677522d-7429-4bda-9e6d-ac2a23fd1e99.mp4",
                "duration": "8.12",
                "createdAt": "2025-06-27T09:19:35.026Z"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-zh.mjapiapp.com/api/suno/sheng-cheng-cha-xun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.