Skip to content

Suno Studio 実験的ワークフロー

  • これは現在実験バージョンであり、多くの未説明のデータフィールドがあります
  • Suno公式サイトのSuno Studioを使用して自分でテストし、データソースを一緒に探索できます
  • 主な課題はステップ2:入力パラメータのソースです

0. 新しいプロジェクトを作成

A. 作成

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"}'
  • 課金:100クレジット/リクエスト
  • レスポンスボディのidproject_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. 取得

  • クロスアカウントアクセスはサポートされていません
  • リアルタイムで取得され、キャッシュはありません(コンテンツが編集可能なため)
  • 課金:100クレジット/リクエスト

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

  • レスポンス:

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": {}
  }
}

C. 更新

  • クロスアカウントアクセスはサポートされていません

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

  • リクエストボディ:

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,
        // ここでは省略
        "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,
        // ここでは省略
        "55.615": 74
      }
    }
  }
}
  • レスポンス:
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. 新しい曲を作成

  • 作成APIを通じて、新しい曲のidid_matherとして取得します。その中のclip_id値の1つがclip_id_matherです
  • 例:project_id = b7d43125-314b-4eb9-97d7-99f4113f7cb0
  • 例:clip_id_mather = bb91d24d-27b5-4dd0-9ace-4861184daaee

2. レンダーを作成

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"}'
  • クロスアカウントアクセスはサポートされています

  • 課金:100クレジット/リクエスト

  • データ注記セクションで理解できる内容はすべて文書化しましたが、まだ多くの起源不明のデータフィールドがあり、個別に解決する必要があります

  • データ注記:

    • start_beats:開始ビート
    • end_beats:終了ビート
    • downbeats配列の長さはend_beats - start_beatsと等しい
    • from_studio_project_idはステップ1のproject_idです
    • state.timing.bpsはビート/秒のタイミングです:72.79/60=1.2130977508411211(72.79はBPM)
    • start_seconds = start_beats/bps26.3795=32/1.2130977508411211
    • state.timing.bpsAutomationには約150個のエントリが含まれると推定されます
    • state.tracksはUIのトラック配列です。state.tracks[0].idid_matherです(そこから始まるため)
  • レスポンスのidclip_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 https://api.openai-hk.com/suno/feed/eee21175-258e-47b0-b1a5-12bba477ffd0

  • 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. 新しいトラックを作成

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
}'
  • クロスアカウントアクセスはサポートされています

  • パラメータ注記:

    • make_instrumentalはインストゥルメンタルトラックの場合はtrueでなければなりません
    • taskstem_conditionでなければなりません
    • stem_condition_clip_idclip_id_renderです:eee21175-258e-47b0-b1a5-12bba477ffd0
    • stem_control_tagsadd Stringsadd Drumsadd Bassなどにできます — suno-studioを参照
    • metadata.from_studio_project_idproject_idです:b7d43125-314b-4eb9-97d7-99f4113f7cb0
    • metadata.override_history_clip_idclip_id_matherです:bb91d24d-27b5-4dd0-9ace-4861184daaee
    • metadata.override_future_start_secondsは開始ビートに対応する時間です:start_beats/bps 26.3795=32/1.2130977508411211
    • metadata.override_history_end_secondsは終了ビートに対応する時間です:end_beats/bps
    • batch_sizeは調整が必要な変数と思われます
  • レスポンスデータは標準の作成APIフォーマットに従います

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 https://api.openai-hk.com/suno/feed/clipsId1,clipsId2

6. ビートを取得

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

  • 課金:100クレジット/リクエスト
  • JSONを返します:
json
{
	"state": "complete",
	"downbeats": [
		[
			0.00006,
			2
		],
		[
			0.36004,
			3
		],
    .....
  ]
}
{
	"state": "complete",
	"downbeats": [
		[
			0.00006,
			2
		],
		[
			0.36004,
			3
		],
    .....
  ]
}

シーン1:編集インターフェースを使用して曲を編集

  • ここのほとんどの機能はhttps://suno.com/edit/{clip_id}のインターフェースに由来します(例:https://suno.com/edit/636d7348-654c-4b5f-af1f-56b3e8ecade6)
  • replacecreate sectioncopysplitextend、スワップ操作をサポート
  • 具体的な機能についてはSunoのedit interfaceを参照
  • 核心原理:
    • A:プロジェクト内のstate.tracks[0].clipsを編集します — これはコピー、追加、削除、分割、並べ替えをサポートする配列です。クリップは次の条件を満たす必要があります:state.tracks[0].clips[0].endBeats = state.tracks[0].clips[1].startBeats
    • B:編集したプロジェクトを保存し、stateコンテンツをレンダーを作成 APIに渡して新しい曲を取得します
    • C:レンダーAPIのdownbeatsは、state.tracks[0].clipsをソートして使用するビートを決定することで組み立てる必要があります
  • 以下ではreplaceを例として使用します

A. clip_idからproject_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

  • 課金:100クレジット/リクエスト
  • 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
}
  • 返されたidproject_idです

B. project_idを介してプロジェクトを取得

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

  • 最初は空です
  • 後で保存プロジェクトAPIを介して充実させ、state.tracks[0]state.markersRegistryを設定します
  • 主にstate.tracks[0].clips配列セグメントを設定します
  • 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
}
  • 以下のフォーマットにデータを組み立て、保存プロジェクト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. 置換クリップを生成

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

  • リクエストボディ:
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": "...(曲の歌詞)...",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "...(補完歌詞)...",
    "lyrics_updated": false,
    "is_remix": true
  },

  "continue_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
  "continued_aligned_prompt": "...(整列歌詞)...",
  "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": "...(曲の歌詞)...",
  "metadata": {
    "create_mode": "custom",
    "infill_lyrics": "...(補完歌詞)...",
    "lyrics_updated": false,
    "is_remix": true
  },

  "continue_clip_id": "ca6d28e3-7922-452d-844b-51a288f700a3",
  "continued_aligned_prompt": "...(整列歌詞)...",
  "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
}
  • 2つのclip IDを返します:8ac7d50b-77ed-4e7f-b402-505f896db5e2b768e803-a662-4757-9252-351b3d296a86
  • 両方のclip IDの生成が完了するのを待ってから、ビートを取得します

D. 保存プロジェクトを介してコミットアクションを実行

  • リクエストボディはステップBの初期プロジェクトと比較する必要があります
  • 主な違い:
      1. state.tracks[0].takeLanes配列にエントリが1つ追加されました
      1. state.markersRegistryに2つのオブジェクトが追加されました
      1. 主な変更:state.tracks[0].clips配列には2つのグループがあります — これは置換なので、1つのセグメントを3つの部分に分割し、中央のセグメントが置換です
      1. state.tracks[0].clips[1]データは新しく生成された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. ビートを取得してdownbeatsを組み立て

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

  • メインビートと新しく生成された置換clip_idのビートを取得する必要があります
  • state.tracks[0].clips[].startBeatsstate.tracks[0].clips[].endBeatsを使用してソートし、downbeats値の取得元を決定します
  • downbeatsが組み立てられたら、レンダーを作成 APIを使用して新しい曲を取得します

F. 新しいレンダーを介して新しい曲を取得

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"}'
  • レスポンス:
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
}