Skip to content

Suno-Deno is a library designed for interacting with the Suno AI music generation service. This library provides a comprehensive set of methods to generate songs, retrieve metadata, return song links as buffer data, and more.

Notifications You must be signed in to change notification settings

Zizwar/suno-deno

Repository files navigation

Suno-Deno

Suno-Deno is a library designed for interacting with the Suno AI music generation service. This library provides a comprehensive set of methods to generate songs, retrieve metadata, return song links as buffer data, and more.

Features

  • Generate songs with AI-generated lyrics or custom lyrics
  • Retrieve metadata for generated songs
  • Return song links as buffer data
  • Retrieve remaining song generation credits
  • Generate song lyrics with AI

Installation

To install the library, you need to have Node.js installed. Run the following command to install the necessary dependencies:

npm install suno-deno

Alternatively, if you are using Deno, no additional dependencies are required.

Usage

Here's how you can use Suno-Ma to generate and retrieve song links as buffer data:

1. Setup

Create a file named test-my-ai-music.js and use the following code as an example:

import SunoDeno from 'suno-deno';
// if deno land

// import SunoDeno from 'https://unpkg.com/suno-deno';

async function main() {
    try {
        const cookie = 'your_cookie';
        const sid = 'your_sid';
        const suno = new SunoDeno(sid, cookie);

        await suno.init();

        const limit = await suno.getLimitLeft();
        console.log(`${limit} songs left`);

        const payload = {
            gpt_description_prompt: null,
            prompt: null,
            tags: null,
            make_instrumental: false,
            title: null,
            mv: 'chirp-v3-0',
            continue_clip_id: null,
            continue_at: null
        };

        const songInfo = await suno.generateSongs(payload);
        for (const song of songInfo) {
            const buffer = await suno.getSongBuffer(song.audio_url);
            console.log(`Song buffer for ${song.title}:`, buffer);
        }

        const ids = ['79742cdf-86c9-432f-81f2-8c2126de42d9', 'ae5ccb5-f4f8-49c9-8f5c-192e43ed9b0c', '0bba671e-b071-4da8-99e7-361b4c69f8b3'];
        const specificSongs = await suno.getMetadata(ids);

        const allSongs = await suno.getAllSongs();

        const lyrics = await suno.generateLyrics("hissin in the kitchen");
        console.log(lyrics);
    } catch (error) {
        console.error('Error:', error);
    }
}

main();

2. Running the Code

To run the code, use the following command:

node test-my-ai-music

Or if you are using Deno:

deno run --allow-net test-my-ai-music.js

3. Methods Overview

init()

Initializes the SunoDeno instance and renews the authentication token.

getLimitLeft()

Returns the number of song generation credits left.

generateSongs(payload)

Generates songs based on the provided payload.

getSongBuffer(url)

Retrieves the song link as buffer data.

getMetadata(ids)

Retrieves metadata for the specified song IDs.

getAllSongs()

Retrieves metadata for all generated songs.

generateLyrics(prompt)

Generates song lyrics based on the provided prompt.

API with Honojs

import { Hono } from "npm:hono";
import SunoDeno from "npm:suno-deno";
const SESS = Deno.env.get("SESS")||"sess_";
const COOKIE = Deno.env.get("COOKIE")||"__client=eg";

const suno = new SunoDeno(SESS, COOKIE);

const app = new Hono();

app.get("/", async (c) => {
  try{
     // await suno.init();
    return c.text(`# Suno-Deno
Suno-Deno is a library designed for interacting with the Suno AI music generation service. 
This library provides a comprehensive set of methods to generate songs, retrieve metadata, 
return song links as buffer data, and more.

https://github.com/Zizwar/suno-deno`);
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.get("/limit", async (c) => {
  try {
    const limit = await suno.getLimitLeft();
    return c.json({ limit });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.post("/generate-songs", async (c) => {
  try {
    const payload = await c.req.json();
    const songs = await suno.generateSongs(payload);
    return c.json({ songs });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.get("/metadata", async (c) => {
  try {
    const ids = c.req.query("ids")?.split(",") || [];
    const metadata = await suno.getMetadata(ids);
    return c.json({ metadata });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.get("/all-songs", async (c) => {
  try {
    const songs = await suno.getAllSongs();
    return c.json({ songs });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.get("/song-buffer", async (c) => {
  try {
    const url = c.req.query("url");
    const buffer = await suno.getSongBuffer(url);
    return new Response(buffer, {
      headers: {
        "Content-Type": "application/octet-stream",
      },
    });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

app.post("/generate-lyrics", async (c) => {
  try {
    const { prompt } = await c.req.json();
    const lyrics = await suno.generateLyrics(prompt);
    return c.json({ lyrics });
  } catch (error) {
    return c.json({ error: error.message }, 500);
  }
});

try {
await suno.init();
}catch(e){console.log(e)}
Deno.serve(app.fetch);

test dash deno deploy: https://dash.deno.com/playground/suno

Example Payloads or Body

Generate a song with a prompt

{
  "gpt_description_prompt": "a syncopated blues song about how you're always there for me",
  "mv": "chirp-v3-5",
  "prompt": "",
  "make_instrumental": false
}

Generate a song with custom lyrics

{
  "prompt": "[Intro Clapping]\nسأسافرُ عبرَ الارض\nباحثا في كلِ مكان \n عن بوكيمون اداةِ \nالسلام\nقوةُ لا تهان\nبوكيمون سأجمعها الان\nفلتساندني\nبقوتك ساعدني\nآه لحلمنا الوحيد نحو عالمِ جديد",
  "tags": "dreamy kids music",
  "mv": "chirp-v3-0",
  "title": "Lines",
  "make_instrumental": false,
  "continue_clip_id": null,
  "continue_at": null
}

Continue generating a song from a specific point

{
  "prompt": "",
  "tags": "futuristic jazz",
  "mv": "chirp-v3-0",
  "title": "",
  "continue_clip_id": "d55b5269-6bad-4f61-a8f5-871fb124044d",
  "continue_at": 109
}

Remix and continue a song

{
  "prompt": "[Verse]\nWalking down the street, nobody takes a second glance\nLost in the crowd, I'm just a faceless passerby (oh-oh-oh)\n",
  "tags": "electronic hip hop",
  "mv": "chirp-v3-5",
  "title": "Lost in the Shuffle",
  "continue_clip_id": "62ed33cb-f802-47d3-a233-9a7f3fc804a3",
  "continue_at": 90.36
}

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Suno-Deno is a library designed for interacting with the Suno AI music generation service. This library provides a comprehensive set of methods to generate songs, retrieve metadata, return song links as buffer data, and more.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published