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.
- 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
To install the library, you need to have Node.js installed. Run the following command to install the necessary dependencies:
npm install suno-denoAlternatively, if you are using Deno, no additional dependencies are required.
Here's how you can use Suno-Ma to generate and retrieve song links as buffer data:
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();To run the code, use the following command:
node test-my-ai-musicOr if you are using Deno:
deno run --allow-net test-my-ai-music.jsInitializes the SunoDeno instance and renews the authentication token.
Returns the number of song generation credits left.
Generates songs based on the provided payload.
Retrieves the song link as buffer data.
Retrieves metadata for the specified song IDs.
Retrieves metadata for all generated songs.
Generates song lyrics based on the provided prompt.
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
{
"gpt_description_prompt": "a syncopated blues song about how you're always there for me",
"mv": "chirp-v3-5",
"prompt": "",
"make_instrumental": false
}{
"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
}{
"prompt": "",
"tags": "futuristic jazz",
"mv": "chirp-v3-0",
"title": "",
"continue_clip_id": "d55b5269-6bad-4f61-a8f5-871fb124044d",
"continue_at": 109
}{
"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
}This project is licensed under the MIT License. See the LICENSE file for details.