Suno Studio Experimental Workflow

This is currently an experimental version with many unexplained data fields
You can test it yourself using Suno Studio on the Suno official website and explore the data sources together
The main challenge is Step 2: the source of the input parameters

0. Create a New Project

A. Create

POST https://api.openai-hk.com/suno/act/create-project

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/act/create-project \
  --header 'Accept: */*' \
  --header 'Accept-Encoding: gzip, deflate, br' \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{"title":"good"}'

curl --request POST \
  --url https://api.openai-hk.com/suno/act/create-project \
  --header 'Accept: */*' \
  --header 'Accept-Encoding: gzip, deflate, br' \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Connection: keep-alive' \
  --header 'Content-Type: application/json' \
  --data '{"title":"good"}'

Billing: 100 credits/request
The id in the response body is the project_id
project_id=b7d43125-314b-4eb9-97d7-99f4113f7cb0

json

{
  "id": "b7d43125-314b-4eb9-97d7-99f4113f7cb0",
  "title": "good",
  "created_at": "2025-10-23T16:44:48.434Z",
  "updated_at": "2025-10-23T16:44:48.434Z",
  "archived": false
}

{
  "id": "b7d43125-314b-4eb9-97d7-99f4113f7cb0",
  "title": "good",
  "created_at": "2025-10-23T16:44:48.434Z",
  "updated_at": "2025-10-23T16:44:48.434Z",
  "archived": false
}

B. Get

Cross-account access not supported
Fetched in real-time, no cache, because the content is editable
Billing: 100 credits/request

GET https://api.openai-hk.com/suno/act/project/{project_id}

Response:

GET https://api.openai-hk.com/suno/act/project/b7d43125-314b-4eb9-97d7-99f4113f7cb0

json

{
  "latest_version_id": "e110a173-f27f-4600-ad8b-3ecfc4094b8c",
  "id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "created_at": "2026-02-04T07:17:40.234Z",
  "updated_at": "2026-02-04T07:18:55.671Z",
  "archived": false,
  "state": {
    "timing": {
      "type": "follow-track",
      "fallbackBPS": 1.3310740821581821,
      "trackId": "6f82a355-81b0-4399-918c-a8b2e8897809"
    },
    "markersRegistry": {
      "warp_69dffbeb19cd7394e4e6074b946f6ca1": {
        "148.9351": 198,
        "115.9579": 154,
        "4.6572": 6,
        "90.097": 120,
        .......
        "80.3501": 107,
        "55.615": 74
      }
    },
    "title": "Pallavi2:",
    "tracks": [
      {
        "color": "#7251F7",
        "takeLanes": [],
        "clips": [
          {
            "color": "#FF6A00",
            "startBeats": -0.2135326304550914,
            "mute": false,
            "type": "audio",
            "fadeInBeats": 0,
            "transposition": 0,
            "amplitude": 1,
            "fadeOutBeats": 0,
            "streaming": false,
            "loop": {
              "endBeats": 211.05525156813027,
              "enabled": false,
              "startBeats": -0.2135326304550914
            },
            "clipId": "853389ca-4ef6-4d70-a0f1-e88cb25ef301",
            "endBeats": 211.05525156813027,
            "name": "Pallavi:",
            "readStartBeats": -0.2135326304550914,
            "id": "7064a65c-5bbc-43e2-b1b5-ace00e962f63",
            "warp": {
              "awaitingAnalysis": false,
              "markersHash": "warp_69dffbeb19cd7394e4e6074b946f6ca1",
              "lastMarkerAssignment": "OnBeat",
              "enabled": true
            }
          }
        ],
        "instrument": {
          "type": "song"
        },
        "mute": false,
        "solo": false,
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "enabled": true,
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "type": "audio",
        "amplitude": 1,
        "clipCreationIntents": [],
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "Pallavi:",
        "id": "6f82a355-81b0-4399-918c-a8b2e8897809",
        "arm": false,
        "height": 160
      },
      {
        "color": "#FF6A00",
        "takeLanes": [],
        "clips": [],
        "instrument": {
          "type": "song"
        },
        "mute": false,
        "solo": false,
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "enabled": true,
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "type": "audio",
        "amplitude": 1,
        "clipCreationIntents": [],
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "f5678",
        "id": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
        "arm": false,
        "height": 88
      }
    ],
    "layout": {},
    "amplitude": 1,
    "songFadeOutBeats": 0,
    "selection": {
      "contextAfterBeats": 32,
      "contextBeforeBeats": 32,
      "trackIds": ["4246a4c1-d5c2-4bd5-9277-a258c8376138"],
      "focusedArea": "tracks",
      "warpMarkerSeconds": {},
      "focusedTrackId": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
      "anchorBeats": 0,
      "focusBeats": 0,
      "noteIds": []
    },
    "loop": {
      "endBeats": 32,
      "enabled": false,
      "startBeats": 0
    },
    "editorPointerModes": {
      "midi": "select",
      "audio": "select"
    },
    "metronome": {
      "amplitude": 1,
      "enabled": false
    },
    "timeSignatureChanges": [
      {
        "beatsPerSubdivision": 1,
        "subdivisionsPerBar": 4,
        "startBeats": 0
      }
    ],
    "songFadeInBeats": 0,
    "lyricsCorrectionsByClipId": {}
  }
}

{
  "latest_version_id": "e110a173-f27f-4600-ad8b-3ecfc4094b8c",
  "id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "created_at": "2026-02-04T07:17:40.234Z",
  "updated_at": "2026-02-04T07:18:55.671Z",
  "archived": false,
  "state": {
    "timing": {
      "type": "follow-track",
      "fallbackBPS": 1.3310740821581821,
      "trackId": "6f82a355-81b0-4399-918c-a8b2e8897809"
    },
    "markersRegistry": {
      "warp_69dffbeb19cd7394e4e6074b946f6ca1": {
        "148.9351": 198,
        "115.9579": 154,
        "4.6572": 6,
        "90.097": 120,
        .......
        "80.3501": 107,
        "55.615": 74
      }
    },
    "title": "Pallavi2:",
    "tracks": [
      {
        "color": "#7251F7",
        "takeLanes": [],
        "clips": [
          {
            "color": "#FF6A00",
            "startBeats": -0.2135326304550914,
            "mute": false,
            "type": "audio",
            "fadeInBeats": 0,
            "transposition": 0,
            "amplitude": 1,
            "fadeOutBeats": 0,
            "streaming": false,
            "loop": {
              "endBeats": 211.05525156813027,
              "enabled": false,
              "startBeats": -0.2135326304550914
            },
            "clipId": "853389ca-4ef6-4d70-a0f1-e88cb25ef301",
            "endBeats": 211.05525156813027,
            "name": "Pallavi:",
            "readStartBeats": -0.2135326304550914,
            "id": "7064a65c-5bbc-43e2-b1b5-ace00e962f63",
            "warp": {
              "awaitingAnalysis": false,
              "markersHash": "warp_69dffbeb19cd7394e4e6074b946f6ca1",
              "lastMarkerAssignment": "OnBeat",
              "enabled": true
            }
          }
        ],
        "instrument": {
          "type": "song"
        },
        "mute": false,
        "solo": false,
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "enabled": true,
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "type": "audio",
        "amplitude": 1,
        "clipCreationIntents": [],
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "Pallavi:",
        "id": "6f82a355-81b0-4399-918c-a8b2e8897809",
        "arm": false,
        "height": 160
      },
      {
        "color": "#FF6A00",
        "takeLanes": [],
        "clips": [],
        "instrument": {
          "type": "song"
        },
        "mute": false,
        "solo": false,
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "enabled": true,
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "type": "audio",
        "amplitude": 1,
        "clipCreationIntents": [],
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "f5678",
        "id": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
        "arm": false,
        "height": 88
      }
    ],
    "layout": {},
    "amplitude": 1,
    "songFadeOutBeats": 0,
    "selection": {
      "contextAfterBeats": 32,
      "contextBeforeBeats": 32,
      "trackIds": ["4246a4c1-d5c2-4bd5-9277-a258c8376138"],
      "focusedArea": "tracks",
      "warpMarkerSeconds": {},
      "focusedTrackId": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
      "anchorBeats": 0,
      "focusBeats": 0,
      "noteIds": []
    },
    "loop": {
      "endBeats": 32,
      "enabled": false,
      "startBeats": 0
    },
    "editorPointerModes": {
      "midi": "select",
      "audio": "select"
    },
    "metronome": {
      "amplitude": 1,
      "enabled": false
    },
    "timeSignatureChanges": [
      {
        "beatsPerSubdivision": 1,
        "subdivisionsPerBar": 4,
        "startBeats": 0
      }
    ],
    "songFadeInBeats": 0,
    "lyricsCorrectionsByClipId": {}
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221

C. Update

Cross-account access not supported
POST https://api.openai-hk.com/suno/act/project/{project_id}
Request body:

json

{
  "project_id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "state": {
    "timing": {
      "type": "follow-track",
      "fallbackBPS": 1.3310740821581821,
      "trackId": "6f82a355-81b0-4399-918c-a8b2e8897809"
    },
    "title": "Pallavi2:",
    "tracks": [
      {
        "color": "#7251F7",
        "takeLanes": [],
        "clips": [
          {
            "color": "#FF6A00",
            "startBeats": -0.2135326304550914,
            "mute": false,
            "type": "audio",
            "fadeInBeats": 0,
            "transposition": 0,
            "streaming": false,
            "fadeOutBeats": 0,
            "amplitude": 1,
            "loop": {
              "endBeats": 211.05525156813027,
              "enabled": false,
              "startBeats": -0.2135326304550914
            },
            "clipId": "853389ca-4ef6-4d70-a0f1-e88cb25ef301",
            "name": "Pallavi:",
            "endBeats": 211.05525156813027,
            "readStartBeats": -0.2135326304550914,
            "id": "7064a65c-5bbc-43e2-b1b5-ace00e962f63",
            "warp": {
              "awaitingAnalysis": false,
              "lastMarkerAssignment": "OnBeat",
              "enabled": true,
              "markersHash": "warp_69dffbeb19cd7394e4e6074b946f6ca1"
            },
            "uploadId": null
          }
        ],
        "solo": false,
        "mute": false,
        "instrument": {
          "type": "song"
        },
        "type": "audio",
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "enabled": true,
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "clipCreationIntents": [],
        "amplitude": 1,
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "Pallavi:",
        "id": "6f82a355-81b0-4399-918c-a8b2e8897809",
        "arm": false,
        "height": 160,
        "input": null,
        "soloTakeLaneId": null
      },
      {
        "color": "#FF6A00",
        "takeLanes": [],
        "clips": [],
        "solo": false,
        "mute": false,
        "instrument": {
          "type": "song"
        },
        "type": "audio",
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "enabled": true,
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "clipCreationIntents": [],
        "amplitude": 1,
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "f5678",
        "id": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
        "arm": false,
        "height": 88,
        "input": null,
        "soloTakeLaneId": null
      }
    ],
    "layout": {
      "editorPanelType": null
    },
    "amplitude": 1,
    "songFadeOutBeats": 0,
    "selection": {
      "contextAfterBeats": 32,
      "contextBeforeBeats": 32,
      "trackIds": ["4246a4c1-d5c2-4bd5-9277-a258c8376138"],
      "focusedArea": "tracks",
      "warpMarkerSeconds": {},
      "focusedTrackId": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
      "anchorBeats": 0,
      "focusBeats": 0,
      "noteIds": [],
      "arrangementAnchorBeats": null,
      "arrangementFocusBeats": null
    },
    "loop": {
      "endBeats": 32,
      "enabled": false,
      "startBeats": 0
    },
    "metronome": {
      "enabled": false,
      "amplitude": 1
    },
    "editorPointerModes": {
      "midi": "select",
      "audio": "select"
    },
    "timeSignatureChanges": [
      {
        "startBeats": 0,
        "subdivisionsPerBar": 4,
        "beatsPerSubdivision": 1
      }
    ],
    "songFadeInBeats": 0,
    "lyricsCorrectionsByClipId": {},
    "markersRegistry": {
      "warp_69dffbeb19cd7394e4e6074b946f6ca1": {
        "148.9351": 198,
        "4.6572": 6,
        // omitted here
        "55.615": 74
      }
    }
  }
}

{
  "project_id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "state": {
    "timing": {
      "type": "follow-track",
      "fallbackBPS": 1.3310740821581821,
      "trackId": "6f82a355-81b0-4399-918c-a8b2e8897809"
    },
    "title": "Pallavi2:",
    "tracks": [
      {
        "color": "#7251F7",
        "takeLanes": [],
        "clips": [
          {
            "color": "#FF6A00",
            "startBeats": -0.2135326304550914,
            "mute": false,
            "type": "audio",
            "fadeInBeats": 0,
            "transposition": 0,
            "streaming": false,
            "fadeOutBeats": 0,
            "amplitude": 1,
            "loop": {
              "endBeats": 211.05525156813027,
              "enabled": false,
              "startBeats": -0.2135326304550914
            },
            "clipId": "853389ca-4ef6-4d70-a0f1-e88cb25ef301",
            "name": "Pallavi:",
            "endBeats": 211.05525156813027,
            "readStartBeats": -0.2135326304550914,
            "id": "7064a65c-5bbc-43e2-b1b5-ace00e962f63",
            "warp": {
              "awaitingAnalysis": false,
              "lastMarkerAssignment": "OnBeat",
              "enabled": true,
              "markersHash": "warp_69dffbeb19cd7394e4e6074b946f6ca1"
            },
            "uploadId": null
          }
        ],
        "solo": false,
        "mute": false,
        "instrument": {
          "type": "song"
        },
        "type": "audio",
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "enabled": true,
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "clipCreationIntents": [],
        "amplitude": 1,
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "Pallavi:",
        "id": "6f82a355-81b0-4399-918c-a8b2e8897809",
        "arm": false,
        "height": 160,
        "input": null,
        "soloTakeLaneId": null
      },
      {
        "color": "#FF6A00",
        "takeLanes": [],
        "clips": [],
        "solo": false,
        "mute": false,
        "instrument": {
          "type": "song"
        },
        "type": "audio",
        "eq": {
          "band5": {
            "q": 0.707,
            "type": "highshelf",
            "enabled": true,
            "frequency": 3200,
            "gain": 0
          },
          "band6": {
            "q": 0.707,
            "type": "lowpass",
            "enabled": false,
            "frequency": 8800,
            "gain": 0
          },
          "band3": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 450,
            "gain": 0
          },
          "band4": {
            "q": 0.707,
            "type": "peaking",
            "enabled": true,
            "frequency": 1200,
            "gain": 0
          },
          "enabled": true,
          "band1": {
            "q": 0.707,
            "type": "highpass",
            "enabled": false,
            "frequency": 60,
            "gain": 0
          },
          "band2": {
            "q": 0.707,
            "type": "lowshelf",
            "enabled": true,
            "frequency": 160,
            "gain": 0
          }
        },
        "clipCreationIntents": [],
        "amplitude": 1,
        "takeLanesExpanded": false,
        "balance": 0,
        "name": "f5678",
        "id": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
        "arm": false,
        "height": 88,
        "input": null,
        "soloTakeLaneId": null
      }
    ],
    "layout": {
      "editorPanelType": null
    },
    "amplitude": 1,
    "songFadeOutBeats": 0,
    "selection": {
      "contextAfterBeats": 32,
      "contextBeforeBeats": 32,
      "trackIds": ["4246a4c1-d5c2-4bd5-9277-a258c8376138"],
      "focusedArea": "tracks",
      "warpMarkerSeconds": {},
      "focusedTrackId": "4246a4c1-d5c2-4bd5-9277-a258c8376138",
      "anchorBeats": 0,
      "focusBeats": 0,
      "noteIds": [],
      "arrangementAnchorBeats": null,
      "arrangementFocusBeats": null
    },
    "loop": {
      "endBeats": 32,
      "enabled": false,
      "startBeats": 0
    },
    "metronome": {
      "enabled": false,
      "amplitude": 1
    },
    "editorPointerModes": {
      "midi": "select",
      "audio": "select"
    },
    "timeSignatureChanges": [
      {
        "startBeats": 0,
        "subdivisionsPerBar": 4,
        "beatsPerSubdivision": 1
      }
    ],
    "songFadeInBeats": 0,
    "lyricsCorrectionsByClipId": {},
    "markersRegistry": {
      "warp_69dffbeb19cd7394e4e6074b946f6ca1": {
        "148.9351": 198,
        "4.6572": 6,
        // omitted here
        "55.615": 74
      }
    }
  }
}

Response:

json

{
  "version_id": "e110a173-f27f-4600-ad8b-3ecfc4094b8c",
  "id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "created_at": "2026-02-04T07:17:40.234Z",
  "updated_at": "2026-02-04T07:18:55.671Z",
  "archived": false
}

{
  "version_id": "e110a173-f27f-4600-ad8b-3ecfc4094b8c",
  "id": "da863f42-7d90-4460-806b-66d37ee1e5cd",
  "title": "newName",
  "created_at": "2026-02-04T07:17:40.234Z",
  "updated_at": "2026-02-04T07:18:55.671Z",
  "archived": false
}

1. Create a New Song

Through the creation API, get the new song id as id_mather, where one of the clip_id values is clip_id_mather
Example: project_id = b7d43125-314b-4eb9-97d7-99f4113f7cb0
Example: clip_id_mather = bb91d24d-27b5-4dd0-9ace-4861184daaee

2. Create a Render

POST https://api.openai-hk.com/suno/render

json

curl --request POST \
  --url https://api.openai-hk.com/suno/render \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{"title":"Untitled Project [00:26 - 01:44]","lyrics":"[Instrumental]","state":{"amplitude":1,"lyricsCorrectionsByClipId":{},"metronome":{"enabled":false,"amplitude":1},"timing":{"bpsAutomation":[{"beats":-0.3115577889447236,"value":1.2256403971074885,"curve":0},{"beats":0,"value":1.2256403971074885,"curve":0},{"beats":1,"value":1.2242899118511263,"curve":0},{"beats":3,"value":1.2248897599216073,"curve":0},{"beats":4,"value":1.2250398137939476,"curve":0},{"beats":5,"value":1.2250398137939482,"curve":0},{"beats":7,"value":1.2247397428046547,"curve":0},{"beats":8,"value":1.2250398137939482,"curve":0},{"beats":9,"value":1.2233912405187177,"curve":0},{"beats":10,"value":1.22534003185884,"curve":0},{"beats":11,"value":1.225490196078433,"curve":0},{"beats":12,"value":1.2269938650306729,"curve":0},{"beats":13,"value":1.2229423994129898,"curve":0},{"beats":14,"value":1.225790634959547,"curve":0},{"beats":15,"value":1.225189904435187,"curve":0},{"beats":16,"value":1.2241400416207635,"curve":0},{"beats":17,"value":1.2238404112103782,"curve":0},{"beats":18,"value":1.2259409096481528,"curve":0},{"beats":19,"value":1.2244398187829082,"curve":0},{"beats":20,"value":1.2241400416207608,"curve":0},{"beats":21,"value":1.2262415695892088,"curve":0},{"beats":22,"value":1.2250398137939509,"curve":0},{"beats":23,"value":1.2253400318588374,"curve":0},{"beats":24,"value":1.2244398187829055,"curve":0},{"beats":25,"value":1.2245897624295898,"curve":0},{"beats":26,"value":1.2256403971074898,"curve":0},{"beats":27,"value":1.2230919765166306,"curve":0},{"beats":28,"value":1.2257906349595498,"curve":0},{"beats":29,"value":1.2259409096481555,"curve":0},{"beats":30,"value":1.2223444566678874,"curve":0},{"beats":31,"value":1.2256403971074898,"curve":0},{"beats":32,"value":1.2268433321064884,"curve":0},{"beats":33,"value":1.22488975992161,"curve":0},{"beats":34,"value":1.2239902080783351,"curve":0},{"beats":35,"value":1.2242899118511255,"curve":0},{"beats":36,"value":1.229105211406095,"curve":0},{"beats":37,"value":1.2210012210012224,"curve":0},{"beats":38,"value":1.2259409096481555,"curve":0},{"beats":39,"value":1.2257906349595444,"curve":0},{"beats":40,"value":1.225189904435195,"curve":0},{"beats":41,"value":1.2232415902140634,"curve":0},{"beats":42,"value":1.2266928361138412,"curve":0},{"beats":43,"value":1.2235409274440185,"curve":0},{"beats":44,"value":1.2241400416207662,"curve":0},{"beats":45,"value":1.2274456855284124,"curve":0},{"beats":46,"value":1.2224938875305655,"curve":0},{"beats":47,"value":1.2256403971074792,"curve":0},{"beats":48,"value":1.2250398137939509,"curve":0},{"beats":49,"value":1.2247397428046574,"curve":0},{"beats":50,"value":1.2250398137939509,"curve":0},{"beats":51,"value":1.2232415902140634,"curve":0},{"beats":52,"value":1.2269938650306782,"curve":0},{"beats":53,"value":1.2245897624295845,"curve":0},{"beats":54,"value":1.2254901960784277,"curve":0},{"beats":55,"value":1.2244398187829109,"curve":0},{"beats":56,"value":1.2250398137939509,"curve":0},{"beats":57,"value":1.2244398187829002,"curve":0},{"beats":58,"value":1.2253400318588428,"curve":0},{"beats":59,"value":1.2251899044351844,"curve":0},{"beats":60,"value":1.2239902080783351,"curve":0},{"beats":61,"value":1.2260912211868618,"curve":0},{"beats":62,"value":1.223840411210373,"curve":0},{"beats":63,"value":1.2272950417280342,"curve":0},{"beats":64,"value":1.2244398187829109,"curve":0},{"beats":65,"value":1.2239902080783351,"curve":0},{"beats":66,"value":1.2256403971074898,"curve":0},{"beats":67,"value":1.2241400416207555,"curve":0},{"beats":68,"value":1.2248897599216046,"curve":0},{"beats":69,"value":1.2247397428046574,"curve":0},{"beats":70,"value":1.2245897624295845,"curve":0},{"beats":71,"value":1.2253400318588428,"curve":0},{"beats":72,"value":1.2266928361138412,"curve":0},{"beats":73,"value":1.2239902080783351,"curve":0},{"beats":74,"value":1.2245897624295845,"curve":0},{"beats":75,"value":1.2226433549333635,"curve":0},{"beats":76,"value":1.2286521685710825,"curve":0},{"beats":77,"value":1.2230919765166253,"curve":0},{"beats":78,"value":1.2262415695892088,"curve":0},{"beats":79,"value":1.2241400416207768,"curve":0},{"beats":80,"value":1.2248897599216046,"curve":0},{"beats":81,"value":1.2263919548687594,"curve":0},{"beats":82,"value":1.2212994626282425,"curve":0},{"beats":83,"value":1.2266928361138305,"curve":0},{"beats":84,"value":1.2244398187829109,"curve":0},{"beats":85,"value":1.226091221186851,"curve":0},{"beats":86,"value":1.225189904435195,"curve":0},{"beats":87,"value":1.2244398187829109,"curve":0},{"beats":88,"value":1.2259409096481448,"curve":0},{"beats":89,"value":1.223241590214074,"curve":0},{"beats":90,"value":1.226091221186851,"curve":0},{"beats":91,"value":1.2241400416207768,"curve":0},{"beats":92,"value":1.2254901960784277,"curve":0},{"beats":93,"value":1.2251899044351737,"curve":0},{"beats":94,"value":1.224739742804668,"curve":0},{"beats":95,"value":1.2248897599216046,"curve":0},{"beats":96,"value":1.225790634959555,"curve":0},{"beats":97,"value":1.2245897624295738,"curve":0},{"beats":98,"value":1.2241400416207555,"curve":0},{"beats":99,"value":1.2250398137939509,"curve":0},{"beats":100,"value":1.2248897599216046,"curve":0},{"beats":101,"value":1.224889759921626,"curve":0},{"beats":102,"value":1.2257906349595338,"curve":0},{"beats":103,"value":1.2239902080783458,"curve":0},{"beats":104,"value":1.2250398137939509,"curve":0},{"beats":105,"value":1.2275963663147578,"curve":0},{"beats":106,"value":1.2232415902140528,"curve":0},{"beats":107,"value":1.2244398187829109,"curve":0},{"beats":109,"value":1.2250398137939509,"curve":0},{"beats":110,"value":1.2262415695892088,"curve":0},{"beats":111,"value":1.223091976516636,"curve":0},{"beats":112,"value":1.2250398137939509,"curve":0},{"beats":113,"value":1.2257906349595338,"curve":0},{"beats":114,"value":1.2250398137939509,"curve":0},{"beats":115,"value":1.2241400416207555,"curve":0},{"beats":116,"value":1.2242899118511255,"curve":0},{"beats":117,"value":1.2256403971074898,"curve":0},{"beats":118,"value":1.2245897624295952,"curve":0},{"beats":119,"value":1.225790634959555,"curve":0},{"beats":120,"value":1.2245897624295738,"curve":0},{"beats":121,"value":1.224739742804668,"curve":0},{"beats":122,"value":1.2253400318588321,"curve":0},{"beats":124,"value":1.224889759921626,"curve":0},{"beats":125,"value":1.2241400416207555,"curve":0},{"beats":126,"value":1.2247397428046467,"curve":0},{"beats":127,"value":1.2253400318588534,"curve":0},{"beats":128,"value":1.2245897624295738,"curve":0},{"beats":129,"value":1.2233912405187297,"curve":0},{"beats":130,"value":1.2266928361138305,"curve":0},{"beats":131,"value":1.2254901960784277,"curve":0},{"beats":132,"value":1.2239902080783458,"curve":0},{"beats":133,"value":1.2256403971074685,"curve":0},{"beats":134,"value":1.2235409274440396,"curve":0},{"beats":135,"value":1.2238404112103622,"curve":0},{"beats":136,"value":1.2260912211868724,"curve":0},{"beats":137,"value":1.2242899118511255,"curve":0},{"beats":138,"value":1.16333178222429,"curve":0},{"beats":139,"value":1.1344299489506489,"curve":0},{"beats":140,"value":1.1227124733355847,"curve":0},{"beats":141,"value":1.1191941801902592,"curve":0},{"beats":142,"value":1.1129660545353386,"curve":0},{"beats":143,"value":1.1091393078970695,"curve":0},{"beats":144,"value":1.1107408641563905,"curve":0},{"beats":145,"value":1.1103708638685357,"curve":0},{"beats":146,"value":1.1124707976415649,"curve":0},{"beats":147,"value":1.1147029316686992,"curve":0},{"beats":148,"value":1.107419712070885,"curve":0},{"beats":149,"value":1.1113580795732396,"curve":0},{"beats":150,"value":1.1122233344455514,"curve":0},{"beats":151,"value":1.1060723371308487,"curve":0},{"beats":152,"value":1.115075825156112,"curve":0},{"beats":153.5577609277431,"value":1.115075825156112,"curve":0}],"firstBeatSeconds":0,"bps":1.2130977508411211,"type":"manual"},"tracks":[{"id":"b7d43125-314b-4eb9-97d7-99f4113f7cb0","input":null,"color":"#208BFF","icon":"Audio","name":"New Track","clips":[{"streaming":false,"id":"03a39b3b-79ca-4473-bca2-2e36c5cc94ff","clipId":"bb91d24d-27b5-4dd0-9ace-4861184daaee","uploadId":null,"mute":false,"name":"Return to Eternal Light","color":"#D4BB03","startBeats":-0.3115577889447236,"endBeats":153.5577609277431,"readStartBeats":-0.3115577889447236,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-0.3115577889447236,"endBeats":153.5577609277431},"warp":{"enabled":true,"markers":{"0.2542":0,"1.0701":1,"1.8869":2,"2.7037":3,"3.5201":4,"4.3364":5,"5.1527":6,"5.969":7,"6.7855":8,"7.6018":9,"8.4192":10,"9.2353":11,"10.0513":12,"10.8663":13,"11.684":14,"12.4998":15,"13.316":16,"14.1329":17,"14.95":18,"15.7657":19,"16.5824":20,"17.3993":21,"18.2148":22,"19.0311":23,"19.8472":24,"20.6639":25,"21.4805":26,"22.2964":27,"23.114":28,"23.9298":29,"24.7455":30,"25.5636":31,"26.3795":32,"27.1946":33,"28.011":34,"28.828":35,"29.6448":36,"30.4584":37,"31.2774":38,"32.0931":39,"32.9089":40,"33.7251":41,"34.5426":42,"35.3578":43,"36.1751":44,"36.992":45,"37.8067":46,"38.6247":47,"39.4406":48,"40.2569":49,"41.0734":50,"41.8897":51,"42.7072":52,"43.5222":53,"44.3388":54,"45.1548":55,"45.9715":56,"46.7878":57,"47.6045":58,"48.4206":59,"49.2368":60,"50.0538":61,"50.8694":62,"51.6865":63,"52.5013":64,"53.318":65,"54.135":66,"54.9509":67,"55.7678":68,"56.5842":69,"57.4007":70,"58.2173":71,"59.0334":72,"59.8486":73,"60.6656":74,"61.4822":75,"62.3001":76,"63.114":77,"63.9316":78,"64.7471":79,"65.564":80,"66.3804":81,"67.1958":82,"68.0146":83,"68.8298":84,"69.6465":85,"70.4621":86,"71.2783":87,"72.095":88,"72.9107":89,"73.7282":90,"74.5438":91,"75.3607":92,"76.1767":93,"76.9929":94,"77.8094":95,"78.6258":96,"79.4416":97,"80.2582":98,"81.0751":99,"81.8914":100,"82.7078":101,"83.5242":102,"84.34":103,"85.157":104,"85.9733":105,"86.7879":106,"87.6054":107,"88.4221":108,"89.2388":109,"90.0551":110,"90.8706":111,"91.6882":112,"92.5045":113,"93.3203":114,"94.1366":115,"94.9535":116,"95.7703":117,"96.5862":118,"97.4028":119,"98.2186":120,"99.0352":121,"99.8517":122,"100.6678":123,"101.4839":124,"102.3003":125,"103.1172":126,"103.9337":127,"104.7498":128,"105.5664":129,"106.3838":130,"107.199":131,"108.015":132,"108.832":133,"109.6479":134,"110.4652":135,"111.2823":136,"112.0979":137,"112.9147":138,"113.7743":139,"114.6558":140,"115.5465":141,"116.44":142,"117.3385":143,"118.2401":144,"119.1404":145,"120.041":146,"120.9399":147,"121.837":148,"122.74":149,"123.6398":150,"124.5389":151,"125.443":152,"126.3398":153},"awaitingAnalysis":false,"speed":1}}],"clipCreationIntents":[],"height":160,"solo":false,"mute":false,"arm":false,"amplitude":1,"balance":0,"instrument":{"type":"song"},"soloTakeLaneId":null,"takeLanesExpanded":false,"takeLanes":[]}],"selection":{"anchorBeats":0,"focusBeats":0,"trackIds":[],"focusedTrackId":null,"focusedArea":null},"loop":{"enabled":false,"startBeats":0,"endBeats":0},"songFadeInBeats":0,"songFadeOutBeats":0},"project_id":"default","from_studio_project_id":"b7d43125-314b-4eb9-97d7-99f4113f7cb0","start_beats":32,"end_beats":128,"downbeats":[[0,1],[0.815100000000001,2],[1.631499999999999,3],[2.4484999999999992,4],[3.2653,1],[4.078900000000001,2],[4.8979,3],[5.7136,4],[6.529400000000006,1],[7.345600000000001,2],[8.163100000000004,3],[8.9783,4],[9.795600000000004,1],[10.6125,2],[11.427200000000003,3],[12.2452,4],[13.061100000000007,1],[13.877400000000005,2],[14.693900000000003,3],[15.510200000000001,4],[16.327700000000004,1],[17.1427,2],[17.959300000000002,3],[18.775300000000005,4],[19.592000000000002,1],[20.4083,2],[21.225000000000005,3],[22.041100000000004,4],[22.857300000000006,1],[23.674300000000006,2],[24.489900000000002,3],[25.307000000000006,4],[26.121800000000004,1],[26.9385,2],[27.7555,3],[28.5714,4],[29.388300000000005,1],[30.204700000000006,2],[31.021200000000004,3],[31.837800000000005,4],[32.65390000000001,1],[33.4691,2],[34.286100000000005,3],[35.1027,4],[35.92060000000001,1],[36.7345,2],[37.55210000000001,3],[38.36760000000001,4],[39.1845,1],[40.0009,2],[40.81630000000001,3],[41.63510000000001,4],[42.45030000000001,1],[43.26700000000001,2],[44.08260000000001,3],[44.89880000000001,4],[45.715500000000006,1],[46.53120000000001,2],[47.34870000000001,3],[48.16430000000001,4],[48.9812,1],[49.797200000000004,2],[50.61340000000001,3],[51.4299,4],[52.246300000000005,1],[53.0621,2],[53.87870000000001,3],[54.69560000000001,4],[55.51190000000001,1],[56.32830000000001,2],[57.1447,3],[57.96050000000001,4],[58.7775,1],[59.5938,2],[60.4084,3],[61.22590000000001,4],[62.04260000000001,1],[62.859300000000005,2],[63.6756,3],[64.4911,4],[65.3087,1],[66.125,2],[66.94080000000001,3],[67.75710000000001,4],[68.57400000000001,1],[69.39080000000001,2],[70.20670000000001,3],[71.0233,4],[71.8391,1],[72.65570000000001,2],[73.4722,3],[74.2883,4],[75.10440000000001,1],[75.9208,2],[76.7377,3],[77.55420000000001,4]],"web_client_pathname":"/studio"}'

curl --request POST \
  --url https://api.openai-hk.com/suno/render \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{"title":"Untitled Project [00:26 - 01:44]","lyrics":"[Instrumental]","state":{"amplitude":1,"lyricsCorrectionsByClipId":{},"metronome":{"enabled":false,"amplitude":1},"timing":{"bpsAutomation":[{"beats":-0.3115577889447236,"value":1.2256403971074885,"curve":0},{"beats":0,"value":1.2256403971074885,"curve":0},{"beats":1,"value":1.2242899118511263,"curve":0},{"beats":3,"value":1.2248897599216073,"curve":0},{"beats":4,"value":1.2250398137939476,"curve":0},{"beats":5,"value":1.2250398137939482,"curve":0},{"beats":7,"value":1.2247397428046547,"curve":0},{"beats":8,"value":1.2250398137939482,"curve":0},{"beats":9,"value":1.2233912405187177,"curve":0},{"beats":10,"value":1.22534003185884,"curve":0},{"beats":11,"value":1.225490196078433,"curve":0},{"beats":12,"value":1.2269938650306729,"curve":0},{"beats":13,"value":1.2229423994129898,"curve":0},{"beats":14,"value":1.225790634959547,"curve":0},{"beats":15,"value":1.225189904435187,"curve":0},{"beats":16,"value":1.2241400416207635,"curve":0},{"beats":17,"value":1.2238404112103782,"curve":0},{"beats":18,"value":1.2259409096481528,"curve":0},{"beats":19,"value":1.2244398187829082,"curve":0},{"beats":20,"value":1.2241400416207608,"curve":0},{"beats":21,"value":1.2262415695892088,"curve":0},{"beats":22,"value":1.2250398137939509,"curve":0},{"beats":23,"value":1.2253400318588374,"curve":0},{"beats":24,"value":1.2244398187829055,"curve":0},{"beats":25,"value":1.2245897624295898,"curve":0},{"beats":26,"value":1.2256403971074898,"curve":0},{"beats":27,"value":1.2230919765166306,"curve":0},{"beats":28,"value":1.2257906349595498,"curve":0},{"beats":29,"value":1.2259409096481555,"curve":0},{"beats":30,"value":1.2223444566678874,"curve":0},{"beats":31,"value":1.2256403971074898,"curve":0},{"beats":32,"value":1.2268433321064884,"curve":0},{"beats":33,"value":1.22488975992161,"curve":0},{"beats":34,"value":1.2239902080783351,"curve":0},{"beats":35,"value":1.2242899118511255,"curve":0},{"beats":36,"value":1.229105211406095,"curve":0},{"beats":37,"value":1.2210012210012224,"curve":0},{"beats":38,"value":1.2259409096481555,"curve":0},{"beats":39,"value":1.2257906349595444,"curve":0},{"beats":40,"value":1.225189904435195,"curve":0},{"beats":41,"value":1.2232415902140634,"curve":0},{"beats":42,"value":1.2266928361138412,"curve":0},{"beats":43,"value":1.2235409274440185,"curve":0},{"beats":44,"value":1.2241400416207662,"curve":0},{"beats":45,"value":1.2274456855284124,"curve":0},{"beats":46,"value":1.2224938875305655,"curve":0},{"beats":47,"value":1.2256403971074792,"curve":0},{"beats":48,"value":1.2250398137939509,"curve":0},{"beats":49,"value":1.2247397428046574,"curve":0},{"beats":50,"value":1.2250398137939509,"curve":0},{"beats":51,"value":1.2232415902140634,"curve":0},{"beats":52,"value":1.2269938650306782,"curve":0},{"beats":53,"value":1.2245897624295845,"curve":0},{"beats":54,"value":1.2254901960784277,"curve":0},{"beats":55,"value":1.2244398187829109,"curve":0},{"beats":56,"value":1.2250398137939509,"curve":0},{"beats":57,"value":1.2244398187829002,"curve":0},{"beats":58,"value":1.2253400318588428,"curve":0},{"beats":59,"value":1.2251899044351844,"curve":0},{"beats":60,"value":1.2239902080783351,"curve":0},{"beats":61,"value":1.2260912211868618,"curve":0},{"beats":62,"value":1.223840411210373,"curve":0},{"beats":63,"value":1.2272950417280342,"curve":0},{"beats":64,"value":1.2244398187829109,"curve":0},{"beats":65,"value":1.2239902080783351,"curve":0},{"beats":66,"value":1.2256403971074898,"curve":0},{"beats":67,"value":1.2241400416207555,"curve":0},{"beats":68,"value":1.2248897599216046,"curve":0},{"beats":69,"value":1.2247397428046574,"curve":0},{"beats":70,"value":1.2245897624295845,"curve":0},{"beats":71,"value":1.2253400318588428,"curve":0},{"beats":72,"value":1.2266928361138412,"curve":0},{"beats":73,"value":1.2239902080783351,"curve":0},{"beats":74,"value":1.2245897624295845,"curve":0},{"beats":75,"value":1.2226433549333635,"curve":0},{"beats":76,"value":1.2286521685710825,"curve":0},{"beats":77,"value":1.2230919765166253,"curve":0},{"beats":78,"value":1.2262415695892088,"curve":0},{"beats":79,"value":1.2241400416207768,"curve":0},{"beats":80,"value":1.2248897599216046,"curve":0},{"beats":81,"value":1.2263919548687594,"curve":0},{"beats":82,"value":1.2212994626282425,"curve":0},{"beats":83,"value":1.2266928361138305,"curve":0},{"beats":84,"value":1.2244398187829109,"curve":0},{"beats":85,"value":1.226091221186851,"curve":0},{"beats":86,"value":1.225189904435195,"curve":0},{"beats":87,"value":1.2244398187829109,"curve":0},{"beats":88,"value":1.2259409096481448,"curve":0},{"beats":89,"value":1.223241590214074,"curve":0},{"beats":90,"value":1.226091221186851,"curve":0},{"beats":91,"value":1.2241400416207768,"curve":0},{"beats":92,"value":1.2254901960784277,"curve":0},{"beats":93,"value":1.2251899044351737,"curve":0},{"beats":94,"value":1.224739742804668,"curve":0},{"beats":95,"value":1.2248897599216046,"curve":0},{"beats":96,"value":1.225790634959555,"curve":0},{"beats":97,"value":1.2245897624295738,"curve":0},{"beats":98,"value":1.2241400416207555,"curve":0},{"beats":99,"value":1.2250398137939509,"curve":0},{"beats":100,"value":1.2248897599216046,"curve":0},{"beats":101,"value":1.224889759921626,"curve":0},{"beats":102,"value":1.2257906349595338,"curve":0},{"beats":103,"value":1.2239902080783458,"curve":0},{"beats":104,"value":1.2250398137939509,"curve":0},{"beats":105,"value":1.2275963663147578,"curve":0},{"beats":106,"value":1.2232415902140528,"curve":0},{"beats":107,"value":1.2244398187829109,"curve":0},{"beats":109,"value":1.2250398137939509,"curve":0},{"beats":110,"value":1.2262415695892088,"curve":0},{"beats":111,"value":1.223091976516636,"curve":0},{"beats":112,"value":1.2250398137939509,"curve":0},{"beats":113,"value":1.2257906349595338,"curve":0},{"beats":114,"value":1.2250398137939509,"curve":0},{"beats":115,"value":1.2241400416207555,"curve":0},{"beats":116,"value":1.2242899118511255,"curve":0},{"beats":117,"value":1.2256403971074898,"curve":0},{"beats":118,"value":1.2245897624295952,"curve":0},{"beats":119,"value":1.225790634959555,"curve":0},{"beats":120,"value":1.2245897624295738,"curve":0},{"beats":121,"value":1.224739742804668,"curve":0},{"beats":122,"value":1.2253400318588321,"curve":0},{"beats":124,"value":1.224889759921626,"curve":0},{"beats":125,"value":1.2241400416207555,"curve":0},{"beats":126,"value":1.2247397428046467,"curve":0},{"beats":127,"value":1.2253400318588534,"curve":0},{"beats":128,"value":1.2245897624295738,"curve":0},{"beats":129,"value":1.2233912405187297,"curve":0},{"beats":130,"value":1.2266928361138305,"curve":0},{"beats":131,"value":1.2254901960784277,"curve":0},{"beats":132,"value":1.2239902080783458,"curve":0},{"beats":133,"value":1.2256403971074685,"curve":0},{"beats":134,"value":1.2235409274440396,"curve":0},{"beats":135,"value":1.2238404112103622,"curve":0},{"beats":136,"value":1.2260912211868724,"curve":0},{"beats":137,"value":1.2242899118511255,"curve":0},{"beats":138,"value":1.16333178222429,"curve":0},{"beats":139,"value":1.1344299489506489,"curve":0},{"beats":140,"value":1.1227124733355847,"curve":0},{"beats":141,"value":1.1191941801902592,"curve":0},{"beats":142,"value":1.1129660545353386,"curve":0},{"beats":143,"value":1.1091393078970695,"curve":0},{"beats":144,"value":1.1107408641563905,"curve":0},{"beats":145,"value":1.1103708638685357,"curve":0},{"beats":146,"value":1.1124707976415649,"curve":0},{"beats":147,"value":1.1147029316686992,"curve":0},{"beats":148,"value":1.107419712070885,"curve":0},{"beats":149,"value":1.1113580795732396,"curve":0},{"beats":150,"value":1.1122233344455514,"curve":0},{"beats":151,"value":1.1060723371308487,"curve":0},{"beats":152,"value":1.115075825156112,"curve":0},{"beats":153.5577609277431,"value":1.115075825156112,"curve":0}],"firstBeatSeconds":0,"bps":1.2130977508411211,"type":"manual"},"tracks":[{"id":"b7d43125-314b-4eb9-97d7-99f4113f7cb0","input":null,"color":"#208BFF","icon":"Audio","name":"New Track","clips":[{"streaming":false,"id":"03a39b3b-79ca-4473-bca2-2e36c5cc94ff","clipId":"bb91d24d-27b5-4dd0-9ace-4861184daaee","uploadId":null,"mute":false,"name":"Return to Eternal Light","color":"#D4BB03","startBeats":-0.3115577889447236,"endBeats":153.5577609277431,"readStartBeats":-0.3115577889447236,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-0.3115577889447236,"endBeats":153.5577609277431},"warp":{"enabled":true,"markers":{"0.2542":0,"1.0701":1,"1.8869":2,"2.7037":3,"3.5201":4,"4.3364":5,"5.1527":6,"5.969":7,"6.7855":8,"7.6018":9,"8.4192":10,"9.2353":11,"10.0513":12,"10.8663":13,"11.684":14,"12.4998":15,"13.316":16,"14.1329":17,"14.95":18,"15.7657":19,"16.5824":20,"17.3993":21,"18.2148":22,"19.0311":23,"19.8472":24,"20.6639":25,"21.4805":26,"22.2964":27,"23.114":28,"23.9298":29,"24.7455":30,"25.5636":31,"26.3795":32,"27.1946":33,"28.011":34,"28.828":35,"29.6448":36,"30.4584":37,"31.2774":38,"32.0931":39,"32.9089":40,"33.7251":41,"34.5426":42,"35.3578":43,"36.1751":44,"36.992":45,"37.8067":46,"38.6247":47,"39.4406":48,"40.2569":49,"41.0734":50,"41.8897":51,"42.7072":52,"43.5222":53,"44.3388":54,"45.1548":55,"45.9715":56,"46.7878":57,"47.6045":58,"48.4206":59,"49.2368":60,"50.0538":61,"50.8694":62,"51.6865":63,"52.5013":64,"53.318":65,"54.135":66,"54.9509":67,"55.7678":68,"56.5842":69,"57.4007":70,"58.2173":71,"59.0334":72,"59.8486":73,"60.6656":74,"61.4822":75,"62.3001":76,"63.114":77,"63.9316":78,"64.7471":79,"65.564":80,"66.3804":81,"67.1958":82,"68.0146":83,"68.8298":84,"69.6465":85,"70.4621":86,"71.2783":87,"72.095":88,"72.9107":89,"73.7282":90,"74.5438":91,"75.3607":92,"76.1767":93,"76.9929":94,"77.8094":95,"78.6258":96,"79.4416":97,"80.2582":98,"81.0751":99,"81.8914":100,"82.7078":101,"83.5242":102,"84.34":103,"85.157":104,"85.9733":105,"86.7879":106,"87.6054":107,"88.4221":108,"89.2388":109,"90.0551":110,"90.8706":111,"91.6882":112,"92.5045":113,"93.3203":114,"94.1366":115,"94.9535":116,"95.7703":117,"96.5862":118,"97.4028":119,"98.2186":120,"99.0352":121,"99.8517":122,"100.6678":123,"101.4839":124,"102.3003":125,"103.1172":126,"103.9337":127,"104.7498":128,"105.5664":129,"106.3838":130,"107.199":131,"108.015":132,"108.832":133,"109.6479":134,"110.4652":135,"111.2823":136,"112.0979":137,"112.9147":138,"113.7743":139,"114.6558":140,"115.5465":141,"116.44":142,"117.3385":143,"118.2401":144,"119.1404":145,"120.041":146,"120.9399":147,"121.837":148,"122.74":149,"123.6398":150,"124.5389":151,"125.443":152,"126.3398":153},"awaitingAnalysis":false,"speed":1}}],"clipCreationIntents":[],"height":160,"solo":false,"mute":false,"arm":false,"amplitude":1,"balance":0,"instrument":{"type":"song"},"soloTakeLaneId":null,"takeLanesExpanded":false,"takeLanes":[]}],"selection":{"anchorBeats":0,"focusBeats":0,"trackIds":[],"focusedTrackId":null,"focusedArea":null},"loop":{"enabled":false,"startBeats":0,"endBeats":0},"songFadeInBeats":0,"songFadeOutBeats":0},"project_id":"default","from_studio_project_id":"b7d43125-314b-4eb9-97d7-99f4113f7cb0","start_beats":32,"end_beats":128,"downbeats":[[0,1],[0.815100000000001,2],[1.631499999999999,3],[2.4484999999999992,4],[3.2653,1],[4.078900000000001,2],[4.8979,3],[5.7136,4],[6.529400000000006,1],[7.345600000000001,2],[8.163100000000004,3],[8.9783,4],[9.795600000000004,1],[10.6125,2],[11.427200000000003,3],[12.2452,4],[13.061100000000007,1],[13.877400000000005,2],[14.693900000000003,3],[15.510200000000001,4],[16.327700000000004,1],[17.1427,2],[17.959300000000002,3],[18.775300000000005,4],[19.592000000000002,1],[20.4083,2],[21.225000000000005,3],[22.041100000000004,4],[22.857300000000006,1],[23.674300000000006,2],[24.489900000000002,3],[25.307000000000006,4],[26.121800000000004,1],[26.9385,2],[27.7555,3],[28.5714,4],[29.388300000000005,1],[30.204700000000006,2],[31.021200000000004,3],[31.837800000000005,4],[32.65390000000001,1],[33.4691,2],[34.286100000000005,3],[35.1027,4],[35.92060000000001,1],[36.7345,2],[37.55210000000001,3],[38.36760000000001,4],[39.1845,1],[40.0009,2],[40.81630000000001,3],[41.63510000000001,4],[42.45030000000001,1],[43.26700000000001,2],[44.08260000000001,3],[44.89880000000001,4],[45.715500000000006,1],[46.53120000000001,2],[47.34870000000001,3],[48.16430000000001,4],[48.9812,1],[49.797200000000004,2],[50.61340000000001,3],[51.4299,4],[52.246300000000005,1],[53.0621,2],[53.87870000000001,3],[54.69560000000001,4],[55.51190000000001,1],[56.32830000000001,2],[57.1447,3],[57.96050000000001,4],[58.7775,1],[59.5938,2],[60.4084,3],[61.22590000000001,4],[62.04260000000001,1],[62.859300000000005,2],[63.6756,3],[64.4911,4],[65.3087,1],[66.125,2],[66.94080000000001,3],[67.75710000000001,4],[68.57400000000001,1],[69.39080000000001,2],[70.20670000000001,3],[71.0233,4],[71.8391,1],[72.65570000000001,2],[73.4722,3],[74.2883,4],[75.10440000000001,1],[75.9208,2],[76.7377,3],[77.55420000000001,4]],"web_client_pathname":"/studio"}'

Cross-account access supported
Billing: 100 credits/request
I've documented everything I could understand in the Data Notes section; there are still many data fields with unknown origins that need to be resolved independently
Data notes:
- start_beats: Start beat
- end_beats: End beat
- downbeats array length equals end_beats - start_beats
- from_studio_project_id is the project_id from Step 1
- state.timing.bps is the beat-per-second timing: 72.79/60=1.2130977508411211 where 72.79 is the BPM
- start_seconds = start_beats/bps — 26.3795=32/1.2130977508411211
- state.timing.bpsAutomation is estimated to contain approximately 150 entries
- state.tracks is the array of tracks in the UI; state.tracks[0].id is the id_mather since it starts from there
The id in the response is clip_id_render

json

{
  "status": "queued",
  "title": "Untitled Project [00:26 - 01:44]",
  "play_count": 0,
  "upvote_count": 0,
  "allow_comments": true,
  "id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
  "entity_type": "song_schema",
  "video_url": "",
  "audio_url": "",
  "major_model_version": "",
  "model_name": "chirp",
  "metadata": {
    "prompt": "",
    "type": "rendered_context_window",
    "has_vocal": false,
    "can_publish_with_vocal": true,
    "can_remix": false,
    "is_remix": false
  },
  "is_liked": false,
  "user_id": "e284cf51-d120-41f4-97c8-5fabbcf82c3b",
  "display_name": "TranslucentVisuals8289",
  "handle": "translucentvisuals8289",
  "is_handle_updated": true,
  "avatar_image_url": "https://cdn1.suno.ai/sAura7.jpg",
  "is_trashed": false,
  "created_at": "2025-10-21T03:02:02.658Z",
  "is_public": false,
  "flag_count": 0,
  "is_contest_clip": false,
  "has_hook": false
}

{
  "status": "queued",
  "title": "Untitled Project [00:26 - 01:44]",
  "play_count": 0,
  "upvote_count": 0,
  "allow_comments": true,
  "id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
  "entity_type": "song_schema",
  "video_url": "",
  "audio_url": "",
  "major_model_version": "",
  "model_name": "chirp",
  "metadata": {
    "prompt": "",
    "type": "rendered_context_window",
    "has_vocal": false,
    "can_publish_with_vocal": true,
    "can_remix": false,
    "is_remix": false
  },
  "is_liked": false,
  "user_id": "e284cf51-d120-41f4-97c8-5fabbcf82c3b",
  "display_name": "TranslucentVisuals8289",
  "handle": "translucentvisuals8289",
  "is_handle_updated": true,
  "avatar_image_url": "https://cdn1.suno.ai/sAura7.jpg",
  "is_trashed": false,
  "created_at": "2025-10-21T03:02:02.658Z",
  "is_public": false,
  "flag_count": 0,
  "is_contest_clip": false,
  "has_hook": false
}

3. Get Render

get https://api.openai-hk.com/suno/feed/eee21175-258e-47b0-b1a5-12bba477ffd0

Retrieve content via clip_id_render

json

[
  {
    "status": "complete",
    "title": "Untitled Project [00:26 - 01:44]",
    "play_count": 0,
    "upvote_count": 0,
    "allow_comments": true,
    "id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
    "entity_type": "song_schema",
    "video_url": "",
    "audio_url": "https://cdn1.suno.ai/eee21175-258e-47b0-b1a5-12bba477ffd0.mp3",
    "image_url": "https://cdn2.suno.ai/image_eee21175-258e-47b0-b1a5-12bba477ffd0.jpeg",
    "image_large_url": "https://cdn2.suno.ai/image_large_eee21175-258e-47b0-b1a5-12bba477ffd0.jpeg",
    "major_model_version": "",
    "model_name": "chirp-chirp",
    "metadata": {
      "prompt": "[Instrumental]",
      "type": "rendered_context_window",
      "duration": 78.42133333333334,
      "has_vocal": false,
      "can_publish_with_vocal": true,
      "can_remix": false,
      "is_remix": false,
      "has_stem": false,
      "uses_latest_model": false
    },
    "is_liked": false,
    "user_id": "e284cf51-d120-41f4-97c8-5fabbcf82c3b",
    "display_name": "TranslucentVisuals8289",
    "handle": "translucentvisuals8289",
    "is_handle_updated": true,
    "avatar_image_url": "https://cdn1.suno.ai/sAura7.jpg",
    "is_trashed": false,
    "created_at": "2025-10-21T03:02:02.658Z",
    "is_public": false,
    "comment_count": 0,
    "flag_count": 0,
    "is_contest_clip": false,
    "has_hook": false
  }
]

[
  {
    "status": "complete",
    "title": "Untitled Project [00:26 - 01:44]",
    "play_count": 0,
    "upvote_count": 0,
    "allow_comments": true,
    "id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
    "entity_type": "song_schema",
    "video_url": "",
    "audio_url": "https://cdn1.suno.ai/eee21175-258e-47b0-b1a5-12bba477ffd0.mp3",
    "image_url": "https://cdn2.suno.ai/image_eee21175-258e-47b0-b1a5-12bba477ffd0.jpeg",
    "image_large_url": "https://cdn2.suno.ai/image_large_eee21175-258e-47b0-b1a5-12bba477ffd0.jpeg",
    "major_model_version": "",
    "model_name": "chirp-chirp",
    "metadata": {
      "prompt": "[Instrumental]",
      "type": "rendered_context_window",
      "duration": 78.42133333333334,
      "has_vocal": false,
      "can_publish_with_vocal": true,
      "can_remix": false,
      "is_remix": false,
      "has_stem": false,
      "uses_latest_model": false
    },
    "is_liked": false,
    "user_id": "e284cf51-d120-41f4-97c8-5fabbcf82c3b",
    "display_name": "TranslucentVisuals8289",
    "handle": "translucentvisuals8289",
    "is_handle_updated": true,
    "avatar_image_url": "https://cdn1.suno.ai/sAura7.jpg",
    "is_trashed": false,
    "created_at": "2025-10-21T03:02:02.658Z",
    "is_public": false,
    "comment_count": 0,
    "flag_count": 0,
    "is_contest_clip": false,
    "has_hook": false
  }
]

4. Create a New Track

post https://api.openai-hk.com/suno/generate

shell

curl --request POST \
 --url https://api.openai-hk.com/suno/generate \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{
    "task": "stem_condition",
    "generation_type": "TEXT",
    "title": "Strings",
    "tags": "blues",
    "negative_tags": "",
    "mv": "chirp-crow",
    "prompt": "",
    "make_instrumental": true,
    "metadata": {
        "web_client_pathname": "/studio",
        "is_mumble": false,
        "create_mode": "custom",
        "from_studio_project_id": "b7d43125-314b-4eb9-97d7-99f4113f7cb0",
        "disable_volume_normalization": true,
        "vocal_gender": "unspecified",
        "can_control_sliders": [
            "weirdness_constraint",
            "style_weight",
            "audio_weight"
        ],
        "is_remix": true,
        "override_history_clip_id": "bb91d24d-27b5-4dd0-9ace-4861184daaee",
        "override_history_end_seconds": 26.3795,
        "override_future_clip_id": "bb91d24d-27b5-4dd0-9ace-4861184daaee",
        "override_future_start_seconds": 104.7498
    },
    "stem_condition_clip_id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
    "stem_control_tags": "add Strings",
    "batch_size": 2
}'

curl --request POST \
 --url https://api.openai-hk.com/suno/generate \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{
    "task": "stem_condition",
    "generation_type": "TEXT",
    "title": "Strings",
    "tags": "blues",
    "negative_tags": "",
    "mv": "chirp-crow",
    "prompt": "",
    "make_instrumental": true,
    "metadata": {
        "web_client_pathname": "/studio",
        "is_mumble": false,
        "create_mode": "custom",
        "from_studio_project_id": "b7d43125-314b-4eb9-97d7-99f4113f7cb0",
        "disable_volume_normalization": true,
        "vocal_gender": "unspecified",
        "can_control_sliders": [
            "weirdness_constraint",
            "style_weight",
            "audio_weight"
        ],
        "is_remix": true,
        "override_history_clip_id": "bb91d24d-27b5-4dd0-9ace-4861184daaee",
        "override_history_end_seconds": 26.3795,
        "override_future_clip_id": "bb91d24d-27b5-4dd0-9ace-4861184daaee",
        "override_future_start_seconds": 104.7498
    },
    "stem_condition_clip_id": "eee21175-258e-47b0-b1a5-12bba477ffd0",
    "stem_control_tags": "add Strings",
    "batch_size": 2
}'

Cross-account access supported
Parameter notes:
- make_instrumental must be true for instrumental tracks
- task must be stem_condition
- stem_condition_clip_id is the clip_id_render: eee21175-258e-47b0-b1a5-12bba477ffd0
- stem_control_tags can be add Strings, add Drums, add Bass, etc. — refer to suno-studio
- metadata.from_studio_project_id is the project_id: b7d43125-314b-4eb9-97d7-99f4113f7cb0
- metadata.override_history_clip_id is the clip_id_mather: bb91d24d-27b5-4dd0-9ace-4861184daaee
- metadata.override_future_start_seconds is the time corresponding to the start beat: start_beats/bps 26.3795=32/1.2130977508411211
- metadata.override_history_end_seconds is the time corresponding to the end beat: end_beats/bps
- batch_size is likely a variable that may need adjustment
The response data follows the standard create API format

json

{
  "id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
  "clips": [
    {
      "id": "clipsId1",
      ....
    },
     {
      "id": "clipsId2",
      ....
    },
}

{
  "id": "8fb0a232-aef3-4f8a-82ad-72a3fde0bcc6",
  "clips": [
    {
      "id": "clipsId1",
      ....
    },
     {
      "id": "clipsId2",
      ....
    },
}

5. Get Track

get https://api.openai-hk.com/suno/feed/clipsId1,clipsId2

6. Get Beats

get https://api.openai-hk.com/suno/act/beats/{clip_id}

Billing: 100 credits/request
Returns JSON:

json

{
	"state": "complete",
	"downbeats": [
		[
			0.00006,
			2
		],
		[
			0.36004,
			3
		],
    .....
  ]
}

{
	"state": "complete",
	"downbeats": [
		[
			0.00006,
			2
		],
		[
			0.36004,
			3
		],
    .....
  ]
}

Scene 1: Edit a Song Using the Edit Interface

Most features here come from the interface at https://suno.com/edit/{clip_id}, e.g. https://suno.com/edit/636d7348-654c-4b5f-af1f-56b3e8ecade6
Supports replace, create section, copy, split, extend, and swap operations
Refer to Suno's edit interface for specific features
Core principle:
- A: Edit state.tracks[0].clips in the project — this is an array that supports copy, add, delete, split, and reordering. The clips must satisfy: state.tracks[0].clips[0].endBeats = state.tracks[0].clips[1].startBeats
- B: Save the edited project, then pass the state content to the Create Render API to get the new song
- C: The downbeats in the render API must be assembled by sorting state.tracks[0].clips to determine which beats to use
The following uses replace as an example

A. Get project_id from clip_id

get https://api.openai-hk.com/suno/act/c2p/{clip_id}

get https://api.openai-hk.com/suno/act/c2p/ca6d28e3-7922-452d-844b-51a288f700a3

Billing: 100 credits/request
Returns JSON:

json

{
  "id": "fcf343fb-6866-478b-a054-0c780e369345",
  "title": "Does it hurt",
  "created_at": "2026-03-03T02:23:28.960Z",
  "updated_at": "2026-03-03T02:23:28.960Z",
  "archived": false
}

{
  "id": "fcf343fb-6866-478b-a054-0c780e369345",
  "title": "Does it hurt",
  "created_at": "2026-03-03T02:23:28.960Z",
  "updated_at": "2026-03-03T02:23:28.960Z",
  "archived": false
}

The returned id is the project_id

B. Get Project via project_id

get https://api.openai-hk.com/suno/act/project/{project_id}

Initially empty
Later enriched via the save project API to populate state.tracks[0] and state.markersRegistry
Mainly populates the state.tracks[0].clips array segments
Returns JSON:

json

{
  "state": {
    "title": "Does it hurt",
    "selection": {
      "endBeats": 0,
      "focusedArea": "timeline",
      "trackIds": [],
      "startBeats": 0
    },
    "editClipId": "ca6d28e3-7922-452d-844b-51a288f700a3",
    "timing": {
      "type": "manual",
      "bps": 60,
      "bpsAutomation": []
    },
    "tracks": []
  },
  "latest_version_id": "4fa3e3e7-c2f8-4002-9d16-527b734f7aeb",
  "id": "fcf343fb-6866-478b-a054-0c780e369345",
  "title": "Does it hurt",
  "created_at": "2026-03-03T02:23:28.960Z",
  "updated_at": "2026-03-03T02:23:28.960Z",
  "archived": false
}

{
  "state": {
    "title": "Does it hurt",
    "selection": {
      "endBeats": 0,
      "focusedArea": "timeline",
      "trackIds": [],
      "startBeats": 0
    },
    "editClipId": "ca6d28e3-7922-452d-844b-51a288f700a3",
    "timing": {
      "type": "manual",
      "bps": 60,
      "bpsAutomation": []
    },
    "tracks": []
  },
  "latest_version_id": "4fa3e3e7-c2f8-4002-9d16-527b734f7aeb",
  "id": "fcf343fb-6866-478b-a054-0c780e369345",
  "title": "Does it hurt",
  "created_at": "2026-03-03T02:23:28.960Z",
  "updated_at": "2026-03-03T02:23:28.960Z",
  "archived": false
}

You need to assemble the data into the following format and save it via the save project API:

shell

curl --request POST \
 --url https://api.openai-hk.com/suno/act/project/fcf343fb-6866-478b-a054-0c780e369345 \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{"project_id":"fcf343fb-6866-478b-a054-0c780e369345","state":{"amplitude":1,"sections":{},"lyricsCorrectionsByClipId":{},"metronome":{"enabled":false,"amplitude":1},"timing":{"type":"manual","bps":2,"bpsAutomation":[],"lockBPS":true},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"tracks":[{"type":"audio","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","input":null,"color":"#DE1677","name":"Does it hurt","clips":[{"type":"audio","streaming":false,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","uploadId":null,"mute":false,"name":"Song","color":"#028338","startBeats":-1.4404299867225,"endBeats":187.99979999375867,"readStartBeats":-1.4404299867225,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-1.4404299867225,"endBeats":187.99979999375867},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_86a251228890498c64284a7582dc84f0"}}],"clipCreationIntents":[],"height":160,"solo":false,"mute":false,"arm":false,"amplitude":1,"balance":0,"instrument":{"type":"song"},"soloTakeLaneId":null,"takeLanesExpanded":false,"takeLanes":[],"eq":{"enabled":true,"band1":{"type":"highpass","enabled":false,"frequency":60,"gain":0,"q":0.707},"band2":{"type":"lowshelf","enabled":true,"frequency":160,"gain":0,"q":0.707},"band3":{"type":"peaking","enabled":true,"frequency":450,"gain":0,"q":0.707},"band4":{"type":"peaking","enabled":true,"frequency":1200,"gain":0,"q":0.707},"band5":{"type":"highshelf","enabled":true,"frequency":3200,"gain":0,"q":0.707},"band6":{"type":"lowpass","enabled":false,"frequency":8800,"gain":0,"q":0.707}}}],"selection":{"anchorBeats":0,"focusBeats":0,"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","focusedArea":"timeline","arrangementAnchorBeats":null,"arrangementFocusBeats":null,"noteIds":[],"warpMarkerSeconds":{},"automationPointIndices":[],"contextBeforeBeats":32,"contextAfterBeats":32},"loop":{"startBeats":0,"endBeats":0,"enabled":false},"songFadeInBeats":0,"songFadeOutBeats":0,"layout":{"editorPanelType":null,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"midiAutomationLaneHeight":24,"arrangementEditorHeight":280},"editorPointerModes":{"audio":"select","midi":"select"},"title":"Does it hurt","editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","markersRegistry":{"warp_86a251228890498c64284a7582dc84f0":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}}},"title":"Does it hurt"}'

curl --request POST \
 --url https://api.openai-hk.com/suno/act/project/fcf343fb-6866-478b-a054-0c780e369345 \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{"project_id":"fcf343fb-6866-478b-a054-0c780e369345","state":{"amplitude":1,"sections":{},"lyricsCorrectionsByClipId":{},"metronome":{"enabled":false,"amplitude":1},"timing":{"type":"manual","bps":2,"bpsAutomation":[],"lockBPS":true},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"tracks":[{"type":"audio","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","input":null,"color":"#DE1677","name":"Does it hurt","clips":[{"type":"audio","streaming":false,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","uploadId":null,"mute":false,"name":"Song","color":"#028338","startBeats":-1.4404299867225,"endBeats":187.99979999375867,"readStartBeats":-1.4404299867225,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-1.4404299867225,"endBeats":187.99979999375867},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_86a251228890498c64284a7582dc84f0"}}],"clipCreationIntents":[],"height":160,"solo":false,"mute":false,"arm":false,"amplitude":1,"balance":0,"instrument":{"type":"song"},"soloTakeLaneId":null,"takeLanesExpanded":false,"takeLanes":[],"eq":{"enabled":true,"band1":{"type":"highpass","enabled":false,"frequency":60,"gain":0,"q":0.707},"band2":{"type":"lowshelf","enabled":true,"frequency":160,"gain":0,"q":0.707},"band3":{"type":"peaking","enabled":true,"frequency":450,"gain":0,"q":0.707},"band4":{"type":"peaking","enabled":true,"frequency":1200,"gain":0,"q":0.707},"band5":{"type":"highshelf","enabled":true,"frequency":3200,"gain":0,"q":0.707},"band6":{"type":"lowpass","enabled":false,"frequency":8800,"gain":0,"q":0.707}}}],"selection":{"anchorBeats":0,"focusBeats":0,"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","focusedArea":"timeline","arrangementAnchorBeats":null,"arrangementFocusBeats":null,"noteIds":[],"warpMarkerSeconds":{},"automationPointIndices":[],"contextBeforeBeats":32,"contextAfterBeats":32},"loop":{"startBeats":0,"endBeats":0,"enabled":false},"songFadeInBeats":0,"songFadeOutBeats":0,"layout":{"editorPanelType":null,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"midiAutomationLaneHeight":24,"arrangementEditorHeight":280},"editorPointerModes":{"audio":"select","midi":"select"},"title":"Does it hurt","editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","markersRegistry":{"warp_86a251228890498c64284a7582dc84f0":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}}},"title":"Does it hurt"}'

C. Generate a Replace Clip

post https://api.openai-hk.com/suno/generate

Request body:

json

{
  "task": "infill",
  "generation_type": "TEXT",
  "title": "Replace 00:34-00:48 (06:51 PM Mar 02)",
  "tags": "dreamy jazz",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "...(song lyrics)...",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "...(infill lyrics)...",
    "lyrics_updated": false,
    "is_remix": true
  },

  "continue_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
  "continued_aligned_prompt": "...(aligned lyrics)...",
  "continue_at": null,
  "infill_context_start_s": 19.12,
  "infill_context_end_s": 64.76,
  "infill_start_s": 35.12,
  "infill_end_s": 48.76,
  "infill_dur_s": 13.64,
  "transaction_uuid": "d5fde61c-6583-4af8-9f40-05a7ebb52a51",
  "include_history_s": 16,
  "include_future_s": 16
}

{
  "task": "infill",
  "generation_type": "TEXT",
  "title": "Replace 00:34-00:48 (06:51 PM Mar 02)",
  "tags": "dreamy jazz",
  "negative_tags": "",
  "mv": "chirp-crow",
  "prompt": "...(song lyrics)...",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "...(infill lyrics)...",
    "lyrics_updated": false,
    "is_remix": true
  },

  "continue_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
  "continued_aligned_prompt": "...(aligned lyrics)...",
  "continue_at": null,
  "infill_context_start_s": 19.12,
  "infill_context_end_s": 64.76,
  "infill_start_s": 35.12,
  "infill_end_s": 48.76,
  "infill_dur_s": 13.64,
  "transaction_uuid": "d5fde61c-6583-4af8-9f40-05a7ebb52a51",
  "include_history_s": 16,
  "include_future_s": 16
}

Returns 2 clip IDs: 8ac7d50b-77ed-4e7f-b402-505f896db5e2 and b768e803-a662-4757-9252-351b3d296a86
Wait for both clip IDs to finish generating, then retrieve their beats

D. Execute Commit Action via Save Project

The request body needs to be compared with the initial project from Step B
Key differences:
- 1. state.tracks[0].takeLanes array has one more entry
- 1. state.markersRegistry has 2 additional objects
- 1. Main change: state.tracks[0].clips array has 2 groups — since this is a replace, it splits 1 segment into 3 parts, with the middle segment being the replacement
- 1. state.tracks[0].clips[1] data comes from the newly generated clip ID b768e803-a662-4757-9252-351b3d296a86

shell

curl --request POST \
 --url https://api.openai-hk.com/suno/act/project/fcf343fb-6866-478b-a054-0c780e369345 \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{"project_id":"fcf343fb-6866-478b-a054-0c780e369345","state":{"timing":{"type":"manual","bps":2,"lockBPS":true,"bpsAutomation":[]},"title":"Does it hurt","sections":{},"tracks":[{"color":"#DE1677","takeLanes":[{"type":"audio","id":"ad8787a4-567a-4e4a-8d8e-f1d5a0037230","name":"Version 2","height":32,"clips":[{"type":"audio","streaming":false,"id":"1f2540bd-ea8b-4d70-8a17-38ec74fa5cf9","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.748771378022404,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_e5a5ccb6081455791a7525daa9521c51"}}],"clipCreationIntents":[],"dismissed":false},{"type":"audio","id":"ab43d5f8-b2be-4b7b-ae49-95f5e9fe076b","name":"Version 1","height":32,"clips":[{"type":"audio","streaming":false,"id":"6ac8536b-17f3-4b0c-b1f4-1cb3540f77e6","clipId":"8ac7d50b-77ed-4e7f-b402-505f896db5e2","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.75609718826405,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2057217186835545,"endBeats":88.08040321612864},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_7217ea2d8cfa16e4d6db394b534db799"}}],"clipCreationIntents":[],"dismissed":false}],"clips":[{"color":"#028338","startBeats":-1.4404299867225,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":68.79608016136673,"readStartBeats":-1.4404299867225,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","warp":{"awaitingAnalysis":false,"enabled":true,"markersHash":"warp_86a251228890498c64284a7582dc84f0"},"uploadId":null},{"type":"audio","streaming":false,"id":"a9de9eb3-d2ff-4f3c-9635-dc3a2cdb61db","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.79608016136673,"endBeats":126.07693147871281,"readStartBeats":28.79608016136673,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_e5a5ccb6081455791a7525daa9521c51"}},{"color":"#028338","startBeats":126.07693147871281,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":217.99979999375867,"readStartBeats":96.07693147871281,"id":"a78a3aae-55cc-4e01-a1ea-3d576ed3ad00","warp":{"awaitingAnalysis":false,"enabled":true,"markersHash":"warp_86a251228890498c64284a7582dc84f0"},"uploadId":null}],"solo":false,"mute":false,"instrument":{"type":"song"},"type":"audio","eq":{"band5":{"q":0.707,"type":"highshelf","enabled":true,"frequency":3200,"gain":0},"band6":{"q":0.707,"type":"lowpass","enabled":false,"frequency":8800,"gain":0},"band3":{"q":0.707,"type":"peaking","enabled":true,"frequency":450,"gain":0},"band4":{"q":0.707,"type":"peaking","enabled":true,"frequency":1200,"gain":0},"enabled":true,"band1":{"q":0.707,"type":"highpass","enabled":false,"frequency":60,"gain":0},"band2":{"q":0.707,"type":"lowshelf","enabled":true,"frequency":160,"gain":0}},"clipCreationIntents":[],"amplitude":1,"takeLanesExpanded":false,"balance":0,"name":"Does it hurt","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","arm":false,"height":160,"input":null,"soloTakeLaneId":null}],"editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","layout":{"midiAutomationLaneHeight":24,"arrangementEditorHeight":280,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"editorPanelType":null},"amplitude":1,"songFadeOutBeats":0,"selection":{"contextAfterBeats":32,"contextBeforeBeats":32,"automationPointIndices":[],"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedArea":"timeline","warpMarkerSeconds":{},"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","anchorBeats":126.07693147871281,"focusBeats":68.79608016136673,"noteIds":[],"arrangementAnchorBeats":null,"arrangementFocusBeats":null},"loop":{"endBeats":32,"enabled":false,"startBeats":0},"metronome":{"enabled":false,"amplitude":1},"editorPointerModes":{"midi":"select","audio":"select"},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"songFadeInBeats":0,"lyricsCorrectionsByClipId":{},"metadata":{"usedReplaceSection":true},"markersRegistry":{"warp_86a251228890498c64284a7582dc84f0":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188},"warp_e5a5ccb6081455791a7525daa9521c51":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"warp_7217ea2d8cfa16e4d6db394b534db799":{"0.1028":-3,"12.0957":21,"18.638589999999997":33.99779492665036,"28.14352":52.99364468286525,"33.63669":63.99477296726505,"36.60036":69.99263331871691,"41.60035":79.99629866752029,"43.0999":83,"45.59752":87.99543981759271}}},"title":"Does it hurt"}'

curl --request POST \
 --url https://api.openai-hk.com/suno/act/project/fcf343fb-6866-478b-a054-0c780e369345 \
 --header 'Authorization: Bearer sk-your-key' \
 --header 'Content-Type: application/json' \
 --data '{"project_id":"fcf343fb-6866-478b-a054-0c780e369345","state":{"timing":{"type":"manual","bps":2,"lockBPS":true,"bpsAutomation":[]},"title":"Does it hurt","sections":{},"tracks":[{"color":"#DE1677","takeLanes":[{"type":"audio","id":"ad8787a4-567a-4e4a-8d8e-f1d5a0037230","name":"Version 2","height":32,"clips":[{"type":"audio","streaming":false,"id":"1f2540bd-ea8b-4d70-8a17-38ec74fa5cf9","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.748771378022404,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_e5a5ccb6081455791a7525daa9521c51"}}],"clipCreationIntents":[],"dismissed":false},{"type":"audio","id":"ab43d5f8-b2be-4b7b-ae49-95f5e9fe076b","name":"Version 1","height":32,"clips":[{"type":"audio","streaming":false,"id":"6ac8536b-17f3-4b0c-b1f4-1cb3540f77e6","clipId":"8ac7d50b-77ed-4e7f-b402-505f896db5e2","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.75609718826405,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2057217186835545,"endBeats":88.08040321612864},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_7217ea2d8cfa16e4d6db394b534db799"}}],"clipCreationIntents":[],"dismissed":false}],"clips":[{"color":"#028338","startBeats":-1.4404299867225,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":68.79608016136673,"readStartBeats":-1.4404299867225,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","warp":{"awaitingAnalysis":false,"enabled":true,"markersHash":"warp_86a251228890498c64284a7582dc84f0"},"uploadId":null},{"type":"audio","streaming":false,"id":"a9de9eb3-d2ff-4f3c-9635-dc3a2cdb61db","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.79608016136673,"endBeats":126.07693147871281,"readStartBeats":28.79608016136673,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"awaitingAnalysis":false,"markersHash":"warp_e5a5ccb6081455791a7525daa9521c51"}},{"color":"#028338","startBeats":126.07693147871281,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":217.99979999375867,"readStartBeats":96.07693147871281,"id":"a78a3aae-55cc-4e01-a1ea-3d576ed3ad00","warp":{"awaitingAnalysis":false,"enabled":true,"markersHash":"warp_86a251228890498c64284a7582dc84f0"},"uploadId":null}],"solo":false,"mute":false,"instrument":{"type":"song"},"type":"audio","eq":{"band5":{"q":0.707,"type":"highshelf","enabled":true,"frequency":3200,"gain":0},"band6":{"q":0.707,"type":"lowpass","enabled":false,"frequency":8800,"gain":0},"band3":{"q":0.707,"type":"peaking","enabled":true,"frequency":450,"gain":0},"band4":{"q":0.707,"type":"peaking","enabled":true,"frequency":1200,"gain":0},"enabled":true,"band1":{"q":0.707,"type":"highpass","enabled":false,"frequency":60,"gain":0},"band2":{"q":0.707,"type":"lowshelf","enabled":true,"frequency":160,"gain":0}},"clipCreationIntents":[],"amplitude":1,"takeLanesExpanded":false,"balance":0,"name":"Does it hurt","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","arm":false,"height":160,"input":null,"soloTakeLaneId":null}],"editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","layout":{"midiAutomationLaneHeight":24,"arrangementEditorHeight":280,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"editorPanelType":null},"amplitude":1,"songFadeOutBeats":0,"selection":{"contextAfterBeats":32,"contextBeforeBeats":32,"automationPointIndices":[],"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedArea":"timeline","warpMarkerSeconds":{},"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","anchorBeats":126.07693147871281,"focusBeats":68.79608016136673,"noteIds":[],"arrangementAnchorBeats":null,"arrangementFocusBeats":null},"loop":{"endBeats":32,"enabled":false,"startBeats":0},"metronome":{"enabled":false,"amplitude":1},"editorPointerModes":{"midi":"select","audio":"select"},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"songFadeInBeats":0,"lyricsCorrectionsByClipId":{},"metadata":{"usedReplaceSection":true},"markersRegistry":{"warp_86a251228890498c64284a7582dc84f0":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188},"warp_e5a5ccb6081455791a7525daa9521c51":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"warp_7217ea2d8cfa16e4d6db394b534db799":{"0.1028":-3,"12.0957":21,"18.638589999999997":33.99779492665036,"28.14352":52.99364468286525,"33.63669":63.99477296726505,"36.60036":69.99263331871691,"41.60035":79.99629866752029,"43.0999":83,"45.59752":87.99543981759271}}},"title":"Does it hurt"}'

E. Get Beats and Assemble downbeats

get https://api.openai-hk.com/suno/act/beats/{clip_id}

Need to retrieve the main beats and the beats of the newly generated replacement clip_id
Use state.tracks[0].clips[].startBeats and state.tracks[0].clips[].endBeats to sort and determine where the downbeats values should come from
Once downbeats is assembled, use the Create Render API to get the new song

F. Get New Song via the New Render

downbeats comes from Step E (assembly)
state comes from the get project API

POST https://api.openai-hk.com/suno/render

shell

curl --request POST \
  --url https://api.openai-hk.com/suno/render \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{"title":"Does it hurt (Edit)","lyrics":"...","tags":"dreamy jazz","state":{"timing":{"type":"manual","bps":2,"lockBPS":true,"bpsAutomation":[]},"title":"Does it hurt","sections":{},"tracks":[{"color":"#DE1677","takeLanes":[{"type":"audio","id":"ad8787a4-567a-4e4a-8d8e-f1d5a0037230","name":"Version 2","height":32,"clips":[{"type":"audio","streaming":false,"id":"1f2540bd-ea8b-4d70-8a17-38ec74fa5cf9","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.748771378022404,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"markers":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"awaitingAnalysis":false}}],"clipCreationIntents":[],"dismissed":false},{"type":"audio","id":"ab43d5f8-b2be-4b7b-ae49-95f5e9fe076b","name":"Version 1","height":32,"clips":[{"type":"audio","streaming":false,"id":"6ac8536b-17f3-4b0c-b1f4-1cb3540f77e6","clipId":"8ac7d50b-77ed-4e7f-b402-505f896db5e2","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.75609718826405,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2057217186835545,"endBeats":88.08040321612864},"warp":{"enabled":true,"markers":{"0.1028":-3,"12.0957":21,"18.638589999999997":33.99779492665036,"28.14352":52.99364468286525,"33.63669":63.99477296726505,"36.60036":69.99263331871691,"41.60035":79.99629866752029,"43.0999":83,"45.59752":87.99543981759271},"awaitingAnalysis":false}}],"clipCreationIntents":[],"dismissed":false}],"clips":[{"color":"#028338","startBeats":-1.4404299867225,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":68.79608016136673,"readStartBeats":-1.4404299867225,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","warp":{"awaitingAnalysis":false,"enabled":true,"markers":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}},"uploadId":null},{"type":"audio","streaming":false,"id":"a9de9eb3-d2ff-4f3c-9635-dc3a2cdb61db","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.79608016136673,"endBeats":126.07693147871281,"readStartBeats":28.79608016136673,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"markers":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"awaitingAnalysis":false}},{"color":"#028338","startBeats":126.07693147871281,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":217.99979999375867,"readStartBeats":96.07693147871281,"id":"a78a3aae-55cc-4e01-a1ea-3d576ed3ad00","warp":{"awaitingAnalysis":false,"enabled":true,"markers":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}},"uploadId":null}],"solo":false,"mute":false,"instrument":{"type":"song"},"type":"audio","eq":{"band5":{"q":0.707,"type":"highshelf","enabled":true,"frequency":3200,"gain":0},"band6":{"q":0.707,"type":"lowpass","enabled":false,"frequency":8800,"gain":0},"band3":{"q":0.707,"type":"peaking","enabled":true,"frequency":450,"gain":0},"band4":{"q":0.707,"type":"peaking","enabled":true,"frequency":1200,"gain":0},"enabled":true,"band1":{"q":0.707,"type":"highpass","enabled":false,"frequency":60,"gain":0},"band2":{"q":0.707,"type":"lowshelf","enabled":true,"frequency":160,"gain":0}},"clipCreationIntents":[],"amplitude":1,"takeLanesExpanded":false,"balance":0,"name":"Does it hurt","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","arm":false,"height":160,"input":null,"soloTakeLaneId":null}],"editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","layout":{"midiAutomationLaneHeight":24,"arrangementEditorHeight":280,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"editorPanelType":null},"amplitude":1,"songFadeOutBeats":0,"selection":{"contextAfterBeats":32,"contextBeforeBeats":32,"automationPointIndices":[],"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedArea":"timeline","warpMarkerSeconds":{},"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","anchorBeats":126.07693147871281,"focusBeats":68.79608016136673,"noteIds":[],"arrangementAnchorBeats":null,"arrangementFocusBeats":null},"loop":{"endBeats":32,"enabled":false,"startBeats":0},"metronome":{"enabled":false,"amplitude":1},"editorPointerModes":{"midi":"select","audio":"select"},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"songFadeInBeats":0,"lyricsCorrectionsByClipId":{},"metadata":{"usedReplaceSection":true}},"start_beats":-1.4404299867225,"end_beats":217.99979999375867,"project_id":"default","studio_project_id":"fcf343fb-6866-478b-a054-0c780e369345","studio_project_version_id":"adb6f40b-92e5-4da9-b509-06b924133ef3","downbeats":[[0.22021499336125006,4],[0.72021499336125,1],[1.22021499336125,2],...[108.72021499336125,1]],"web_client_pathname":"/edit/ca6d28e3-7922-452d-844b-51a288f700a3"}'

curl --request POST \
  --url https://api.openai-hk.com/suno/render \
  --header 'Authorization: Bearer sk-your-key' \
  --header 'Content-Type: application/json' \
  --data '{"title":"Does it hurt (Edit)","lyrics":"...","tags":"dreamy jazz","state":{"timing":{"type":"manual","bps":2,"lockBPS":true,"bpsAutomation":[]},"title":"Does it hurt","sections":{},"tracks":[{"color":"#DE1677","takeLanes":[{"type":"audio","id":"ad8787a4-567a-4e4a-8d8e-f1d5a0037230","name":"Version 2","height":32,"clips":[{"type":"audio","streaming":false,"id":"1f2540bd-ea8b-4d70-8a17-38ec74fa5cf9","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.748771378022404,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"markers":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"awaitingAnalysis":false}}],"clipCreationIntents":[],"dismissed":false},{"type":"audio","id":"ab43d5f8-b2be-4b7b-ae49-95f5e9fe076b","name":"Version 1","height":32,"clips":[{"type":"audio","streaming":false,"id":"6ac8536b-17f3-4b0c-b1f4-1cb3540f77e6","clipId":"8ac7d50b-77ed-4e7f-b402-505f896db5e2","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.82748140549403,"endBeats":96,"readStartBeats":28.75609718826405,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2057217186835545,"endBeats":88.08040321612864},"warp":{"enabled":true,"markers":{"0.1028":-3,"12.0957":21,"18.638589999999997":33.99779492665036,"28.14352":52.99364468286525,"33.63669":63.99477296726505,"36.60036":69.99263331871691,"41.60035":79.99629866752029,"43.0999":83,"45.59752":87.99543981759271},"awaitingAnalysis":false}}],"clipCreationIntents":[],"dismissed":false}],"clips":[{"color":"#028338","startBeats":-1.4404299867225,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":68.79608016136673,"readStartBeats":-1.4404299867225,"id":"fb2ef748-bea1-416f-b8f4-e75caca80c63","warp":{"awaitingAnalysis":false,"enabled":true,"markers":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}},"uploadId":null},{"type":"audio","streaming":false,"id":"a9de9eb3-d2ff-4f3c-9635-dc3a2cdb61db","clipId":"b768e803-a662-4757-9252-351b3d296a86","uploadId":null,"mute":false,"name":"Replace 00:34-00:48 (06:51 PM Mar 02)","color":"#DE1677","startBeats":68.79608016136673,"endBeats":126.07693147871281,"readStartBeats":28.79608016136673,"fadeInBeats":0,"fadeOutBeats":0,"transposition":0,"amplitude":1,"loop":{"enabled":false,"startBeats":-3.2084075525472033,"endBeats":117.80629698534436},"warp":{"enabled":true,"markers":{"0.104":-3,"4.5952":6,"5.098":7,"6.0927":9,"14.13992":25.092235109101633,"17.143469999999997":30.996599174366025,"45.64262":88.00823629366785,"47.63957":92.00033606800434,"48.63817":93.97443906296334,"49.7003":96,"60.2355":117},"awaitingAnalysis":false}},{"color":"#028338","startBeats":126.07693147871281,"mute":false,"type":"audio","fadeInBeats":0,"transposition":0,"streaming":false,"fadeOutBeats":0,"amplitude":1,"loop":{"endBeats":187.99979999375867,"enabled":false,"startBeats":-1.4404299867225},"clipId":"ca6d28e3-7922-452d-844b-51a288f700a3","name":"Song","endBeats":217.99979999375867,"readStartBeats":96.07693147871281,"id":"a78a3aae-55cc-4e01-a1ea-3d576ed3ad00","warp":{"awaitingAnalysis":false,"enabled":true,"markers":{"0.2202":-1,"23.7186":46,"24.2223":47,"94.7201":188}},"uploadId":null}],"solo":false,"mute":false,"instrument":{"type":"song"},"type":"audio","eq":{"band5":{"q":0.707,"type":"highshelf","enabled":true,"frequency":3200,"gain":0},"band6":{"q":0.707,"type":"lowpass","enabled":false,"frequency":8800,"gain":0},"band3":{"q":0.707,"type":"peaking","enabled":true,"frequency":450,"gain":0},"band4":{"q":0.707,"type":"peaking","enabled":true,"frequency":1200,"gain":0},"enabled":true,"band1":{"q":0.707,"type":"highpass","enabled":false,"frequency":60,"gain":0},"band2":{"q":0.707,"type":"lowshelf","enabled":true,"frequency":160,"gain":0}},"clipCreationIntents":[],"amplitude":1,"takeLanesExpanded":false,"balance":0,"name":"Does it hurt","id":"02db5fba-8f60-45b8-94f4-ff2381af7268","arm":false,"height":160,"input":null,"soloTakeLaneId":null}],"editClipId":"ca6d28e3-7922-452d-844b-51a288f700a3","layout":{"midiAutomationLaneHeight":24,"arrangementEditorHeight":280,"midiAutomationLaneId":{"category":"noteProperty","property":"velocity"},"editorPanelType":null},"amplitude":1,"songFadeOutBeats":0,"selection":{"contextAfterBeats":32,"contextBeforeBeats":32,"automationPointIndices":[],"trackIds":["02db5fba-8f60-45b8-94f4-ff2381af7268"],"focusedArea":"timeline","warpMarkerSeconds":{},"focusedTrackId":"02db5fba-8f60-45b8-94f4-ff2381af7268","anchorBeats":126.07693147871281,"focusBeats":68.79608016136673,"noteIds":[],"arrangementAnchorBeats":null,"arrangementFocusBeats":null},"loop":{"endBeats":32,"enabled":false,"startBeats":0},"metronome":{"enabled":false,"amplitude":1},"editorPointerModes":{"midi":"select","audio":"select"},"timeSignatureChanges":[{"startBeats":0,"subdivisionsPerBar":4,"beatsPerSubdivision":1}],"songFadeInBeats":0,"lyricsCorrectionsByClipId":{},"metadata":{"usedReplaceSection":true}},"start_beats":-1.4404299867225,"end_beats":217.99979999375867,"project_id":"default","studio_project_id":"fcf343fb-6866-478b-a054-0c780e369345","studio_project_version_id":"adb6f40b-92e5-4da9-b509-06b924133ef3","downbeats":[[0.22021499336125006,4],[0.72021499336125,1],[1.22021499336125,2],...[108.72021499336125,1]],"web_client_pathname":"/edit/ca6d28e3-7922-452d-844b-51a288f700a3"}'

Response:

json

{
  "status": "queued",
  "title": "Does it hurt (Edit)",
  "play_count": 0,
  "upvote_count": 0,
  "allow_comments": true,
  "id": "15c48197-92ef-409c-bc38-e49bc4931c5c",
  "entity_type": "song_schema",
  "video_url": "",
  "audio_url": "",
  "major_model_version": "",
  "model_name": "chirp",
  "metadata": {
    "tags": "dreamy jazz",
    "prompt": "",
    "edited_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
    "type": "edit_v3_export",
    "has_vocal": false,
    "can_publish_with_vocal": true,
    "can_remix": true,
    "is_remix": false,
    "studio_project_id": "fcf343fb-6866-478b-a054-0c780e369345",
    "studio_project_version_id": "adb6f40b-92e5-4da9-b509-06b924133ef3",
    "studio_project_start_beats": -1.4404299867225,
    "studio_project_end_beats": 217.99979999375867
  },
  "is_liked": false,
  "user_id": "9b945765-d322-4b41-98b9-ff3ea80c8232",
  "display_name": "OptimisticPianist6223",
  "handle": "optimisticpianist6223",
  "is_handle_updated": false,
  "avatar_image_url": "https://cdn1.suno.ai/sAura10.jpg",
  "is_trashed": false,
  "is_hidden": false,
  "created_at": "2026-03-03T03:23:55.762Z",
  "is_public": false,
  "flag_count": 0,
  "is_contest_clip": false,
  "has_hook": false,
  "batch_index": 0
}

{
  "status": "queued",
  "title": "Does it hurt (Edit)",
  "play_count": 0,
  "upvote_count": 0,
  "allow_comments": true,
  "id": "15c48197-92ef-409c-bc38-e49bc4931c5c",
  "entity_type": "song_schema",
  "video_url": "",
  "audio_url": "",
  "major_model_version": "",
  "model_name": "chirp",
  "metadata": {
    "tags": "dreamy jazz",
    "prompt": "",
    "edited_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
    "type": "edit_v3_export",
    "has_vocal": false,
    "can_publish_with_vocal": true,
    "can_remix": true,
    "is_remix": false,
    "studio_project_id": "fcf343fb-6866-478b-a054-0c780e369345",
    "studio_project_version_id": "adb6f40b-92e5-4da9-b509-06b924133ef3",
    "studio_project_start_beats": -1.4404299867225,
    "studio_project_end_beats": 217.99979999375867
  },
  "is_liked": false,
  "user_id": "9b945765-d322-4b41-98b9-ff3ea80c8232",
  "display_name": "OptimisticPianist6223",
  "handle": "optimisticpianist6223",
  "is_handle_updated": false,
  "avatar_image_url": "https://cdn1.suno.ai/sAura10.jpg",
  "is_trashed": false,
  "is_hidden": false,
  "created_at": "2026-03-03T03:23:55.762Z",
  "is_public": false,
  "flag_count": 0,
  "is_contest_clip": false,
  "has_hook": false,
  "batch_index": 0
}

The id 15c48197-92ef-409c-bc38-e49bc4931c5c is the new clip_id
Retrieve the result via: get https://api.openai-hk.com/suno/feed/15c48197-92ef-409c-bc38-e49bc4931c5c

Suno Studio Experimental Workflow ​

0. Create a New Project ​

A. Create ​

B. Get ​

C. Update ​

1. Create a New Song ​

2. Create a Render ​

3. Get Render ​

4. Create a New Track ​

5. Get Track ​

6. Get Beats ​

Scene 1: Edit a Song Using the Edit Interface ​

A. Get project_id from clip_id ​

B. Get Project via project_id ​

C. Generate a Replace Clip ​

D. Execute Commit Action via Save Project ​

E. Get Beats and Assemble downbeats ​

F. Get New Song via the New Render ​

Suno Studio Experimental Workflow

0. Create a New Project

A. Create

B. Get

C. Update

1. Create a New Song

2. Create a Render

3. Get Render

4. Create a New Track

5. Get Track

6. Get Beats

Scene 1: Edit a Song Using the Edit Interface

A. Get project_id from clip_id

B. Get Project via project_id

C. Generate a Replace Clip

D. Execute Commit Action via Save Project

E. Get Beats and Assemble downbeats

F. Get New Song via the New Render