Hoppa till huvudinnehåll

Introduktion

Suno är en AI-ljudtjänst från Ace Data Cloud för AI-genererad musik. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Suno med JavaScript för att skapa musik från text, anpassa låttexter, fortsätta låtar, göra covers, separera sångröster, generera texter med mera.

Förutsättningar

  • Ett konto hos Ace Data Cloud och en API-token
  • Node.js 18+ eller en modern webbläsare

Grundläggande användning

Huvudendpoint för Suno API är:
POST https://api.acedata.cloud/suno/audios
Detta exempel använder modellen chirp-v5. Tillgängliga modeller är: chirp-v5, v4-5-plus, v4-5, v4, v3-5. Fullständigt JavaScript-exempel:
const response = await fetch("https://api.acedata.cloud/suno/audios", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "generate",
  "prompt": "A cheerful pop song about summer vacation",
  "model": "chirp-v5",
  "custom": false
}),
});

const result = await response.json();
console.log(result);
Byt ut YOUR_API_TOKEN mot din faktiska token från Ace Data Cloud-plattformen.

Hantering av svar

Det rekommenderas att kontrollera statuskoden och hantera fel:
if (response.ok) {
  const result = await response.json();
  console.log("Anrop lyckades:", result);
} else {
  console.error(`Anrop misslyckades, statuskod: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Node.js-wrapper

Det rekommenderas att kapsla in i en återanvändbar funktion:
async function callSuno(data) {
  const response = await fetch("https://api.acedata.cloud/suno/audios", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API-fel: ${response.status}`);
  return response.json();
}

Felhantering

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräckligt saldo eller åtkomst nekad
429För många förfrågningar
500Internt serverfel

Nästa steg