Upload 49 files

.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,7 @@
+# For more information, please see the README.md
+SUNO_COOKIE=
+TWOCAPTCHA_KEY= # Obtain from 2captcha.com
+BROWSER=chromium # `chromium` or `firefox`, although `chromium` is highly recommended
+BROWSER_GHOST_CURSOR=false
+BROWSER_LOCALE=en
+BROWSER_HEADLESS=true

.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

.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

.prettierrc

@@ -0,0 +1,4 @@
+{
+  "trailingComma": "none",
+  "singleQuote": true
+}

Dockerfile

@@ -0,0 +1,32 @@
+# syntax=docker/dockerfile:1 
+                                                                                                                                                                                                    
+FROM node:lts-bookworm AS builder                                                                                       
+WORKDIR /src                                                                                                            
+COPY package*.json ./                                                                                                   
+RUN npm install                                                                                                         
+COPY . .                                                                                                               
+RUN npm run build                                                                                                       
+                                                                                                                    
+FROM node:lts-bookworm                                                                                                  
+WORKDIR /app                                                                                                            
+COPY package*.json ./                                                                                                   
+                                                                                                                    
+RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y libnss3 \                                       
+    libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 \                       
+    libgbm1 libxkbcommon0 libasound2 libcups2 xvfb                                                                      
+                                                                                                                    
+ARG SUNO_COOKIE             
+RUN if [ -z "$SUNO_COOKIE" ]; then echo "Warning: SUNO_COOKIE is not set. You will have to set the cookies in the Cookie header of your requests."; fi                                           
+ENV SUNO_COOKIE=${SUNO_COOKIE}
+# Disable GPU acceleration, as with it suno-api won't work in a Docker environment
+ENV BROWSER_DISABLE_GPU=true
+
+RUN npm install --only=production                                                                                       
+                                                                                                                    
+# Install all supported browsers, else switching browsers requires an image rebuild                                     
+RUN npx playwright install chromium                                                                                     
+# RUN npx playwright install firefox                                                                                     
+                                                                                                                    
+COPY --from=builder /src/.next ./.next                                                                                  
+EXPOSE 3000                                                                                                             
+CMD ["npm", "run", "start"]

README.md

@@ -1,11 +1,11 @@
----
-title: N M Api
-emoji: 🏃
-colorFrom: gray
-colorTo: yellow
-sdk: docker
-pinned: false
-license: mit
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: N M Api
+emoji: 🏃
+colorFrom: gray
+colorTo: yellow
+sdk: docker
+pinned: false
+license: mit
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

docker-compose.yml

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

next.config.mjs

@@ -0,0 +1,15 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  webpack: (config) => {
+    config.module.rules.push({
+      test: /\.(ttf|html)$/i,
+      type: 'asset/resource'
+    });
+    return config;
+  },
+  experimental: {
+    serverMinification: false, // the server minification unfortunately breaks the selector class names
+  },
+};  
+
+export default nextConfig;

package.json

@@ -0,0 +1,58 @@
+{
+  "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": {
+    "@2captcha/captcha-solver": "^1.3.0",
+    "@playwright/browser-chromium": "^1.49.1",
+    "@vercel/analytics": "^1.2.2",
+    "axios": "^1.7.8",
+    "bufferutil": "^4.0.8",
+    "chromium-bidi": "^0.10.1",
+    "cookie": "^1.0.2",
+    "electron": "^33.2.1",
+    "ghost-cursor-playwright": "^2.1.0",
+    "js-cookie": "^3.0.5",
+    "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",
+    "rebrowser-playwright-core": "^1.49.1",
+    "swagger-ui-react": "^5.18.2",
+    "tough-cookie": "^4.1.4",
+    "user-agents": "^1.1.156",
+    "utf-8-validate": "^6.0.5",
+    "yn": "^5.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/typography": "^0.5.12",
+    "@types/js-cookie": "^3.0.6",
+    "@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,65 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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((await cookies()).toString())).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,54 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers';
+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, negative_tags } = body;
+      const audioInfo = await (await sunoApi((await cookies()).toString())).custom_generate(
+        prompt, tags, title,
+        Boolean(make_instrumental),
+        model || DEFAULT_MODEL,
+        Boolean(wait_audio),
+        negative_tags
+      );
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating custom audio:', error);
+      return new NextResponse(JSON.stringify({ error: error.response?.data?.detail || error.toString() }), {
+        status: error.response?.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,70 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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, negative_tags, title, model, wait_audio } = 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((await cookies()).toString()))
+        .extendAudio(audio_id, prompt, continue_at, tags || '', negative_tags || '', title, model || DEFAULT_MODEL, wait_audio || false);
+
+      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,64 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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((await cookies()).toString())).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,58 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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((await cookies()).toString())).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/generate_stems/route.ts

@@ -0,0 +1,70 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers';
+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 } = 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((await cookies()).toString()))
+        .generateStems(audio_id);
+
+      return new NextResponse(JSON.stringify(audioInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error: any) {
+      console.error('Error generating stems:', 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,61 @@
+import { NextResponse, NextRequest } from 'next/server';
+import { cookies } from 'next/headers';
+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');
+      const page = url.searchParams.get('page');
+      const cookie = (await cookies()).toString();
+
+      let audioInfo = [];
+      if (songIds && songIds.length > 0) {
+        const idsArray = songIds.split(',');
+        audioInfo = await (await sunoApi(cookie)).get(idsArray, page);
+      } else {
+        audioInfo = await (await sunoApi(cookie)).get(undefined, page);
+      }
+
+      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_aligned_lyrics/route.ts

@@ -0,0 +1,61 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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 song_id = url.searchParams.get('song_id');
+
+      if (!song_id) {
+        return new NextResponse(JSON.stringify({ error: 'Song ID is required' }), {
+          status: 400,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+
+      const lyricAlignment = await (await sunoApi((await cookies()).toString())).getLyricAlignment(song_id);
+
+
+      return new NextResponse(JSON.stringify(lyricAlignment), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error) {
+      console.error('Error fetching lyric alignment:', 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/api/get_limit/route.ts

@@ -0,0 +1,49 @@
+import { NextResponse, NextRequest } from "next/server";
+import { cookies } from 'next/headers'
+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((await cookies()).toString())).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/api/persona/route.ts

@@ -0,0 +1,61 @@
+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 personaId = url.searchParams.get('id');
+      const page = url.searchParams.get('page');
+
+      if (personaId == null) {
+        return new NextResponse(JSON.stringify({ error: 'Missing parameter id' }), {
+          status: 400,
+          headers: {
+            'Content-Type': 'application/json',
+            ...corsHeaders
+          }
+        });
+      }
+
+      const pageNumber = page ? parseInt(page) : 1;
+      const personaInfo = await (await sunoApi()).getPersonaPaginated(personaId, pageNumber);
+
+      return new NextResponse(JSON.stringify(personaInfo), {
+        status: 200,
+        headers: {
+          'Content-Type': 'application/json',
+          ...corsHeaders
+        }
+      });
+    } catch (error) {
+      console.error('Error fetching persona:', 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/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,20 @@
+'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} requestInterceptor={(req) => {
+    // Remove cookies before sending requests
+    req.credentials = 'omit';
+    console.log(req);
+    return req;
+  }} />;
+}
+
+export default Swagger;

src/app/docs/page.tsx

@@ -0,0 +1,62 @@
+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/generate_stems\`: Make stem tracks (separate audio and music track)
+- \`/api/get_aligned_lyrics\`: Get list of timestamps for each word in the lyrics
+- \`/api/clip\`:  Get clip information based on ID passed as query parameter \`id\`
+- \`/api/concat\`: Generate the whole song from extensions
+- \`/api/persona\`: Get persona information and clips based on ID and page number
+\`\`\`
+
+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,814 @@
+{
+  "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"
+                  },
+                  "negative_tags": {
+                    "type": "string",
+                    "description": "Negative Music genre",
+                    "example": "female edm techno"
+                  },
+                  "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": ""
+                  },
+                  "negative_tags": {
+                    "type": "string",
+                    "description": "Negative Music genre",
+                    "example":""
+                  },
+                  "model": {
+                    "type": "string",
+                    "description": "Model name ,default is chirp-v3-5",
+                    "example": "chirp-v3-5|chirp-v3-0"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/generate_stems": {
+      "post": {
+        "summary": "Make stem tracks (separate audio and music track).",
+        "description": "Make stem tracks (separate audio and music track).",
+        "tags": ["default"],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["audio_id"],
+                "properties": {
+                  "audio_id": {
+                    "type": "string",
+                    "description": "The ID of the song to generate stems for.",
+                    "example": "e76498dc-6ab4-4a10-a19f-8a095790e28d"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/schemas/audio_info"
+          }
+        }
+      }
+    },
+    "/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"
+            }
+          },
+          {
+            "in": "query",
+            "name": "page",
+            "description": "Page number",
+            "required": false,
+            "schema": {
+              "type": "number"
+            }
+          }
+        ],
+        "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/get_aligned_lyrics": {
+      "get": {
+        "summary": "Get lyric alignment.",
+        "description": "Get lyric alignment.",
+        "tags": ["default"],
+        "parameters": [
+          {
+            "name": "song_id",
+            "in": "query",
+            "required": true,
+            "description": "Song ID",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/components/schemas/audio_info"
+          }
+        }
+      }
+    },
+    "/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"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/persona": {
+      "get": {
+        "summary": "Get persona information and clips.",
+        "description": "Retrieve persona information, including associated clips and pagination data.",
+        "tags": ["default"],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "query",
+            "required": true,
+            "description": "Persona ID",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "required": false,
+            "description": "Page number (defaults to 1)",
+            "schema": {
+              "type": "integer",
+              "default": 1
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "success",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "persona": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "description": "Persona ID"
+                        },
+                        "name": {
+                          "type": "string",
+                          "description": "Persona name"
+                        },
+                        "description": {
+                          "type": "string",
+                          "description": "Persona description"
+                        },
+                        "image_s3_id": {
+                          "type": "string",
+                          "description": "Persona image URL"
+                        },
+                        "root_clip_id": {
+                          "type": "string",
+                          "description": "Root clip ID"
+                        },
+                        "clip": {
+                          "type": "object",
+                          "description": "Root clip information"
+                        },
+                        "persona_clips": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "clip": {
+                                "type": "object",
+                                "description": "Clip information"
+                              }
+                            }
+                          }
+                        },
+                        "is_suno_persona": {
+                          "type": "boolean",
+                          "description": "Whether this is a Suno official persona"
+                        },
+                        "is_public": {
+                          "type": "boolean",
+                          "description": "Whether this persona is public"
+                        },
+                        "upvote_count": {
+                          "type": "integer",
+                          "description": "Number of upvotes"
+                        },
+                        "clip_count": {
+                          "type": "integer",
+                          "description": "Number of clips"
+                        }
+                      }
+                    },
+                    "total_results": {
+                      "type": "integer",
+                      "description": "Total number of results"
+                    },
+                    "current_page": {
+                      "type": "integer",
+                      "description": "Current page number"
+                    },
+                    "is_following": {
+                      "type": "boolean",
+                      "description": "Whether the current user is following this persona"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "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"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "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,156 @@
+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/generate_stems\`: Make stem tracks (separate audio and music track)
+- \`/api/get_aligned_lyrics\`: Get list of timestamps for each word in the lyrics
+- \`/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,870 @@
+import axios, { AxiosInstance } from 'axios';
+import UserAgent from 'user-agents';
+import pino from 'pino';
+import yn from 'yn';
+import { isPage, sleep, waitForRequests } from '@/lib/utils';
+import * as cookie from 'cookie';
+import { randomUUID } from 'node:crypto';
+import { Solver } from '@2captcha/captcha-solver';
+import { paramsCoordinates } from '@2captcha/captcha-solver/dist/structs/2captcha';
+import { BrowserContext, Page, Locator, chromium, firefox } from 'rebrowser-playwright-core';
+import { createCursor, Cursor } from 'ghost-cursor-playwright';
+import { promises as fs } from 'fs';
+import path from 'node:path';
+
+// sunoApi instance caching
+const globalForSunoApi = global as unknown as { sunoApiCache?: Map<string, SunoApi> };
+const cache = globalForSunoApi.sunoApiCache || new Map<string, SunoApi>();
+globalForSunoApi.sunoApiCache = cache;
+
+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.
+  negative_tags?: string; // Negative tags of music.
+  duration?: string; // Duration of the audio
+  error_message?: string; // Error message if any
+}
+
+interface PersonaResponse {
+  persona: {
+    id: string;
+    name: string;
+    description: string;
+    image_s3_id: string;
+    root_clip_id: string;
+    clip: any; // You can define a more specific type if needed
+    user_display_name: string;
+    user_handle: string;
+    user_image_url: string;
+    persona_clips: Array<{
+      clip: any; // You can define a more specific type if needed
+    }>;
+    is_suno_persona: boolean;
+    is_trashed: boolean;
+    is_owned: boolean;
+    is_public: boolean;
+    is_public_approved: boolean;
+    is_loved: boolean;
+    upvote_count: number;
+    clip_count: number;
+  };
+  total_results: number;
+  current_page: number;
+  is_following: boolean;
+}
+
+class SunoApi {
+  private static BASE_URL: string = 'https://studio-api.prod.suno.com';
+  private static CLERK_BASE_URL: string = 'https://clerk.suno.com';
+  private static CLERK_VERSION = '5.15.0';
+
+  private readonly client: AxiosInstance;
+  private sid?: string;
+  private currentToken?: string;
+  private deviceId?: string;
+  private userAgent?: string;
+  private cookies: Record<string, string | undefined>;
+  private solver = new Solver(process.env.TWOCAPTCHA_KEY + '');
+  private ghostCursorEnabled = yn(process.env.BROWSER_GHOST_CURSOR, { default: false });
+  private cursor?: Cursor;
+
+  constructor(cookies: string) {
+    this.userAgent = new UserAgent(/Macintosh/).random().toString(); // Usually Mac systems get less amount of CAPTCHAs
+    this.cookies = cookie.parse(cookies);
+    this.deviceId = this.cookies.ajs_anonymous_id || randomUUID();
+    this.client = axios.create({
+      withCredentials: true,
+      headers: {
+        'Affiliate-Id': 'undefined',
+        'Device-Id': `"${this.deviceId}"`,
+        'x-suno-client': 'Android prerelease-4nt180t 1.0.42',
+        'X-Requested-With': 'com.suno.android',
+        'sec-ch-ua': '"Chromium";v="130", "Android WebView";v="130", "Not?A_Brand";v="99"',
+        'sec-ch-ua-mobile': '?1',
+        'sec-ch-ua-platform': '"Android"',
+        'User-Agent': this.userAgent
+      }
+    });
+    this.client.interceptors.request.use(config => {
+      if (this.currentToken && !config.headers.Authorization)
+        config.headers.Authorization = `Bearer ${this.currentToken}`;
+      const cookiesArray = Object.entries(this.cookies).map(([key, value]) => 
+        cookie.serialize(key, value as string)
+      );
+      config.headers.Cookie = cookiesArray.join('; ');
+      return config;
+    });
+    this.client.interceptors.response.use(resp => {
+      const setCookieHeader = resp.headers['set-cookie'];
+      if (Array.isArray(setCookieHeader)) {
+        const newCookies = cookie.parse(setCookieHeader.join('; '));
+        for (const [key, value] of Object.entries(newCookies)) {
+          this.cookies[key] = value;
+        }
+      }
+      return resp;
+    })
+  }
+
+  public async init(): Promise<SunoApi> {
+    //await this.getClerkLatestVersion();
+    await this.getAuthToken();
+    await this.keepAlive();
+    return this;
+  }
+
+  /**
+   * Get the clerk package latest version id.
+   * This method is commented because we are now using a hard-coded Clerk version, hence this method is not needed.
+   
+  private async getClerkLatestVersion() {
+    // URL to get clerk version ID
+    const getClerkVersionUrl = `${SunoApi.JSDELIVR_BASE_URL}/v1/package/npm/@clerk/clerk-js`;
+    // Get clerk version ID
+    const versionListResponse = await this.client.get(getClerkVersionUrl);
+    if (!versionListResponse?.data?.['tags']['latest']) {
+      throw new Error(
+        'Failed to get clerk version info, Please try again later'
+      );
+    }
+    // Save clerk version ID for auth
+    SunoApi.clerkVersion = versionListResponse?.data?.['tags']['latest'];
+  }
+  */
+
+  /**
+   * Get the session ID and save it for later use.
+   */
+  private async getAuthToken() {
+    logger.info('Getting the session ID');
+    // URL to get session ID
+    const getSessionUrl = `${SunoApi.CLERK_BASE_URL}/v1/client?_is_native=true&_clerk_js_version=${SunoApi.CLERK_VERSION}`;
+    // Get session ID
+    const sessionResponse = await this.client.get(getSessionUrl, {
+      headers: { Authorization: this.cookies.__client }
+    });
+    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?_is_native=true&_clerk_js_version=${SunoApi.CLERK_VERSION}`;
+    // Renew session token
+    logger.info('KeepAlive...\n');
+    const renewResponse = await this.client.post(renewUrl, {}, {
+      headers: { Authorization: this.cookies.__client }
+    });
+    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;
+  }
+
+  /**
+   * Get the session token (not to be confused with session ID) and save it for later use.
+   */
+  private async getSessionToken() {
+    const tokenResponse = await this.client.post(
+      `${SunoApi.BASE_URL}/api/user/create_session_id/`,
+      {
+        session_properties: JSON.stringify({ deviceId: this.deviceId }),
+        session_type: 1
+      }
+    );
+    return tokenResponse.data.session_id;
+  }
+
+  private async captchaRequired(): Promise<boolean> {
+    const resp = await this.client.post(`${SunoApi.BASE_URL}/api/c/check`, {
+      ctype: 'generation'
+    });
+    logger.info(resp.data);
+    return resp.data.required;
+  }
+
+  /**
+   * Clicks on a locator or XY vector. This method is made because of the difference between ghost-cursor-playwright and Playwright methods
+   */
+  private async click(target: Locator|Page, position?: { x: number, y: number }): Promise<void> {
+    if (this.ghostCursorEnabled) {
+      let pos: any = isPage(target) ? { x: 0, y: 0 } : await target.boundingBox();
+      if (position) 
+        pos = {
+          ...pos,
+          x: pos.x + position.x,
+          y: pos.y + position.y,
+          width: null,
+          height: null,
+        };
+      return this.cursor?.actions.click({
+        target: pos
+      });
+    } else {
+      if (isPage(target))
+        return target.mouse.click(position?.x ?? 0, position?.y ?? 0);
+      else
+        return target.click({ force: true, position });
+    }
+  }
+
+  /**
+   * Get the BrowserType from the `BROWSER` environment variable.
+   * @returns {BrowserType} chromium, firefox or webkit. Default is chromium
+   */
+  private getBrowserType() {
+    const browser = process.env.BROWSER?.toLowerCase();
+    switch (browser) {
+      case 'firefox':
+        return firefox;
+      /*case 'webkit': ** doesn't work with rebrowser-patches
+      case 'safari':
+        return webkit;*/
+      default:
+        return chromium;
+    }
+  }
+
+  /**
+   * Launches a browser with the necessary cookies
+   * @returns {BrowserContext}
+   */
+  private async launchBrowser(): Promise<BrowserContext> {
+    const args = [
+      '--disable-blink-features=AutomationControlled',
+      '--disable-web-security',
+      '--no-sandbox',
+      '--disable-dev-shm-usage',
+      '--disable-features=site-per-process',
+      '--disable-features=IsolateOrigins',
+      '--disable-extensions',
+      '--disable-infobars'
+    ];
+    // Check for GPU acceleration, as it is recommended to turn it off for Docker
+    if (yn(process.env.BROWSER_DISABLE_GPU, { default: false }))
+      args.push('--enable-unsafe-swiftshader',
+        '--disable-gpu',
+        '--disable-setuid-sandbox');
+    const browser = await this.getBrowserType().launch({
+      args,
+      headless: yn(process.env.BROWSER_HEADLESS, { default: true })
+    });
+    const context = await browser.newContext({ userAgent: this.userAgent, locale: process.env.BROWSER_LOCALE, viewport: null });
+    const cookies = [];
+    const lax: 'Lax' | 'Strict' | 'None' = 'Lax';
+    cookies.push({
+      name: '__session',
+      value: this.currentToken+'',
+      domain: '.suno.com',
+      path: '/',
+      sameSite: lax
+    });
+    for (const key in this.cookies) {
+      cookies.push({
+        name: key,
+        value: this.cookies[key]+'',
+        domain: '.suno.com',
+        path: '/',
+        sameSite: lax
+      })
+    }
+    await context.addCookies(cookies);
+    return context;
+  }
+
+  /**
+   * Checks for CAPTCHA verification and solves the CAPTCHA if needed
+   * @returns {string|null} hCaptcha token. If no verification is required, returns null
+   */
+  public async getCaptcha(): Promise<string|null> {
+    if (!await this.captchaRequired())
+      return null;
+
+    logger.info('CAPTCHA required. Launching browser...')
+    const browser = await this.launchBrowser();
+    const page = await browser.newPage();
+    await page.goto('https://suno.com/create', { referer: 'https://www.google.com/', waitUntil: 'domcontentloaded', timeout: 0 });
+
+    logger.info('Waiting for Suno interface to load');
+    // await page.locator('.react-aria-GridList').waitFor({ timeout: 60000 });
+    await page.waitForResponse('**/api/project/**\\?**', { timeout: 60000 }); // wait for song list API call
+
+    if (this.ghostCursorEnabled)
+      this.cursor = await createCursor(page);
+    
+    logger.info('Triggering the CAPTCHA');
+    try {
+      await page.getByLabel('Close').click({ timeout: 2000 }); // close all popups
+      // await this.click(page, { x: 318, y: 13 });
+    } catch(e) {}
+
+    const textarea = page.locator('.custom-textarea');
+    await this.click(textarea);
+    await textarea.pressSequentially('Lorem ipsum', { delay: 80 });
+
+    const button = page.locator('button[aria-label="Create"]').locator('div.flex');
+    this.click(button);
+
+    const controller = new AbortController();
+    new Promise<void>(async (resolve, reject) => {
+      const frame = page.frameLocator('iframe[title*="hCaptcha"]');
+      const challenge = frame.locator('.challenge-container');
+      try {
+        let wait = true;
+        while (true) {
+          if (wait)
+            await waitForRequests(page, controller.signal);
+          const drag = (await challenge.locator('.prompt-text').first().innerText()).toLowerCase().includes('drag');
+          let captcha: any;
+          for (let j = 0; j < 3; j++) { // try several times because sometimes 2Captcha could return an error
+            try {
+              logger.info('Sending the CAPTCHA to 2Captcha');
+              const payload: paramsCoordinates = {
+                body: (await challenge.screenshot({ timeout: 5000 })).toString('base64'),
+                lang: process.env.BROWSER_LOCALE
+              };
+              if (drag) {
+                // Say to the worker that he needs to click
+                payload.textinstructions = 'CLICK on the shapes at their edge or center as shown above—please be precise!';
+                payload.imginstructions = (await fs.readFile(path.join(process.cwd(), 'public', 'drag-instructions.jpg'))).toString('base64');
+              }
+              captcha = await this.solver.coordinates(payload);
+              break;
+            } catch(err: any) {
+              logger.info(err.message);
+              if (j != 2)
+                logger.info('Retrying...');
+              else
+                throw err;
+            }
+          } 
+          if (drag) {
+            const challengeBox = await challenge.boundingBox();
+            if (challengeBox == null)
+              throw new Error('.challenge-container boundingBox is null!');
+            if (captcha.data.length % 2) {
+              logger.info('Solution does not have even amount of points required for dragging. Requesting new solution...');
+              this.solver.badReport(captcha.id);
+              wait = false;
+              continue;
+            }
+            for (let i = 0; i < captcha.data.length; i += 2) {
+              const data1 = captcha.data[i];
+              const data2 = captcha.data[i+1];
+              logger.info(JSON.stringify(data1) + JSON.stringify(data2));
+              await page.mouse.move(challengeBox.x + +data1.x, challengeBox.y + +data1.y);
+              await page.mouse.down();
+              await sleep(1.1); // wait for the piece to be 'unlocked'
+              await page.mouse.move(challengeBox.x + +data2.x, challengeBox.y + +data2.y, { steps: 30 });
+              await page.mouse.up();
+            }
+            wait = true;
+          } else {
+            for (const data of captcha.data) {
+              logger.info(data);
+              await this.click(challenge, { x: +data.x, y: +data.y });
+            };
+          }
+          this.click(frame.locator('.button-submit')).catch(e => {
+            if (e.message.includes('viewport')) // when hCaptcha window has been closed due to inactivity,
+              this.click(button); // click the Create button again to trigger the CAPTCHA
+            else
+              throw e;
+          });
+        }
+      } catch(e: any) {
+        if (e.message.includes('been closed') // catch error when closing the browser
+          || e.message == 'AbortError') // catch error when waitForRequests is aborted
+          resolve();
+        else
+          reject(e);
+      }
+    }).catch(e => {
+      browser.browser()?.close();
+      throw e;
+    });
+    return (new Promise((resolve, reject) => {
+      page.route('**/api/generate/v2/**', async (route: any) => {
+        try {
+          logger.info('hCaptcha token received. Closing browser');
+          route.abort();
+          browser.browser()?.close();
+          controller.abort();
+          const request = route.request();
+          this.currentToken = request.headers().authorization.split('Bearer ').pop();
+          resolve(request.postDataJSON().token);
+        } catch(err) {
+          reject(err);
+        }
+      });
+    }));
+  }
+
+  /**
+   * Imitates Cloudflare Turnstile loading error. Unused right now, left for future
+   */
+  private async getTurnstile() {
+    return this.client.post(
+      `https://clerk.suno.com/v1/client?__clerk_api_version=2021-02-05&_clerk_js_version=${SunoApi.CLERK_VERSION}&_method=PATCH`,
+      { captcha_error: '300030,300030,300030' },
+      { headers: { 'content-type': 'application/x-www-form-urlencoded' } });
+  }
+
+  /**
+   * 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 = await 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.
+   * @param negative_tags Negative tags that should not be included in the generated audio.
+   * @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,
+    negative_tags?: string
+  ): Promise<AudioInfo[]> {
+    const startTime = Date.now();
+    const audios = await this.generateSongs(
+      prompt,
+      true,
+      tags,
+      title,
+      make_instrumental,
+      model,
+      wait_audio,
+      negative_tags
+    );
+    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.
+   * @param negative_tags Negative tags that should not be included in the generated audio.
+   * @param task Optional indication of what to do. Enter 'extend' if extending an audio, otherwise specify null.
+   * @param continue_clip_id 
+   * @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,
+    negative_tags?: string,
+    task?: string,
+    continue_clip_id?: string,
+    continue_at?: number
+  ): Promise<AudioInfo[]> {
+    await this.keepAlive();
+    const payload: any = {
+      make_instrumental: make_instrumental,
+      mv: model || DEFAULT_MODEL,
+      prompt: '',
+      generation_type: 'TEXT',
+      continue_at: continue_at,
+      continue_clip_id: continue_clip_id,
+      task: task,
+      token: await this.getCaptcha()
+    };
+    if (isCustom) {
+      payload.tags = tags;
+      payload.title = title;
+      payload.negative_tags = negative_tags;
+      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,
+            negative_tags: negative_tags,
+            payload: payload
+          },
+          null,
+          2
+        )
+    );
+    const response = await this.client.post(
+      `${SunoApi.BASE_URL}/api/generate/v2/`,
+      payload,
+      {
+        timeout: 10000 // 10 seconds timeout
+      }
+    );
+    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 {
+      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,
+        negative_tags: audio.metadata.negative_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: number,
+    tags: string = '',
+    negative_tags: string = '',
+    title: string = '',
+    model?: string,
+    wait_audio?: boolean
+  ): Promise<AudioInfo[]> {
+    return this.generateSongs(prompt, true, tags, title, false, model, wait_audio, negative_tags, 'extend', audioId, continueAt);
+  }
+
+  /**
+   * Generate stems for a song.
+   * @param song_id The ID of the song to generate stems for.
+   * @returns A promise that resolves to an AudioInfo object representing the generated stems.
+   */
+  public async generateStems(song_id: string): Promise<AudioInfo[]> {
+    await this.keepAlive(false);
+    const response = await this.client.post(
+      `${SunoApi.BASE_URL}/api/edit/stems/${song_id}`, {}
+    );
+
+    console.log('generateStems response:\n', response?.data);
+    return response.data.clips.map((clip: any) => ({
+      id: clip.id,
+      status: clip.status,
+      created_at: clip.created_at,
+      title: clip.title,
+      stem_from_id: clip.metadata.stem_from_id,
+      duration: clip.metadata.duration
+    }));
+  }
+
+
+  /**
+   * Get the lyric alignment for a song.
+   * @param song_id The ID of the song to get the lyric alignment for.
+   * @returns A promise that resolves to an object containing the lyric alignment.
+   */
+  public async getLyricAlignment(song_id: string): Promise<object> {
+    await this.keepAlive(false);
+    const response = await this.client.get(`${SunoApi.BASE_URL}/api/gen/${song_id}/aligned_lyrics/v2/`);
+
+    console.log(`getLyricAlignment ~ response:`, response.data);
+    return response.data?.aligned_words.map((transcribedWord: any) => ({
+      word: transcribedWord.word,
+      start_s: transcribedWord.start_s,
+      end_s: transcribedWord.end_s,
+      success: transcribedWord.success,
+      p_align: transcribedWord.p_align
+    }));
+  }
+
+  /**
+   * 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.
+   * @param page An optional page number to retrieve audio information from.
+   * @returns A promise that resolves to an array of AudioInfo objects.
+   */
+  public async get(
+    songIds?: string[],
+    page?: string | null
+  ): Promise<AudioInfo[]> {
+    await this.keepAlive(false);
+    let url = new URL(`${SunoApi.BASE_URL}/api/feed/v2`);
+    if (songIds) {
+      url.searchParams.append('ids', songIds.join(','));
+    }
+    if (page) {
+      url.searchParams.append('page', page);
+    }
+    logger.info('Get audio status: ' + url.href);
+    const response = await this.client.get(url.href, {
+      // 10 seconds timeout
+      timeout: 10000
+    });
+
+    const audios = response.data.clips;
+
+    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
+    };
+  }
+
+  public async getPersonaPaginated(personaId: string, page: number = 1): Promise<PersonaResponse> {
+    await this.keepAlive(false);
+    
+    const url = `${SunoApi.BASE_URL}/api/persona/get-persona-paginated/${personaId}/?page=${page}`;
+    
+    logger.info(`Fetching persona data: ${url}`);
+    
+    const response = await this.client.get(url, {
+      timeout: 10000 // 10 seconds timeout
+    });
+
+    if (response.status !== 200) {
+      throw new Error('Error response: ' + response.statusText);
+    }
+
+    return response.data;
+  }
+}
+
+export const sunoApi = async (cookie?: string) => {
+  const resolvedCookie = cookie && cookie.includes('__client') ? cookie : process.env.SUNO_COOKIE; // Check for bad `Cookie` header (It's too expensive to actually parse the cookies *here*)
+  if (!resolvedCookie) {
+    logger.info('No cookie provided! Aborting...\nPlease provide a cookie either in the .env file or in the Cookie header of your request.')
+    throw new Error('Please provide a cookie either in the .env file or in the Cookie header of your request.');
+  }
+
+  // Check if the instance for this cookie already exists in the cache
+  const cachedInstance = cache.get(resolvedCookie);
+  if (cachedInstance)
+    return cachedInstance;
+
+  // If not, create a new instance and initialize it
+  const instance = await new SunoApi(resolvedCookie).init();
+  // Cache the initialized instance
+  cache.set(resolvedCookie, instance);
+
+  return instance;
+};

src/lib/utils.ts

@@ -0,0 +1,118 @@
+import pino from "pino";
+import { Page } from "rebrowser-playwright-core";
+
+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));
+}
+
+/**
+ * @param target A Locator or a page
+ * @returns {boolean} 
+ */
+export const isPage = (target: any): target is Page => {
+  return target.constructor.name === 'Page';
+}
+
+/**
+ * Waits for an hCaptcha image requests and then waits for all of them to end
+ * @param page
+ * @param signal `const controller = new AbortController(); controller.status`
+ * @returns {Promise<void>} 
+ */
+export const waitForRequests = (page: Page, signal: AbortSignal): Promise<void> => {
+  return new Promise((resolve, reject) => {
+    const urlPattern = /^https:\/\/img[a-zA-Z0-9]*\.hcaptcha\.com\/.*$/;
+    let timeoutHandle: NodeJS.Timeout | null = null;
+    let activeRequestCount = 0;
+    let requestOccurred = false;
+
+    const cleanupListeners = () => {
+      page.off('request', onRequest);
+      page.off('requestfinished', onRequestFinished);
+      page.off('requestfailed', onRequestFinished);
+    };
+
+    const resetTimeout = () => {
+      if (timeoutHandle)
+        clearTimeout(timeoutHandle);
+      if (activeRequestCount === 0) {
+        timeoutHandle = setTimeout(() => {
+          cleanupListeners();
+          resolve();
+        }, 1000); // 1 second of no requests
+      }
+    };
+
+    const onRequest = (request: { url: () => string }) => {
+      if (urlPattern.test(request.url())) {
+        requestOccurred = true;
+        activeRequestCount++;
+        if (timeoutHandle)
+          clearTimeout(timeoutHandle);
+      }
+    };
+
+    const onRequestFinished = (request: { url: () => string }) => {
+      if (urlPattern.test(request.url())) {
+        activeRequestCount--;
+        resetTimeout();
+      }
+    };
+
+    // Wait for an hCaptcha request for up to 1 minute
+    const initialTimeout = setTimeout(() => {
+      if (!requestOccurred) {
+        page.off('request', onRequest);
+        cleanupListeners();
+        reject(new Error('No hCaptcha request occurred within 1 minute.'));
+      } else {
+        // Start waiting for no hCaptcha requests
+        resetTimeout();
+      }
+    }, 60000); // 1 minute timeout
+
+    page.on('request', onRequest);
+    page.on('requestfinished', onRequestFinished);
+    page.on('requestfailed', onRequestFinished);
+
+    // Cleanup the initial timeout if an hCaptcha request occurs
+    page.on('request', (request: { url: () => string }) => {
+      if (urlPattern.test(request.url())) {
+        clearTimeout(initialTimeout);
+      }
+    });
+
+    const onAbort = () => {
+      cleanupListeners();
+      clearTimeout(initialTimeout);
+      if (timeoutHandle)
+        clearTimeout(timeoutHandle);
+      signal.removeEventListener('abort', onAbort);
+      reject(new Error('AbortError'));
+    };
+
+    signal.addEventListener('abort', onAbort, { once: true });
+  }); 
+}
+
+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;

tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"],
+      "playwright-core": ["./node_modules/rebrowser-playwright-core"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}