Upload folder using huggingface_hub

.dockerignore

@@ -0,0 +1,43 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+.idea
+
+public/
+Dockerfile
+docker-compose.yml
+README*.md

.env.example

@@ -0,0 +1,2 @@
+SUNO_COOKIE=<your-suno-cookie>
+

.eslintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "next/core-web-vitals"
+}

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+public/get-cookie-demo.gif filter=lfs diff=lfs merge=lfs -text
+public/get-cookie-demo.mp4 filter=lfs diff=lfs merge=lfs -text

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/新功能.md

@@ -0,0 +1,21 @@
+---
+name: 新功能
+about: 为这个项目提出一个新想法 / 需求
+title: 我需要一个...功能，来解决...问题
+labels: ''
+assignees: ''
+
+---
+
+**请描述您想要的新功能，可以解决什么问题？**
+对被解决的问题明确而简洁的描述。例：
+当...时，我感觉很沮丧。
+
+**描述你想要的新功能** 
+清晰而简洁的描述你想要的新功能是什么。
+
+**描述你考虑过的替代方案**
+请清晰的简洁的描述你考虑过的任何替代方案，这将有助于我们理解你的需求。
+
+**其他有关这个新功能的信息**
+在这里添加更多的有关这个新功能的上下文，或者截图。

.gitignore

@@ -0,0 +1,39 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+.env
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+.idea

Dockerfile

@@ -0,0 +1,21 @@
+# syntax=docker/dockerfile:1
+
+FROM node:lts-alpine AS builder
+WORKDIR /src
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npm run build
+
+FROM node:lts-alpine
+WORKDIR /app
+COPY package*.json ./
+
+ARG SUNO_COOKIE
+RUN if [ -z "$SUNO_COOKIE" ]; then echo "SUNO_COOKIE is not set" && exit 1; fi
+ENV SUNO_COOKIE=${SUNO_COOKIE}
+
+RUN npm install --only=production
+COPY --from=builder /src/.next ./.next
+EXPOSE 3000
+CMD ["npm", "run", "start"]

FUNDING.yml

@@ -0,0 +1,14 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: gcui # Replace with a single Buy Me a Coffee username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

LICENSE

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

README.md

@@ -1,12 +1,327 @@
----
-title: Suno
-emoji: 📉
-colorFrom: purple
-colorTo: pink
-sdk: gradio
-sdk_version: 4.41.0
-app_file: app.py
-pinned: false
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+<div align="center">
+  <h1 align="center"">
+      Suno AI API
+  </h1>
+  <p>Use API to call the music generation AI of Suno.ai and easily integrate it into agents like GPTs.</p>
+  <p>👉 We update quickly, please star.</p>
+</div>
+<p align="center">
+  <a target="_blank" href="./README.md">English</a> 
+  | <a target="_blank" href="./README_CN.md">简体中文</a> 
+  | <a target="_blank" href="https://suno.gcui.ai">Demo</a> 
+  | <a target="_blank" href="https://suno.gcui.ai/docs">Docs</a> 
+  | <a target="_blank" href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgcui-art%2Fsuno-api&env=SUNO_COOKIE&project-name=suno-api&repository-name=suno-api">Deploy with Vercel</a> 
+</p>
+<p align="center">
+  <a href="https://www.producthunt.com/products/gcui-art-suno-api-open-source-sunoai-api/reviews?utm_source=badge-product_review&utm_medium=badge&utm_souce=badge-gcui&#0045;art&#0045;suno&#0045;api&#0045;open&#0045;source&#0045;sunoai&#0045;api" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/product_review.svg?product_id=577408&theme=light" alt="gcui&#0045;art&#0047;suno&#0045;api&#0058;Open&#0045;source&#0032;SunoAI&#0032;API - Use&#0032;API&#0032;to&#0032;call&#0032;the&#0032;music&#0032;generation&#0032;AI&#0032;of&#0032;suno&#0046;ai&#0046; | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</p>
+
+> 🔥 Check out our new open-source project: [Album AI - Chat with your gallery using plain language!](https://github.com/gcui-art/album-ai)
+
+![suno-api banner](https://github.com/gcui-art/suno-api/blob/main/public/suno-banner.png)
+
+## Introduction
+
+Suno.ai v3 is an amazing AI music service. Although the official API is not yet available, we couldn't wait to integrate its capabilities somewhere.
+
+We discovered that some users have similar needs, so we decided to open-source this project, hoping you'll like it.
+
+## Demo
+
+We have deployed an example bound to a free Suno account, so it has daily usage limits, but you can see how it runs:
+[suno.gcui.ai](https://suno.gcui.ai)
+
+## Features
+
+- Perfectly implements the creation API from app.suno.ai
+- Automatically keep the account active.
+- Compatible with the format of OpenAI’s `/v1/chat/completions` API.
+- Supports Custom Mode
+- One-click deployment to Vercel
+- In addition to the standard API, it also adapts to the API Schema of Agent platforms like GPTs and Coze, so you can use it as a tool/plugin/Action for LLMs and integrate it into any AI Agent.
+- Permissive open-source license, allowing you to freely integrate and modify.
+
+## Getting Started
+
+### 1. Obtain the cookie of your app.suno.ai account
+
+1. Head over to [app.suno.ai](https://app.suno.ai) using your browser.
+2. Open up the browser console: hit `F12` or access the `Developer Tools`.
+3. Navigate to the `Network tab`.
+4. Give the page a quick refresh.
+5. Identify the request that includes the keyword `client?_clerk_js_version`.
+6. Click on it and switch over to the `Header` tab.
+7. Locate the `Cookie` section, hover your mouse over it, and copy the value of the Cookie.
+
+![get cookie](https://github.com/gcui-art/suno-api/blob/main/public/get-cookie-demo.gif)
+
+### 2. Clone and deploy this project
+
+You can choose your preferred deployment method:
+
+#### Deploy to Vercel
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgcui-art%2Fsuno-api&env=SUNO_COOKIE&project-name=suno-api&repository-name=suno-api)
+
+#### Run locally
+
+```bash
+git clone https://github.com/gcui-art/suno-api.git
+cd suno-api
+npm install
+```
+
+Alternatively, you can use [Docker Compose](https://docs.docker.com/compose/)
+
+```bash
+docker compose build && docker compose up
+```
+
+### 3. Configure suno-api
+
+- If deployed to Vercel, please add an environment variable `SUNO_COOKIE` in the Vercel dashboard, with the value of the cookie obtained in the first step.
+
+- If you’re running this locally, be sure to add the following to your `.env` file:
+
+```bash
+SUNO_COOKIE=<your-cookie>
+```
+
+### 4. Run suno api
+
+- If you’ve deployed to Vercel:
+  - Please click on Deploy in the Vercel dashboard and wait for the deployment to be successful.
+  - Visit the `https://<vercel-assigned-domain>/api/get_limit` API for testing.
+- If running locally:
+  - Run `npm run dev`.
+  - Visit the `http://localhost:3000/api/get_limit` API for testing.
+- If the following result is returned:
+
+```json
+{
+  "credits_left": 50,
+  "period": "day",
+  "monthly_limit": 50,
+  "monthly_usage": 50
+}
+```
+
+it means the program is running normally.
+
+### 5. Use Suno API
+
+You can check out the detailed API documentation at :
+[suno.gcui.ai/docs](https://suno.gcui.ai/docs)
+
+## API Reference
+
+Suno API currently mainly implements the following APIs:
+
+```bash
+- `/api/generate`: Generate music
+- `/v1/chat/completions`: Generate music - Call the generate API in a format that works with OpenAI’s API.
+- `/api/custom_generate`: Generate music (Custom Mode, support setting lyrics, music style, title, etc.)
+- `/api/generate_lyrics`: Generate lyrics based on prompt
+- `/api/get`: Get music information based on the id. Use “,” to separate multiple ids.
+    If no IDs are provided, all music will be returned.
+- `/api/get_limit`: Get quota Info
+- `/api/extend_audio`: Extend audio length
+- `/api/clip`: Get clip information based on ID passed as query parameter `id`
+- `/api/concat`: Generate the whole song from extensions
+```
+
+For more detailed documentation, please check out the demo site:
+[suno.gcui.ai/docs](https://suno.gcui.ai/docs)
+
+## API Integration Code Example
+
+### Python
+
+```python
+import time
+import requests
+
+# replace your vercel domain
+base_url = 'http://localhost:3000'
+
+
+def custom_generate_audio(payload):
+    url = f"{base_url}/api/custom_generate"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+
+def extend_audio(payload):
+    url = f"{base_url}/api/extend_audio"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+def generate_audio_by_prompt(payload):
+    url = f"{base_url}/api/generate"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+
+def get_audio_information(audio_ids):
+    url = f"{base_url}/api/get?ids={audio_ids}"
+    response = requests.get(url)
+    return response.json()
+
+
+def get_quota_information():
+    url = f"{base_url}/api/get_limit"
+    response = requests.get(url)
+    return response.json()
+
+def get_clip(clip_id):
+    url = f"{base_url}/api/clip?id={clip_id}"
+    response = requests.get(url)
+    return response.json()
+
+def generate_whole_song(clip_id):
+    payloyd = {"clip_id": clip_id}
+    url = f"{base_url}/api/concat"
+    response = requests.post(url, json=payload)
+    return response.json()
+
+
+if __name__ == '__main__':
+    data = generate_audio_by_prompt({
+        "prompt": "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war.",
+        "make_instrumental": False,
+        "wait_audio": False
+    })
+
+    ids = f"{data[0]['id']},{data[1]['id']}"
+    print(f"ids: {ids}")
+
+    for _ in range(60):
+        data = get_audio_information(ids)
+        if data[0]["status"] == 'streaming':
+            print(f"{data[0]['id']} ==> {data[0]['audio_url']}")
+            print(f"{data[1]['id']} ==> {data[1]['audio_url']}")
+            break
+        # sleep 5s
+        time.sleep(5)
+
+```
+
+### Js
+
+```js
+const axios = require("axios");
+
+// replace your vercel domain
+const baseUrl = "http://localhost:3000";
+
+async function customGenerateAudio(payload) {
+  const url = `${baseUrl}/api/custom_generate`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+
+async function generateAudioByPrompt(payload) {
+  const url = `${baseUrl}/api/generate`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+
+async function extendAudio(payload) {
+  const url = `${baseUrl}/api/extend_audio`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+
+async function getAudioInformation(audioIds) {
+  const url = `${baseUrl}/api/get?ids=${audioIds}`;
+  const response = await axios.get(url);
+  return response.data;
+}
+
+async function getQuotaInformation() {
+  const url = `${baseUrl}/api/get_limit`;
+  const response = await axios.get(url);
+  return response.data;
+}
+
+async function getClipInformation(clipId) {
+  const url = `${baseUrl}/api/clip?id=${clipId}`;
+  const response = await axios.get(url);
+  return response.data;
+}
+
+async function main() {
+  const data = await generateAudioByPrompt({
+    prompt:
+      "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war.",
+    make_instrumental: false,
+    wait_audio: false,
+  });
+
+  const ids = `${data[0].id},${data[1].id}`;
+  console.log(`ids: ${ids}`);
+
+  for (let i = 0; i < 60; i++) {
+    const data = await getAudioInformation(ids);
+    if (data[0].status === "streaming") {
+      console.log(`${data[0].id} ==> ${data[0].audio_url}`);
+      console.log(`${data[1].id} ==> ${data[1].audio_url}`);
+      break;
+    }
+    // sleep 5s
+    await new Promise((resolve) => setTimeout(resolve, 5000));
+  }
+}
+
+main();
+```
+
+## Integration with Custom Agents
+
+You can integrate Suno AI as a tool/plugin/action into your AI agent.
+
+### Integration with GPTs
+
+[coming soon...]
+
+### Integration with Coze
+
+[coming soon...]
+
+### Integration with LangChain
+
+[coming soon...]
+
+## Contributing
+
+There are four ways you can support this project:
+
+1. Fork and Submit Pull Requests: We welcome any PRs that enhance the component or editor.
+2. Open Issues: We appreciate reasonable suggestions and bug reports.
+3. Donate: If this project has helped you, consider buying us a coffee using the Sponsor button at the top of the project. Cheers! ☕
+4. Spread the Word: Recommend this project to others, star the repo, or add a backlink after using the project.
+
+## Questions, Suggestions, Issues, or Bugs?
+
+We use GitHub Issues to manage feedback. Feel free to open an issue, and we'll address it promptly.
+
+## License
+
+LGPL-3.0 or later
+
+## Related Links
+
+- Project repository: [github.com/gcui-art/suno-api](https://github.com/gcui-art/suno-api)
+- Suno.ai official website: [suno.ai](https://suno.ai)
+- Demo: [suno.gcui.ai](https://suno.gcui.ai)
+- Album AI: [Auto generate image metadata and chat with the album. RAG + Album.](https://github.com/gcui-art/album-ai)
+
+## Statement
+
+suno-api is an unofficial open source project, intended for learning and research purposes only.

README_CN.md

@@ -0,0 +1,304 @@
+<div align="center">
+  <h1 align="center"">
+      Suno AI API
+  </h1>
+  <p>用 API 调用 suno.ai 的音乐生成 AI，并且可以轻松集成到 GPTs 等 agent 中。</p>
+  <p>👉 我们更新很快，欢迎 star。</p>
+</div>
+<p align="center">
+  <a target="_blank" href="./README.md">English</a> 
+  | <a target="_blank" href="./README_CN.md">简体中文</a> 
+  | <a target="_blank" href="https://suno.gcui.ai">Demo</a> 
+  | <a target="_blank" href="https://suno.gcui.ai/docs">文档</a> 
+  | <a target="_blank" href="https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgcui-art%2Fsuno-api&env=SUNO_COOKIE&project-name=suno-api&repository-name=suno-api">一键部署到 Vercel</a> 
+  
+</p>
+<p align="center">
+  <a href="https://www.producthunt.com/products/gcui-art-suno-api-open-source-sunoai-api/reviews?utm_source=badge-product_review&utm_medium=badge&utm_souce=badge-gcui&#0045;art&#0045;suno&#0045;api&#0045;open&#0045;source&#0045;sunoai&#0045;api" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/product_review.svg?product_id=577408&theme=light" alt="gcui&#0045;art&#0047;suno&#0045;api&#0058;Open&#0045;source&#0032;SunoAI&#0032;API - Use&#0032;API&#0032;to&#0032;call&#0032;the&#0032;music&#0032;generation&#0032;AI&#0032;of&#0032;suno&#0046;ai&#0046; | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</p>
+> 🔥 我们新的开源项目: [Album AI - 用自然语言与你的图库对话!](https://github.com/gcui-art/album-ai)
+
+![suno-api banner](https://github.com/gcui-art/suno-api/blob/main/public/suno-banner.png)
+
+## 简介
+
+Suno.ai v3 是一个令人惊叹的 AI 音乐服务，虽然官方还没有开放 API，但我们已经迫不及待的想在某些地方集成它的能力。
+我们发现有一些用户也有类似需求，于是我们将这个项目开源了，希望你们喜欢。
+
+## Demo
+
+我们部署了一个示例，绑定了一个免费的 suno 账号，所以它每天有使用限制，但你可以看到它运行起来的样子：
+[suno.gcui.ai](https://suno.gcui.ai)
+
+## Features
+
+- 完美的实现了 app.suno.ai 中的大部分 API
+- 自动保持账号活跃
+- 兼容 OpenAI 的 `/v1/chat/completions` API 格式
+- 支持 Custom Mode
+- 一键部署到 vercel
+- 除了标准 API，还适配了 GPTs、coze 等 Agent 平台的 API Schema，所以你可以把它当做一个 LLM 的工具/插件/Action，集成到任意 AI Agent 中。
+- 宽松的开源协议，你可以随意的集成和修改。
+
+## 如何开始使用？
+
+### 1. 获取你的 app.suno.ai 账号的 cookie
+
+1. 浏览器访问 [app.suno.ai](https://app.suno.ai)
+2. 打开浏览器的控制台：按下 `F12` 或者`开发者工具`
+3. 选择`网络`标签
+4. 刷新页面
+5. 找到包含`client?_clerk_js_version`关键词的请求
+6. 点击并切换到 `Header` 标签
+7. 找到 `Cookie` 部分，鼠标复制 Cookie 的值
+
+![获取cookie](https://github.com/gcui-art/suno-api/blob/main/public/get-cookie-demo.gif)
+
+### 2. 克隆并部署本项目
+
+你可以选择自己喜欢的部署方式：
+
+#### 部署到 Vercel
+
+[![部署到 Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgcui-art%2Fsuno-api&env=SUNO_COOKIE&project-name=suno-api&repository-name=suno-api)
+
+#### 本地运行
+
+```bash
+git clone https://github.com/gcui-art/suno-api.git
+cd suno-api
+npm install
+```
+
+或者，你也可以使用 [Docker Compose](https://docs.docker.com/compose/)
+
+```bash
+docker compose build && docker compose up
+```
+
+### 3. 配置 suno-api
+
+- 如果部署到了 Vercel，请在 Vercel 后台，添加环境变量 `SUNO_COOKIE`，值为第一步获取的 cookie。
+- 如果在本地运行，请在 .env 文件中添加：
+
+```bash
+SUNO_COOKIE=<your-cookie>
+```
+
+### 4. 运行 suno api
+
+- 如果部署到了 Vercel：
+  - 请在 Vercel 后台，点击 `Deploy`，等待部署成功。
+  - 访问 `https://<vercel分配的域名>/api/get_limit` API 进行测试
+- 如果在本地运行：
+  - 请运行 `npm run dev`
+  - 访问 `http://localhost:3000/api/get_limit` API 进行测试
+- 如果返回以下结果：
+
+```json
+{
+  "credits_left": 0,
+  "period": "string",
+  "monthly_limit": 0,
+  "monthly_usage": 0
+}
+```
+
+则已经正常运行。
+
+### 5. 使用 Suno API
+
+你可以在 [suno.gcui.ai](https://suno.gcui.ai/docs)查看详细的 API 文档，并在线测试。
+
+## API 说明
+
+Suno API 目前主要实现了以下 API:
+
+```bash
+- `/api/generate`: 创建音乐
+- `/v1/chat/completions`: 创建音乐 - 用OpenAI API 兼容的格式调用 generate API
+- `/api/custom_generate`: 创建音乐（自定义模式，支持设置歌词、音乐风格、设置标题等）
+- `/api/generate_lyrics`: 根据Prompt创建歌词
+- `/api/get`: 根据id获取音乐信息。获取多个请用","分隔，不传ids则返回所有音乐
+- `/api/get_limit`: 获取配额信息
+- `/api/extend_audio`: 在一首音乐的基础上，扩展音乐长度
+- `/api/clip`: 检索特定音乐的信息
+- `/api/concat`: 合并音乐，将扩展后的音乐和原始音乐合并
+```
+
+详细文档请查看演示站点:
+[suno.gcui.ai/docs](https://suno.gcui.ai/docs)
+
+## API 集成代码示例
+
+### Python
+
+```python
+import time
+import requests
+
+# replace your vercel domain
+base_url = 'http://localhost:3000'
+
+
+def custom_generate_audio(payload):
+    url = f"{base_url}/api/custom_generate"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+def extend_audio(payload):
+    url = f"{base_url}/api/extend_audio"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+
+def generate_audio_by_prompt(payload):
+    url = f"{base_url}/api/generate"
+    response = requests.post(url, json=payload, headers={'Content-Type': 'application/json'})
+    return response.json()
+
+
+def get_audio_information(audio_ids):
+    url = f"{base_url}/api/get?ids={audio_ids}"
+    response = requests.get(url)
+    return response.json()
+
+
+def get_quota_information():
+    url = f"{base_url}/api/get_limit"
+    response = requests.get(url)
+    return response.json()
+
+
+if __name__ == '__main__':
+    data = generate_audio_by_prompt({
+        "prompt": "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war.",
+        "make_instrumental": False,
+        "wait_audio": False
+    })
+
+    ids = f"{data[0]['id']},{data[1]['id']}"
+    print(f"ids: {ids}")
+
+    for _ in range(60):
+        data = get_audio_information(ids)
+        if data[0]["status"] == 'streaming':
+            print(f"{data[0]['id']} ==> {data[0]['audio_url']}")
+            print(f"{data[1]['id']} ==> {data[1]['audio_url']}")
+            break
+        # sleep 5s
+        time.sleep(5)
+
+```
+
+### Js
+
+```js
+const axios = require("axios");
+
+// replace your vercel domain
+const baseUrl = "http://localhost:3000";
+
+async function customGenerateAudio(payload) {
+  const url = `${baseUrl}/api/custom_generate`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+
+async function generateAudioByPrompt(payload) {
+  const url = `${baseUrl}/api/generate`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+async function extendAudio(payload) {
+  const url = `${baseUrl}/api/extend_audio`;
+  const response = await axios.post(url, payload, {
+    headers: { "Content-Type": "application/json" },
+  });
+  return response.data;
+}
+
+async function getAudioInformation(audioIds) {
+  const url = `${baseUrl}/api/get?ids=${audioIds}`;
+  const response = await axios.get(url);
+  return response.data;
+}
+
+async function getQuotaInformation() {
+  const url = `${baseUrl}/api/get_limit`;
+  const response = await axios.get(url);
+  return response.data;
+}
+
+async function main() {
+  const data = await generateAudioByPrompt({
+    prompt:
+      "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war.",
+    make_instrumental: false,
+    wait_audio: false,
+  });
+
+  const ids = `${data[0].id},${data[1].id}`;
+  console.log(`ids: ${ids}`);
+
+  for (let i = 0; i < 60; i++) {
+    const data = await getAudioInformation(ids);
+    if (data[0].status === "streaming") {
+      console.log(`${data[0].id} ==> ${data[0].audio_url}`);
+      console.log(`${data[1].id} ==> ${data[1].audio_url}`);
+      break;
+    }
+    // sleep 5s
+    await new Promise((resolve) => setTimeout(resolve, 5000));
+  }
+}
+
+main();
+```
+
+## 集成到到常见的自定义 Agent 中
+
+你可以把 suno ai 当做一个 工具/插件/Action 集成到你的 AI Agent 中。
+
+### 集成到 GPTs
+
+[coming soon...]
+
+### 集成到 coze
+
+[coming soon...]
+
+### 集成到 LangChain
+
+[coming soon...]
+
+## 贡献指南
+
+您有四种方式支持本项目：
+
+1. Fork 项目并提交 PR：我们欢迎任何让这个组件和Editor变的更好的PR。
+2. 提交Issue：我们欢迎任何合理的建议、bug反馈。
+3. 捐赠：在项目的顶部我们放置了 Sponsor 按钮，如果这个项目帮助到了您，你可以请我们喝一杯，干杯☕。
+4. 推荐：向其他人推荐本项目；点击Star；使用本项目后放置外链。
+
+## 许可证
+
+LGPL-3.0 或更高版本
+
+## 你有一个问题/建议/困难/Bug？
+
+我们使用Github的Issue来管理这些反馈，你可以提交一个。我们会经常来处理。
+
+## 相关链接
+
+- 项目仓库: [github.com/gcui-art/suno-api](https://github.com/gcui-art/suno-api)
+- Suno.ai 官网: [suno.ai](https://suno.ai)
+- 演示站点: [suno.gcui.ai](https://suno.gcui.ai)
+
+## 声明
+
+suno-api 是一个非官方的开源项目，仅供学习和研究使用。

docker-compose.yml

@@ -0,0 +1,12 @@
+version: '3'
+
+services:
+  suno-api:
+    build:
+      context: .
+      args:
+        SUNO_COOKIE: ${SUNO_COOKIE}
+    volumes:
+      - ./public:/app/public
+    ports:
+      - "3000:3000"

next.config.mjs

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+export default nextConfig;

package.json

@@ -0,0 +1,47 @@
+{
+  "name": "suno-api",
+  "description": "Use API to call the music generation service of suno.ai, and easily integrate it into agents like GPTs.",
+  "author": {
+    "name": "gcui.ai",
+    "url": "https://github.com/gcui-art/"
+  },
+  "license": "LGPL-3.0-or-later",
+  "version": "1.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@vercel/analytics": "^1.2.2",
+    "axios": "^1.6.8",
+    "axios-cookiejar-support": "^5.0.0",
+    "next": "14.1.4",
+    "next-swagger-doc": "^0.4.0",
+    "pino": "^8.19.0",
+    "pino-pretty": "^11.0.0",
+    "react": "^18",
+    "react-dom": "^18",
+    "react-markdown": "^9.0.1",
+    "swagger-ui-react": "^5.12.3",
+    "tough-cookie": "^4.1.4",
+    "user-agents": "^1.1.156"
+  },
+  "devDependencies": {
+    "@tailwindcss/typography": "^0.5.12",
+    "@types/node": "^20",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "@types/swagger-ui-react": "^4.18.3",
+    "@types/tough-cookie": "^4.0.5",
+    "@types/user-agents": "^1.0.4",
+    "autoprefixer": "^10.0.1",
+    "eslint": "^8.57.0",
+    "eslint-config-next": "14.1.4",
+    "postcss": "^8",
+    "tailwindcss": "^3.3.0",
+    "typescript": "^5"
+  }
+}

postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

public/get-cookie-demo.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6ee1df7a41fdc5064253da0d13c69abb4af879a05b593f30157894e44ed84472
+size 6762147

public/swagger-suno-api.json

@@ -0,0 +1,257 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "suno-api",
+    "description": "",
+    "version": "",
+    "license": { "name": "gcui-art", "url": "https://github.com/gcui-art/" }
+  },
+  "tags": [{ "name": "\u9ed8\u8ba4\u5206\u7ec4" }],
+  "paths": {
+    "/api/custom_generate": {
+      "post": {
+        "summary": "Generate Audio - Custom Mode",
+        "description": "The custom mode enables users to provide additional details about the music, such as music genre, lyrics, and more.2 audio files will be generated for each request, consuming a total of 10 credits.wait_audio can be set to API mode:\u2022 By default, it is set to false, which indicates the background mode. It will only return audio task information, and you will need to call the get API to retrieve detailed audio information.\u2022 If set to true, it simulates synchronous mode. The API will wait for a maximum of 100s until the audio is generated, and will directly return the audio link and other information. Recommend using in GPTs and other agents.",
+        "tags": ["\u9ed8\u8ba4\u5206\u7ec4"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt", "tags", "title"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Detailed prompt, including information such as music lyrics.",
+                    "example": "[Verse 1]\nCruel flames of war engulf this land\nBattlefields filled with death and dread\nInnocent souls in darkness, they rest\nMy heart trembles in this silent test\n\n[Verse 2]\nPeople weep for loved ones lost\nBattered bodies bear the cost\nSeeking peace and hope once known\nOur grief transforms to hearts of stone\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Bridge]\nThrough the ashes, we will rise\nHand in hand, towards peaceful skies\nNo more sorrow, no more pain\nTogether, we'll break these chains\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Outro]\nIn unity, our strength will grow\nA brighter future, we'll soon know\nFrom the ruins, hope will spring\nA new dawn, we'll together bring"
+                  },
+                  "tags": {
+                    "type": "string",
+                    "description": "Music genre",
+                    "example": "pop metal male melancholic"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Music title",
+                    "example": "Silent Battlefield"
+                  },
+                  "make_instrumental": {
+                    "type": "boolean",
+                    "description": "Whether to generate instrumental music",
+                    "example": "false"
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  },
+                  "wait_audio": {
+                    "type": "boolean",
+                    "description": "Whether to wait for music generation, default is false, directly return audio task information; set to true, will wait for up to 100s until the audio is generated.",
+                    "example": "false"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "\u6210\u529f",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["0", "1"],
+                    "properties": [
+                      { "$ref": "#/components/schemas/audio info" },
+                      { "$ref": "#/components/schemas/audio info" }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/generate": {
+      "post": {
+        "summary": "Generate audio based on Prompt.",
+        "description": "It will automatically fill in the lyrics.2 audio files will be generated for each request, consuming a total of 10 credits.wait_audio can be set to API mode:\u2022 By default, it is set to false, which indicates the background mode. It will only return audio task information, and you will need to call the get API to retrieve detailed audio information.\u2022 If set to true, it simulates synchronous mode. The API will wait for a maximum of 100s until the audio is generated, and will directly return the audio link and other information. Recommend using in GPTs and other agents.",
+        "tags": ["\u9ed8\u8ba4\u5206\u7ec4"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt", "make_instrumental", "wait_audio"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Prompt",
+                    "example": "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war."
+                  },
+                  "make_instrumental": {
+                    "type": "boolean",
+                    "description": "Whether to generate instrumental music",
+                    "example": "false"
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  },
+                  "wait_audio": {
+                    "type": "boolean",
+                    "description": "Whether to wait for music generation, default is false, directly return audio task information; set to true, will wait for up to 100s until the audio is generated.",
+                    "example": "false"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "\u6210\u529f",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["0", "1"],
+                    "properties": [
+                      { "$ref": "#/components/schemas/audio info" },
+                      { "$ref": "#/components/schemas/audio info" }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/get": {
+      "get": {
+        "summary": "Get audio information",
+        "description": "",
+        "tags": ["\u9ed8\u8ba4\u5206\u7ec4"],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "ids",
+            "description": "Audio IDs, separated by commas.",
+            "required": true,
+            "schema": { "type": "string" }
+          }
+        ],
+        "responses": { "200": { "description": "\u6210\u529f" } }
+      }
+    },
+    "/api/get_limit": {
+      "get": {
+        "summary": "Get quota information.",
+        "description": "",
+        "tags": ["\u9ed8\u8ba4\u5206\u7ec4"],
+        "responses": {
+          "200": {
+            "description": "\u6210\u529f",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "credits_left",
+                    "period",
+                    "monthly_limit",
+                    "monthly_usage"
+                  ],
+                  "properties": {
+                    "credits_left": {
+                      "type": "number",
+                      "description": "Remaining credits,Each generated audio consumes 5 credits."
+                    },
+                    "period": { "type": "string", "description": "Period" },
+                    "monthly_limit": {
+                      "type": "number",
+                      "description": "Monthly limit"
+                    },
+                    "monthly_usage": {
+                      "type": "number",
+                      "description": "Monthly usage"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "audio info": {
+        "type": "object",
+        "required": [
+          "id",
+          "title",
+          "image_url",
+          "lyric",
+          "audio_url",
+          "video_url",
+          "created_at",
+          "model_name",
+          "status",
+          "gpt_description_prompt",
+          "prompt",
+          "type",
+          "tags"
+        ],
+        "properties": {
+          "id": { "type": "string", "description": "audio id" },
+          "title": { "type": "string", "description": "music title" },
+          "image_url": { "type": "string", "description": "music cover image" },
+          "lyric": { "type": "string", "description": "music lyric" },
+          "audio_url": {
+            "type": "string",
+            "description": "music download url"
+          },
+          "video_url": {
+            "type": "string",
+            "description": "Music video download link, can be used to share"
+          },
+          "created_at": { "type": "string", "description": "Create time" },
+          "model_name": {
+            "type": "string",
+            "description": "suno model name, chirp-v3"
+          },
+          "status": {
+            "type": "string",
+            "description": "The generated states include submitted, queue, streaming, complete."
+          },
+          "gpt_description_prompt": {
+            "type": "string",
+            "description": "Simple mode on user input prompt, Suno will generate formal prompts, lyrics, etc."
+          },
+          "prompt": {
+            "type": "string",
+            "description": "The final prompt for executing the generation task, customized by the user in custom mode, automatically generated by Suno in simple mode."
+          },
+          "type": { "type": "string", "description": "Type" },
+          "tags": {
+            "type": "string",
+            "description": "Music genre. User-provided in custom mode, automatically generated by Suno in simple mode."
+          }
+        },
+        "title": "audio info",
+        "description": "audio info"
+      }
+    }
+  }
+}

src/app/api/clip/route.ts

@@ -0,0 +1,58 @@
+import { NextResponse, NextRequest } from "next/server";
+import { sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function GET(req: NextRequest) {
+  if (req.method === 'GET') {
+    try {
+      const url = new URL(req.url);
+      const clipId = url.searchParams.get('id');
+      if (clipId == null) {
+        return new NextResponse(JSON.stringify({ error: 'Missing parameter id' }), {
+          status: 400,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+
+      const audioInfo = await (await sunoApi).getClip(clipId);
+
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error) {
+      console.error('Error fetching audio:', error);
+
+      return new NextResponse(JSON.stringify({ error: 'Internal server error' }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'GET',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/concat/route.ts

@@ -0,0 +1,64 @@
+import { NextResponse, NextRequest } from "next/server";
+import { sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function POST(req: NextRequest) {
+  if (req.method === 'POST') {
+    try {
+      const body = await req.json();
+      const { clip_id } = body;
+      if (!clip_id) {
+        return new NextResponse(JSON.stringify({ error: 'Clip id is required' }), {
+          status: 400,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      const audioInfo = await (await sunoApi).concatenate(clip_id);
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating concatenating audio:', error.response.data);
+      if (error.response.status === 402) {
+        return new NextResponse(JSON.stringify({ error: error.response.data.detail }), {
+          status: 402,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      return new NextResponse(JSON.stringify({ error: 'Internal server error' }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'POST',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/custom_generate/route.ts

@@ -0,0 +1,61 @@
+import { NextResponse, NextRequest } from "next/server";
+import { DEFAULT_MODEL, sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const maxDuration = 60; // allow longer timeout for wait_audio == true
+export const dynamic = "force-dynamic";
+
+export async function POST(req: NextRequest) {
+  if (req.method === 'POST') {
+    try {
+      const body = await req.json();
+      const { prompt, tags, title, make_instrumental, model, wait_audio } = body;
+      const audioInfo = await (await sunoApi).custom_generate(
+        prompt, tags, title,
+        Boolean(make_instrumental),
+        model || DEFAULT_MODEL,
+        Boolean(wait_audio)
+      );
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating custom audio:', error.response.data);
+      if (error.response.status === 402) {
+        return new NextResponse(JSON.stringify({ error: error.response.data.detail }), {
+          status: 402,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      return new NextResponse(JSON.stringify({ error: 'Internal server error' }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'POST',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/extend_audio/route.ts

@@ -0,0 +1,69 @@
+import { NextResponse, NextRequest } from "next/server";
+import { DEFAULT_MODEL, sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function POST(req: NextRequest) {
+  if (req.method === 'POST') {
+    try {
+      const body = await req.json();
+      const { audio_id, prompt, continue_at, tags, title, model } = body;
+
+      if (!audio_id) {
+        return new NextResponse(JSON.stringify({ error: 'Audio ID is required' }), {
+          status: 400,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+
+      const audioInfo = await (await sunoApi)
+        .extendAudio(audio_id, prompt, continue_at, tags, title, model || DEFAULT_MODEL);
+
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error extend audio:', JSON.stringify(error.response.data));
+      if (error.response.status === 402) {
+        return new NextResponse(JSON.stringify({ error: error.response.data.detail }), {
+          status: 402,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      return new NextResponse(JSON.stringify({ error: 'Internal server error: ' + JSON.stringify(error.response.data.detail) }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'POST',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/generate/route.ts

@@ -0,0 +1,63 @@
+import { NextResponse, NextRequest } from "next/server";
+import { DEFAULT_MODEL, sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function POST(req: NextRequest) {
+  if (req.method === 'POST') {
+    try {
+      const body = await req.json();
+      const { prompt, make_instrumental, model, wait_audio } = body;
+
+      const audioInfo = await (await sunoApi).generate(
+        prompt,
+        Boolean(make_instrumental),
+        model || DEFAULT_MODEL,
+        Boolean(wait_audio)
+      );
+
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating custom audio:', JSON.stringify(error.response.data));
+      if (error.response.status === 402) {
+        return new NextResponse(JSON.stringify({ error: error.response.data.detail }), {
+          status: 402,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      return new NextResponse(JSON.stringify({ error: 'Internal server error: ' + JSON.stringify(error.response.data.detail) }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'POST',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/generate_lyrics/route.ts

@@ -0,0 +1,57 @@
+import { NextResponse, NextRequest } from "next/server";
+import { sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function POST(req: NextRequest) {
+  if (req.method === 'POST') {
+    try {
+      const body = await req.json();
+      const { prompt } = body;
+
+      const lyrics = await (await sunoApi).generateLyrics(prompt);
+
+      return new NextResponse(JSON.stringify(lyrics), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating lyrics:', JSON.stringify(error.response.data));
+      if (error.response.status === 402) {
+        return new NextResponse(JSON.stringify({ error: error.response.data.detail }), {
+          status: 402,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+      return new NextResponse(JSON.stringify({ error: 'Internal server error: ' + JSON.stringify(error.response.data.detail) }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'POST',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/get/route.ts

@@ -0,0 +1,54 @@
+import { NextResponse, NextRequest } from "next/server";
+import { sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function GET(req: NextRequest) {
+  if (req.method === 'GET') {
+    try {
+      const url = new URL(req.url);
+      const songIds = url.searchParams.get('ids');
+      let audioInfo = [];
+      if (songIds && songIds.length > 0) {
+        const idsArray = songIds.split(',');
+        audioInfo = await (await sunoApi).get(idsArray);
+      } else {
+        audioInfo = await (await sunoApi).get();
+      }
+
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error) {
+      console.error('Error fetching audio:', error);
+
+      return new NextResponse(JSON.stringify({ error: 'Internal server error' }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'GET',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/api/get_limit/route.ts

@@ -0,0 +1,48 @@
+import { NextResponse, NextRequest } from "next/server";
+import { sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+export async function GET(req: NextRequest) {
+  if (req.method === 'GET') {
+    try {
+
+      const limit = await (await sunoApi).get_credits();
+
+
+      return new NextResponse(JSON.stringify(limit), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error) {
+      console.error('Error fetching limit:', error);
+
+      return new NextResponse(JSON.stringify({ error: 'Internal server error. ' + error }), {
+        status: 500,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+  } else {
+    return new NextResponse('Method Not Allowed', {
+      headers: {
+        Allow: 'GET',
+        ...corsHeaders
+      },
+      status: 405
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/app/components/Footer.tsx

@@ -0,0 +1,24 @@
+import Link from "next/link";
+import Image from "next/image";
+
+export default function Footer() {
+    return (
+        <footer className=" flex w-full justify-center py-4 items-center
+        bg-indigo-900 text-white/60 backdrop-blur-2xl font-mono text-sm px-4 lg:px-0
+      ">
+            <p className="px-6 py-3 rounded-full flex justify-center items-center gap-2
+             hover:text-white duration-200
+                ">
+
+            </p>
+            <p className="px-6 py-3 rounded-full flex justify-center items-center gap-2
+             hover:text-white duration-200
+                ">
+                <span>© 2024</span>
+                <Link href="https://github.com/gcui-art/suno-api/">
+                    gcui-art/suno-api
+                </Link>
+            </p>
+        </footer>
+    );
+}

src/app/components/Header.tsx

@@ -0,0 +1,50 @@
+import Link from "next/link";
+import Image from "next/image";
+import Logo from "./Logo";
+
+export default function Header() {
+    return (
+        <nav className=" flex w-full justify-center py-4 items-center 
+        border-b border-gray-300  backdrop-blur-2xl font-mono text-sm px-4 lg:px-0">
+            <div className="max-w-3xl flex w-full items-center justify-between">
+                <div className="font-medium text-xl text-indigo-900 flex items-center gap-2">
+                    <Logo className="w-4 h-4" />
+                    <Link href='/'>
+                        Suno API
+                    </Link>
+                </div>
+                <div className="flex items-center justify-center gap-1 text-sm font-light text-indigo-900/90">
+                    <p className="p-2 lg:px-6 lg:py-3 rounded-full flex justify-center items-center
+                lg:hover:bg-indigo-300 duration-200
+                ">
+                        <Link href="/">
+                            Get Started
+                        </Link>
+                    </p>
+                    <p className="p-2 lg:px-6 lg:py-3 rounded-full flex justify-center items-center
+                lg:hover:bg-indigo-300 duration-200
+                ">
+                        <Link href="/docs">
+                            API Docs
+                        </Link>
+                    </p>
+                    <p className="p-2 lg:px-6 lg:py-3 rounded-full flex justify-center items-center
+                lg:hover:bg-indigo-300 duration-200
+                ">
+                        <a href="https://github.com/gcui-art/suno-api/"
+                            target="_blank"
+                            className="flex items-center justify-center gap-1">
+                            <span className="">
+                                <Image src="/github-mark.png" alt="GitHub Logo" width={20} height={20} />
+                            </span>
+                            <span>Github</span>
+                        </a>
+                    </p>
+                </div>
+
+
+
+            </div>
+        </nav>
+    );
+}

src/app/components/Logo.tsx

@@ -0,0 +1,13 @@
+
+
+export default function Logo({ className = '', ...props }) {
+  return (
+    <span className=" bg-indigo-900 rounded-full p-2">
+      <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" className={className}
+        fill="none" stroke="#ffffff" strokeWidth="1"
+        strokeLinecap="round" strokeLinejoin="round">
+        <path d="M3 14h3a2 2 0 0 1 2 2v3a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-7a9 9 0 0 1 18 0v7a2 2 0 0 1-2 2h-1a2 2 0 0 1-2-2v-3a2 2 0 0 1 2-2h3" />
+      </svg>
+    </span>
+  );
+}

src/app/components/Section.tsx

@@ -0,0 +1,22 @@
+'use client';
+/**
+ * 
+ * @param param0 
+ * @returns 
+ */
+export default function Section({
+    children,
+    className
+}: {
+    children?: React.ReactNode | string,
+    className?: string
+}) {
+
+    return (
+        <section className={`mx-auto w-full px-4 lg:px-0 ${className}`} >
+            <div className=" max-w-3xl mx-auto">
+                {children}
+            </div>
+        </section>
+    );
+};

src/app/components/Swagger.tsx

@@ -0,0 +1,15 @@
+'use client';
+import 'swagger-ui-react/swagger-ui.css';
+import dynamic from "next/dynamic";
+
+type Props = {
+  spec: Record<string, any>,
+};
+
+const SwaggerUI = dynamic(() => import('swagger-ui-react'), { ssr: false });
+
+function Swagger({ spec }: Props) {
+  return <SwaggerUI spec={spec}/>;
+}
+
+export default Swagger;

src/app/docs/page.tsx

@@ -0,0 +1,59 @@
+import React from 'react';
+import Swagger from '../components/Swagger';
+import spec from './swagger-suno-api.json'; // 直接导入JSON文件
+import Section from '../components/Section';
+import Markdown from 'react-markdown';
+
+
+export default function Docs() {
+    return (
+        <>
+            <Section className="my-10">
+                <article className="prose lg:prose-lg max-w-3xl pt-10">
+                    <h1 className=' text-center text-indigo-900'>
+                        API Docs
+                    </h1>
+                    <Markdown>
+                        {`                     
+---
+\`gcui-art/suno-api\` currently mainly implements the following APIs:
+
+\`\`\`bash
+- \`/api/generate\`: Generate music
+- \`/v1/chat/completions\`: Generate music - Call the generate API in a format 
+  that works with OpenAI’s API.
+- \`/api/custom_generate\`: Generate music (Custom Mode, support setting lyrics, 
+  music style, title, etc.)
+- \`/api/generate_lyrics\`: Generate lyrics based on prompt
+- \`/api/get\`: Get music information based on the id. Use “,” to separate multiple 
+    ids.  If no IDs are provided, all music will be returned.
+- \`/api/get_limit\`: Get quota Info
+- \`/api/extend_audio\`: Extend audio length
+- \`/api/clip\`:  Get clip information based on ID passed as query parameter \`id\`
+- \`/api/concat\`: Generate the whole song from extensions
+\`\`\`
+
+Feel free to explore the detailed API parameters and conduct tests on this page.
+                        `}
+                    </Markdown>
+                </article>
+            </Section>
+            <Section className="my-10">
+                <article className='prose lg:prose-lg max-w-3xl py-10'>
+                    <h2 className='text-center'>
+                        Details of the API and testing it online
+                    </h2>
+                    <p className='text-red-800 italic'>
+                        This is just a demo, bound to a test account. Please do not use it frequently, so that more people can test online.
+                    </p>
+                </article>
+
+                <div className=' border p-4 rounded-2xl shadow-xl hover:shadow-none duration-200'>
+                    <Swagger spec={spec} />
+                </div>
+
+            </Section>
+        </>
+
+    );
+}

src/app/docs/swagger-suno-api.json

@@ -0,0 +1,600 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "suno-api",
+    "description": "Use API to call the music generation service of Suno.ai and easily integrate it into agents like GPTs.",
+    "version": "1.1.0"
+  },
+  "tags": [
+    {
+      "name": "default"
+    }
+  ],
+  "paths": {
+    "/api/generate": {
+      "post": {
+        "summary": "Generate audio based on Prompt.",
+        "description": "It will automatically fill in the lyrics.\n\n2 audio files will be generated for each request, consuming a total of 10 credits.\n\n`wait_audio` can be set to API mode:\n\n\u2022 By default, it is set to `false`, which indicates the background mode. It will only return audio task information, and you will need to call the get API to retrieve detailed audio information.\n\n\u2022 If set to `true`, it simulates synchronous mode. The API will wait for a maximum of 100s until the audio is generated, and will directly return the audio link and other information. Recommend using in GPTs and other agents.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt", "make_instrumental", "wait_audio"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Prompt",
+                    "example": "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war."
+                  },
+                  "make_instrumental": {
+                    "type": "boolean",
+                    "description": "Whether to generate instrumental music",
+                    "example": "false"
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  },
+                  "wait_audio": {
+                    "type": "boolean",
+                    "description": "Whether to wait for music generation, default is false, directly return audio task information; set to true, will wait for up to 100s until the audio is generated.",
+                    "example": "false"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["0", "1"],
+                    "properties": [
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      },
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/chat/completions": {
+      "post": {
+        "summary": "Generate audio based on Prompt - OpenAI API format compatibility.",
+        "description": "Convert the `/api/generate` API to be compatible with the OpenAI `/v1/chat/completions` API format. \n\nGenerally used in OpenAI compatible clients.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Prompt",
+                    "example": "A popular heavy metal song about war, sung by a deep-voiced male singer, slowly and melodiously. The lyrics depict the sorrow of people after the war."
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "string",
+                      "description": "Text description for music, with details like title, album cover, lyrics, and more."
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/custom_generate": {
+      "post": {
+        "summary": "Generate Audio - Custom Mode",
+        "description": "The custom mode enables users to provide additional details about the music, such as music genre, lyrics, and more.\n\n 2 audio files will be generated for each request, consuming a total of 10 credits. \n\n `wait_audio` can be set to API mode:\n\n\u2022 By default, it is set to false, which indicates the background mode. It will only return audio task information, and you will need to call the get API to retrieve detailed audio information.\n\n\u2022 If set to true, it simulates synchronous mode. The API will wait for a maximum of 100s until the audio is generated, and will directly return the audio link and other information. Recommend using in GPTs and other agents.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt", "tags", "title"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Detailed prompt, including information such as music lyrics.",
+                    "example": "[Verse 1]\nCruel flames of war engulf this land\nBattlefields filled with death and dread\nInnocent souls in darkness, they rest\nMy heart trembles in this silent test\n\n[Verse 2]\nPeople weep for loved ones lost\nBattered bodies bear the cost\nSeeking peace and hope once known\nOur grief transforms to hearts of stone\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Bridge]\nThrough the ashes, we will rise\nHand in hand, towards peaceful skies\nNo more sorrow, no more pain\nTogether, we'll break these chains\n\n[Chorus]\nSilent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n\n[Outro]\nIn unity, our strength will grow\nA brighter future, we'll soon know\nFrom the ruins, hope will spring\nA new dawn, we'll together bring"
+                  },
+                  "tags": {
+                    "type": "string",
+                    "description": "Music genre",
+                    "example": "pop metal male melancholic"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Music title",
+                    "example": "Silent Battlefield"
+                  },
+                  "make_instrumental": {
+                    "type": "boolean",
+                    "description": "Whether to generate instrumental music",
+                    "example": "false"
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  },
+                  "wait_audio": {
+                    "type": "boolean",
+                    "description": "Whether to wait for music generation, default is false, directly return audio task information; set to true, will wait for up to 100s until the audio is generated.",
+                    "example": "false"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["0", "1"],
+                    "properties": [
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      },
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/extend_audio": {
+      "post": {
+        "summary": "Extend audio length.",
+        "description": "Extend audio length.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["audio_id"],
+                "properties": {
+                  "audio_id": {
+                    "type": "string",
+                    "description": "The ID of the audio clip to extend.",
+                    "example": "e76498dc-6ab4-4a10-a19f-8a095790e28d"
+                  },
+                  "prompt": {
+                    "type": "string",
+                    "description": "Detailed prompt, including information such as music lyrics.",
+                    "example": "[lrc]Silent battlegrounds, no birds' song\nShadows of war, where we don't belong\nMay flowers of peace bloom in this place\nLet's guard this precious dream with grace\n[endlrc]"
+                  },
+                  "continue_at": {
+                    "type": "string",
+                    "description": "Extend a new clip from a song at mm:ss(e.g. 00:30). Default extends from the end of the song.",
+                    "example": "109.96"
+                  },
+                  "title": {
+                    "type": "string",
+                    "description": "Music title",
+                    "example": ""
+                  },
+                  "tags": {
+                    "type": "string",
+                    "description": "Music genre",
+                    "example": ""
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/generate_lyrics": {
+      "post": {
+        "summary": "Generate lyrics based on Prompt.",
+        "description": "Generate lyrics based on Prompt.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["prompt"],
+                "properties": {
+                  "prompt": {
+                    "type": "string",
+                    "description": "Prompt",
+                    "example": "A soothing lullaby"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "text": {
+                      "type": "string",
+                      "description": "Lyrics"
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "music title"
+                    },
+                    "status": {
+                      "type": "string",
+                      "description": "Status"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/get": {
+      "get": {
+        "summary": "Get audio information",
+        "description": "",
+        "tags": ["default"],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "ids",
+            "description": "Audio IDs, separated by commas. Leave blank to return a list of all music.",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["0", "1"],
+                    "properties": [
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      },
+                      {
+                        "$ref": "#/components/schemas/audio_info"
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/get_limit": {
+      "get": {
+        "summary": "Get quota information.",
+        "description": "",
+        "tags": ["default"],
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "credits_left",
+                    "period",
+                    "monthly_limit",
+                    "monthly_usage"
+                  ],
+                  "properties": {
+                    "credits_left": {
+                      "type": "number",
+                      "description": "Remaining credits,Each generated audio consumes 5 credits."
+                    },
+                    "period": {
+                      "type": "string",
+                      "description": "Period"
+                    },
+                    "monthly_limit": {
+                      "type": "number",
+                      "description": "Monthly limit"
+                    },
+                    "monthly_usage": {
+                      "type": "number",
+                      "description": "Monthly usage"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/clip": {
+      "get": {
+        "summary": "Get clip information based on ID.",
+        "description": "Retrieve specific clip information using the provided clip ID as a query parameter.",
+        "tags": ["default"],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "query",
+            "required": true,
+            "description": "Clip ID",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/audio_info"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Missing parameter id",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Missing parameter id"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Internal server error"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/concat": {
+      "post": {
+        "summary": "Generate the whole song from extensions.",
+        "description": "Concatenate audio clips to generate a complete song using the provided clip ID.",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["clip_id"],
+                "properties": {
+                  "clip_id": {
+                    "type": "string",
+                    "description": "Clip ID"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/audio_info"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Clip id is required",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Clip id is required"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "402": {
+            "description": "Payment required",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Payment required"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Internal server error"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "audio_info": {
+        "type": "object",
+        "required": [
+          "id",
+          "title",
+          "image_url",
+          "lyric",
+          "audio_url",
+          "video_url",
+          "created_at",
+          "model_name",
+          "status",
+          "gpt_description_prompt",
+          "prompt",
+          "type",
+          "tags"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "audio id"
+          },
+          "title": {
+            "type": "string",
+            "description": "music title"
+          },
+          "image_url": {
+            "type": "string",
+            "description": "music cover image"
+          },
+          "lyric": {
+            "type": "string",
+            "description": "music lyric"
+          },
+          "audio_url": {
+            "type": "string",
+            "description": "music download url"
+          },
+          "video_url": {
+            "type": "string",
+            "description": "Music video download link, can be used to share"
+          },
+          "created_at": {
+            "type": "string",
+            "description": "Create time"
+          },
+          "model_name": {
+            "type": "string",
+            "description": "suno model name, chirp-v3"
+          },
+          "status": {
+            "type": "string",
+            "description": "The generated states include submitted, queue, streaming, complete."
+          },
+          "gpt_description_prompt": {
+            "type": "string",
+            "description": "Simple mode on user input prompt, Suno will generate formal prompts, lyrics, etc."
+          },
+          "prompt": {
+            "type": "string",
+            "description": "The final prompt for executing the generation task, customized by the user in custom mode, automatically generated by Suno in simple mode."
+          },
+          "type": {
+            "type": "string",
+            "description": "Type"
+          },
+          "tags": {
+            "type": "string",
+            "description": "Music genre. User-provided in custom mode, automatically generated by Suno in simple mode."
+          }
+        },
+        "title": "audio_info",
+        "description": "Audio Info"
+      }
+    }
+  }
+}

src/app/globals.css

@@ -0,0 +1,25 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  --foreground-rgb: 0, 0, 0;
+  --background-start-rgb: 255, 255, 255;
+  --background-end-rgb: 255, 255, 255;
+}
+
+body {
+  color: rgb(var(--foreground-rgb));
+  background: linear-gradient(
+      to bottom,
+      transparent,
+      rgb(var(--background-end-rgb))
+    )
+    rgb(var(--background-start-rgb));
+}
+
+@layer utilities {
+  .text-balance {
+    text-wrap: balance;
+  }
+}

src/app/layout.tsx

@@ -0,0 +1,34 @@
+import type { Metadata } from "next";
+import { Inter } from "next/font/google";
+import "./globals.css";
+import Header from "./components/Header";
+import Footer from "./components/Footer";
+import { Analytics } from "@vercel/analytics/react"
+
+const inter = Inter({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "suno api",
+  description: "Use API to call the music generation ai of suno.ai",
+  keywords: ["suno", "suno api", "suno.ai", "api", "music", "generation", "ai"],
+  creator: "@gcui.ai",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={`${inter.className} overflow-y-scroll`} >
+        <Header />
+        <main className="flex flex-col items-center m-auto w-full">
+          {children}
+        </main>
+        <Footer />
+        <Analytics />
+      </body>
+    </html>
+  );
+}

src/app/page.tsx

@@ -0,0 +1,154 @@
+import Section from "./components/Section";
+import Markdown from 'react-markdown';
+
+
+export default function Home() {
+
+  const markdown = `
+
+---
+## 👋 Introduction
+
+Suno.ai v3 is an amazing AI music service. Although the official API is not yet available, we couldn't wait to integrate its capabilities somewhere.
+
+We discovered that some users have similar needs, so we decided to open-source this project, hoping you'll like it.
+
+We update quickly, please star us on Github:  [github.com/gcui-art/suno-api](https://github.com/gcui-art/suno-api) ⭐
+
+## 🌟 Features
+
+- Perfectly implements the creation API from \`app.suno.ai\`
+- Compatible with the format of OpenAI’s \`/v1/chat/completions\` API.
+- Automatically keep the account active.
+- Supports \`Custom Mode\`
+- One-click deployment to Vercel
+- In addition to the standard API, it also adapts to the API Schema of Agent platforms like GPTs and Coze, so you can use it as a tool/plugin/Action for LLMs and integrate it into any AI Agent.
+- Permissive open-source license, allowing you to freely integrate and modify.
+
+## 🚀 Getting Started
+
+### 1. Obtain the cookie of your app.suno.ai account
+
+1. Head over to [app.suno.ai](https://app.suno.ai) using your browser.
+2. Open up the browser console: hit \`F12\` or access the \`Developer Tools\`.
+3. Navigate to the \`Network tab\`.
+4. Give the page a quick refresh.
+5. Identify the request that includes the keyword \`client?_clerk_js_version\`.
+6. Click on it and switch over to the \`Header\` tab.
+7. Locate the \`Cookie\` section, hover your mouse over it, and copy the value of the Cookie.
+`;
+
+
+  const markdown_part2 = `
+### 2. Clone and deploy this project
+
+You can choose your preferred deployment method:
+
+#### Deploy to Vercel
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgcui-art%2Fsuno-api&env=SUNO_COOKIE&project-name=suno-api&repository-name=suno-api)
+
+#### Run locally
+
+\`\`\`bash
+git clone https://github.com/gcui-art/suno-api.git
+cd suno-api
+npm install
+\`\`\`
+
+### 3. Configure suno-api
+
+- If deployed to Vercel, please add an environment variable \`SUNO_COOKIE\` in the Vercel dashboard, with the value of the cookie obtained in the first step.
+
+- If you’re running this locally, be sure to add the following to your \`.env\` file:
+
+  \`\`\`bash
+  SUNO_COOKIE=<your-cookie>
+  \`\`\`
+
+### 4. Run suno-api
+
+- If you’ve deployed to Vercel:
+  - Please click on Deploy in the Vercel dashboard and wait for the deployment to be successful.
+  - Visit the \`https://<vercel-assigned-domain>/api/get_limit\` API for testing.
+- If running locally:
+  - Run \`npm run dev\`.
+  - Visit the \`http://localhost:3000/api/get_limit\` API for testing.
+- If the following result is returned:
+
+  \`\`\`json
+  {
+    "credits_left": 50,
+    "period": "day",
+    "monthly_limit": 50,
+    "monthly_usage": 50
+  }
+  \`\`\`
+
+it means the program is running normally.
+
+### 5. Use Suno API
+
+You can check out the detailed API documentation at [suno.gcui.ai/docs](https://suno.gcui.ai/docs).
+
+## 📚 API Reference
+
+Suno API currently mainly implements the following APIs:
+
+\`\`\`bash
+- \`/api/generate\`: Generate music
+- \`/v1/chat/completions\`: Generate music - Call the generate API in a format 
+  that works with OpenAI’s API.
+- \`/api/custom_generate\`: Generate music (Custom Mode, support setting lyrics, 
+  music style, title, etc.)
+- \`/api/generate_lyrics\`: Generate lyrics based on prompt
+- \`/api/get\`: Get music list
+- \`/api/get?ids=\`: Get music Info by id, separate multiple id with ",".
+- \`/api/get_limit\`: Get quota Info
+- \`/api/extend_audio\`: Extend audio length
+- \`/api/concat\`: Generate the whole song from extensions
+\`\`\`
+
+For more detailed documentation, please check out the demo site:
+
+👉 [suno.gcui.ai/docs](https://suno.gcui.ai/docs)
+
+`;
+  return (
+    <>
+      <Section className="">
+        <div className="flex flex-col m-auto py-20 text-center items-center justify-center gap-4 my-8
+        lg:px-20 px-4
+        bg-indigo-900/90 rounded-2xl border shadow-2xl hover:shadow-none duration-200">
+          <span className=" px-5 py-1 text-xs font-light border rounded-full 
+          border-white/20 uppercase text-white/50">
+            Unofficial
+          </span>
+          <h1 className="font-bold text-7xl flex text-white/90">
+            Suno AI API
+          </h1>
+          <p className="text-white/80 text-lg">
+            `Suno-api` is an open-source project that enables you to set up your own Suno AI API.
+          </p>
+        </div>
+
+      </Section>
+      <Section className="my-10">
+        <article className="prose lg:prose-lg max-w-3xl">
+          <Markdown>
+            {markdown}
+          </Markdown>
+          <video controls width="1024" className="w-full border rounded-lg shadow-xl">
+            <source src="/get-cookie-demo.mp4" type="video/mp4" />
+            Your browser does not support frames.
+          </video>
+          <Markdown>
+            {markdown_part2}
+          </Markdown>
+        </article>
+      </Section>
+
+
+    </>
+  );
+}

src/app/v1/chat/completions/route.ts

@@ -0,0 +1,61 @@
+import { NextResponse, NextRequest } from "next/server";
+import { DEFAULT_MODEL, sunoApi } from "@/lib/SunoApi";
+import { corsHeaders } from "@/lib/utils";
+
+export const dynamic = "force-dynamic";
+
+/**
+ * desc
+ *
+ */
+export async function POST(req: NextRequest) {
+  try {
+
+    const body = await req.json();
+
+    let userMessage = null;
+    const { messages } = body;
+    for (let message of messages) {
+      if (message.role == 'user') {
+        userMessage = message;
+      }
+    }
+
+    if (!userMessage) {
+      return new NextResponse(JSON.stringify({ error: 'Prompt message is required' }), {
+        status: 400,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    }
+
+
+    const audioInfo = await (await sunoApi).generate(userMessage.content, true, DEFAULT_MODEL, true);
+
+    const audio = audioInfo[0]
+    const data = `## Song Title: ${audio.title}\n![Song Cover](${audio.image_url})\n### Lyrics:\n${audio.lyric}\n### Listen to the song: ${audio.audio_url}`
+
+    return new NextResponse(data, {
+      status: 200,
+      headers: corsHeaders
+    });
+  } catch (error: any) {
+    console.error('Error generating audio:', JSON.stringify(error.response.data));
+    return new NextResponse(JSON.stringify({ error: 'Internal server error: ' + JSON.stringify(error.response.data.detail) }), {
+      status: 500,
+      headers: {
+        'Content-Type': 'application/json',
+        ...corsHeaders
+      }
+    });
+  }
+}
+
+export async function OPTIONS(request: Request) {
+  return new Response(null, {
+    status: 200,
+    headers: corsHeaders
+  });
+}

src/lib/SunoApi.ts

@@ -0,0 +1,407 @@
+import axios, { AxiosInstance } from 'axios';
+import UserAgent from 'user-agents';
+import pino from 'pino';
+import { wrapper } from "axios-cookiejar-support";
+import { CookieJar } from "tough-cookie";
+import { sleep } from "@/lib/utils";
+
+const logger = pino();
+export const DEFAULT_MODEL = "chirp-v3-5";
+
+
+export interface AudioInfo {
+  id: string; // Unique identifier for the audio
+  title?: string; // Title of the audio
+  image_url?: string; // URL of the image associated with the audio
+  lyric?: string; // Lyrics of the audio
+  audio_url?: string; // URL of the audio file
+  video_url?: string; // URL of the video associated with the audio
+  created_at: string; // Date and time when the audio was created
+  model_name: string; // Name of the model used for audio generation
+  gpt_description_prompt?: string; // Prompt for GPT description
+  prompt?: string; // Prompt for audio generation 
+  status: string; // Status
+  type?: string;
+  tags?: string; // Genre of music.
+  duration?: string; // Duration of the audio
+  error_message?: string; // Error message if any
+}
+
+class SunoApi {
+  private static BASE_URL: string = 'https://studio-api.suno.ai';
+  private static CLERK_BASE_URL: string = 'https://clerk.suno.com';
+
+  private readonly client: AxiosInstance;
+  private sid?: string;
+  private currentToken?: string;
+
+  constructor(cookie: string) {
+    const cookieJar = new CookieJar();
+    const randomUserAgent = new UserAgent(/Chrome/).random().toString();
+    this.client = wrapper(axios.create({
+      jar: cookieJar,
+      withCredentials: true,
+      headers: {
+        'User-Agent': randomUserAgent,
+        'Cookie': cookie
+      }
+    }))
+    this.client.interceptors.request.use((config) => {
+      if (this.currentToken) { // Use the current token status
+        config.headers['Authorization'] = `Bearer ${this.currentToken}`;
+      }
+      return config;
+    });
+  }
+
+  public async init(): Promise<SunoApi> {
+    await this.getAuthToken();
+    await this.keepAlive();
+    return this;
+  }
+
+  /**
+   * Get the session ID and save it for later use.
+   */
+  private async getAuthToken() {
+    // URL to get session ID
+    const getSessionUrl = `${SunoApi.CLERK_BASE_URL}/v1/client?_clerk_js_version=4.73.4`; 
+    // Get session ID
+    const sessionResponse = await this.client.get(getSessionUrl);
+    if (!sessionResponse?.data?.response?.['last_active_session_id']) {
+      throw new Error("Failed to get session id, you may need to update the SUNO_COOKIE");
+    }
+    // Save session ID for later use
+    this.sid = sessionResponse.data.response['last_active_session_id'];
+  }
+
+  /**
+   * Keep the session alive.
+   * @param isWait Indicates if the method should wait for the session to be fully renewed before returning.
+   */
+  public async keepAlive(isWait?: boolean): Promise<void> {
+    if (!this.sid) {
+      throw new Error("Session ID is not set. Cannot renew token.");
+    }
+    // URL to renew session token
+    const renewUrl = `${SunoApi.CLERK_BASE_URL}/v1/client/sessions/${this.sid}/tokens?_clerk_js_version==4.73.4`; 
+    // Renew session token
+    const renewResponse = await this.client.post(renewUrl);
+    logger.info("KeepAlive...\n");
+    if (isWait) {
+      await sleep(1, 2);
+    }
+    const newToken = renewResponse.data['jwt'];
+    // Update Authorization field in request header with the new JWT token
+    this.currentToken = newToken;
+  }
+
+  /**
+   * Generate a song based on the prompt.
+   * @param prompt The text prompt to generate audio from.
+   * @param make_instrumental Indicates if the generated audio should be instrumental.
+   * @param wait_audio Indicates if the method should wait for the audio file to be fully generated before returning.
+   * @returns 
+   */
+  public async generate(
+    prompt: string,
+    make_instrumental: boolean = false,
+    model?: string,
+    wait_audio: boolean = false,
+
+  ): Promise<AudioInfo[]> {
+    await this.keepAlive(false);
+    const startTime = Date.now();
+    const audios = this.generateSongs(prompt, false, undefined, undefined, make_instrumental, model, wait_audio);
+    const costTime = Date.now() - startTime;
+    logger.info("Generate Response:\n" + JSON.stringify(audios, null, 2));
+    logger.info("Cost time: " + costTime);
+    return audios;
+  }
+
+  /**
+   * Calls the concatenate endpoint for a clip to generate the whole song.
+   * @param clip_id The ID of the audio clip to concatenate.
+   * @returns A promise that resolves to an AudioInfo object representing the concatenated audio.
+   * @throws Error if the response status is not 200.
+   */
+  public async concatenate(clip_id: string): Promise<AudioInfo> {
+    await this.keepAlive(false);
+    const payload: any = { clip_id: clip_id };
+
+    const response = await this.client.post(
+      `${SunoApi.BASE_URL}/api/generate/concat/v2/`,
+      payload,
+      {
+        timeout: 10000, // 10 seconds timeout
+      },
+    );
+    if (response.status !== 200) {
+      throw new Error("Error response:" + response.statusText);
+    }
+    return response.data;
+  }
+
+  /**
+   * Generates custom audio based on provided parameters.
+   *
+   * @param prompt The text prompt to generate audio from.
+   * @param tags Tags to categorize the generated audio.
+   * @param title The title for the generated audio.
+   * @param make_instrumental Indicates if the generated audio should be instrumental.
+   * @param wait_audio Indicates if the method should wait for the audio file to be fully generated before returning.
+   * @returns A promise that resolves to an array of AudioInfo objects representing the generated audios.
+   */
+  public async custom_generate(
+    prompt: string,
+    tags: string,
+    title: string,
+    make_instrumental: boolean = false,
+    model?: string,
+    wait_audio: boolean = false,
+  ): Promise<AudioInfo[]> {
+    const startTime = Date.now();
+    const audios = await this.generateSongs(prompt, true, tags, title, make_instrumental, model, wait_audio);
+    const costTime = Date.now() - startTime;
+    logger.info("Custom Generate Response:\n" + JSON.stringify(audios, null, 2));
+    logger.info("Cost time: " + costTime);
+    return audios;
+  }
+
+  /**
+   * Generates songs based on the provided parameters.
+   *
+   * @param prompt The text prompt to generate songs from.
+   * @param isCustom Indicates if the generation should consider custom parameters like tags and title.
+   * @param tags Optional tags to categorize the song, used only if isCustom is true.
+   * @param title Optional title for the song, used only if isCustom is true.
+   * @param make_instrumental Indicates if the generated song should be instrumental.
+   * @param wait_audio Indicates if the method should wait for the audio file to be fully generated before returning.
+   * @returns A promise that resolves to an array of AudioInfo objects representing the generated songs.
+   */
+  private async generateSongs(
+    prompt: string,
+    isCustom: boolean,
+    tags?: string,
+    title?: string,
+    make_instrumental?: boolean,
+    model?: string,
+    wait_audio: boolean = false
+  ): Promise<AudioInfo[]> {
+    await this.keepAlive(false);
+    const payload: any = {
+      make_instrumental: make_instrumental == true,
+      mv: model || DEFAULT_MODEL,
+      prompt: "",
+    };
+    if (isCustom) {
+      payload.tags = tags;
+      payload.title = title;
+      payload.prompt = prompt;
+    } else {
+      payload.gpt_description_prompt = prompt;
+    }
+    logger.info("generateSongs payload:\n" + JSON.stringify({
+      prompt: prompt,
+      isCustom: isCustom,
+      tags: tags,
+      title: title,
+      make_instrumental: make_instrumental,
+      wait_audio: wait_audio,
+      payload: payload,
+    }, null, 2));
+    const response = await this.client.post(
+      `${SunoApi.BASE_URL}/api/generate/v2/`,
+      payload,
+      {
+        timeout: 10000, // 10 seconds timeout
+      },
+    );
+    logger.info("generateSongs Response:\n" + JSON.stringify(response.data, null, 2));
+    if (response.status !== 200) {
+      throw new Error("Error response:" + response.statusText);
+    }
+    const songIds = response.data['clips'].map((audio: any) => audio.id);
+    //Want to wait for music file generation
+    if (wait_audio) {
+      const startTime = Date.now();
+      let lastResponse: AudioInfo[] = [];
+      await sleep(5, 5);
+      while (Date.now() - startTime < 100000) {
+        const response = await this.get(songIds);
+        const allCompleted = response.every(
+          audio => audio.status === 'streaming' || audio.status === 'complete'
+        );
+        const allError = response.every(
+          audio => audio.status === 'error'
+        );
+        if (allCompleted || allError) {
+          return response;
+        }
+        lastResponse = response;
+        await sleep(3, 6);
+        await this.keepAlive(true);
+      }
+      return lastResponse;
+    } else {
+      await this.keepAlive(true);
+      return response.data['clips'].map((audio: any) => ({
+        id: audio.id,
+        title: audio.title,
+        image_url: audio.image_url,
+        lyric: audio.metadata.prompt,
+        audio_url: audio.audio_url,
+        video_url: audio.video_url,
+        created_at: audio.created_at,
+        model_name: audio.model_name,
+        status: audio.status,
+        gpt_description_prompt: audio.metadata.gpt_description_prompt,
+        prompt: audio.metadata.prompt,
+        type: audio.metadata.type,
+        tags: audio.metadata.tags,
+        duration: audio.metadata.duration,
+      }));
+    }
+  }
+
+  /**
+   * Generates lyrics based on a given prompt.
+   * @param prompt The prompt for generating lyrics.
+   * @returns The generated lyrics text.
+   */
+  public async generateLyrics(prompt: string): Promise<string> {
+    await this.keepAlive(false);
+    // Initiate lyrics generation
+    const generateResponse = await this.client.post(`${SunoApi.BASE_URL}/api/generate/lyrics/`, { prompt });
+    const generateId = generateResponse.data.id;
+
+    // Poll for lyrics completion
+    let lyricsResponse = await this.client.get(`${SunoApi.BASE_URL}/api/generate/lyrics/${generateId}`);
+    while (lyricsResponse?.data?.status !== 'complete') {
+      await sleep(2); // Wait for 2 seconds before polling again
+      lyricsResponse = await this.client.get(`${SunoApi.BASE_URL}/api/generate/lyrics/${generateId}`);
+    }
+
+    // Return the generated lyrics text
+    return lyricsResponse.data;
+  }
+
+  /**
+   * Extends an existing audio clip by generating additional content based on the provided prompt.
+   * 
+   * @param audioId The ID of the audio clip to extend.
+   * @param prompt The prompt for generating additional content.
+   * @param continueAt Extend a new clip from a song at mm:ss(e.g. 00:30). Default extends from the end of the song.
+   * @param tags Style of Music.
+   * @param title Title of the song.
+   * @returns A promise that resolves to an AudioInfo object representing the extended audio clip.
+   */
+  public async extendAudio(
+    audioId: string,
+    prompt: string = "",
+    continueAt: string = "0",
+    tags: string = "",
+    title: string = "",
+    model?: string,
+  ): Promise<AudioInfo> {
+    const response = await this.client.post(`${SunoApi.BASE_URL}/api/generate/v2/`, {
+      continue_clip_id: audioId,
+      continue_at: continueAt,
+      mv: model || DEFAULT_MODEL,
+      prompt: prompt,
+      tags: tags,
+      title: title
+    });
+    console.log("response：\n", response);
+    return response.data;
+  }
+
+  /**
+   * Processes the lyrics (prompt) from the audio metadata into a more readable format.
+   * @param prompt The original lyrics text.
+   * @returns The processed lyrics text.
+   */
+  private parseLyrics(prompt: string): string {
+    // Assuming the original lyrics are separated by a specific delimiter (e.g., newline), we can convert it into a more readable format.
+    // The implementation here can be adjusted according to the actual lyrics format.
+    // For example, if the lyrics exist as continuous text, it might be necessary to split them based on specific markers (such as periods, commas, etc.).
+    // The following implementation assumes that the lyrics are already separated by newlines.
+
+    // Split the lyrics using newline and ensure to remove empty lines.
+    const lines = prompt.split('\n').filter(line => line.trim() !== '');
+
+    // Reassemble the processed lyrics lines into a single string, separated by newlines between each line.
+    // Additional formatting logic can be added here, such as adding specific markers or handling special lines.
+    return lines.join('\n');
+  }
+
+  /**
+   * Retrieves audio information for the given song IDs.
+   * @param songIds An optional array of song IDs to retrieve information for.
+   * @returns A promise that resolves to an array of AudioInfo objects.
+   */
+  public async get(songIds?: string[]): Promise<AudioInfo[]> {
+    await this.keepAlive(false);
+    let url = `${SunoApi.BASE_URL}/api/feed/`;
+    if (songIds) {
+      url = `${url}?ids=${songIds.join(',')}`;
+    }
+    logger.info("Get audio status: " + url);
+    const response = await this.client.get(url, {
+      // 3 seconds timeout
+      timeout: 3000
+    });
+
+    const audios = response.data;
+    return audios.map((audio: any) => ({
+      id: audio.id,
+      title: audio.title,
+      image_url: audio.image_url,
+      lyric: audio.metadata.prompt ? this.parseLyrics(audio.metadata.prompt) : "",
+      audio_url: audio.audio_url,
+      video_url: audio.video_url,
+      created_at: audio.created_at,
+      model_name: audio.model_name,
+      status: audio.status,
+      gpt_description_prompt: audio.metadata.gpt_description_prompt,
+      prompt: audio.metadata.prompt,
+      type: audio.metadata.type,
+      tags: audio.metadata.tags,
+      duration: audio.metadata.duration,  
+      error_message: audio.metadata.error_message,
+    }));
+  }
+
+  /**
+   * Retrieves information for a specific audio clip.
+   * @param clipId The ID of the audio clip to retrieve information for.
+   * @returns A promise that resolves to an object containing the audio clip information.
+   */
+  public async getClip(clipId: string): Promise<object> {
+    await this.keepAlive(false);
+    const response = await this.client.get(`${SunoApi.BASE_URL}/api/clip/${clipId}`);
+    return response.data;
+  }
+
+  public async get_credits(): Promise<object> {
+    await this.keepAlive(false);
+    const response = await this.client.get(`${SunoApi.BASE_URL}/api/billing/info/`);
+    return {
+      credits_left: response.data.total_credits_left,
+      period: response.data.period,
+      monthly_limit: response.data.monthly_limit,
+      monthly_usage: response.data.monthly_usage,
+    };
+  }
+}
+
+const newSunoApi = async (cookie: string) => {
+  const sunoApi = new SunoApi(cookie);
+  return await sunoApi.init();
+}
+
+if (!process.env.SUNO_COOKIE) {
+  console.log("Environment does not contain SUNO_COOKIE.", process.env)
+}
+
+export const sunoApi = newSunoApi(process.env.SUNO_COOKIE || '');

src/lib/utils.ts

@@ -0,0 +1,28 @@
+import pino from "pino";
+
+const logger = pino();
+
+/**
+ * Pause for a specified number of seconds.
+ * @param x Minimum number of seconds.
+ * @param y Maximum number of seconds (optional).
+ */
+export const sleep = (x: number, y?: number): Promise<void> => {
+  let timeout = x * 1000;
+  if (y !== undefined && y !== x) {
+    const min = Math.min(x, y);
+    const max = Math.max(x, y);
+    timeout = Math.floor(Math.random() * (max - min + 1) + min) * 1000;
+  }
+  // console.log(`Sleeping for ${timeout / 1000} seconds`);
+  logger.info(`Sleeping for ${timeout / 1000} seconds`);
+
+  return new Promise(resolve => setTimeout(resolve, timeout));
+}
+
+
+export const corsHeaders = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+}

tailwind.config.ts

@@ -0,0 +1,22 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  content: [
+    "./src/pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./src/app/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+    extend: {
+      backgroundImage: {
+        "gradient-radial": "radial-gradient(var(--tw-gradient-stops))",
+        "gradient-conic":
+          "conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))",
+      },
+    },
+  },
+  plugins: [
+    require('@tailwindcss/typography'),
+  ],
+};
+export default config;