Hoppa till huvudinnehåll

Introduktion

Suno är en AI-ljudtjänst från Ace Data Cloud för AI-musikgenerering. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Suno med Python för att skapa musik från text, anpassa texter, 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
  • Python 3.7 eller senare
  • Installera requests-biblioteket: pip install requests

Grundläggande användning

Huvudendpoint för att anropa Suno API är:
POST https://api.acedata.cloud/suno/audios
Detta exempel använder modellen chirp-v5. Tillgängliga modeller inkluderar: chirp-v5, v4-5-plus, v4-5, v4, v3-5. Fullständigt Python-exempel:
import requests

url = "https://api.acedata.cloud/suno/audios"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "generate",
    "prompt": "A cheerful pop song about summer vacation",
    "model": "chirp-v5",
    "custom": false
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Byt ut YOUR_API_TOKEN mot din faktiska token från Ace Data Cloud-plattformen.

Hantering av svar

Vid lyckad anrop returnerar API:et data i JSON-format. Det rekommenderas att kontrollera HTTP-statuskoden:
if response.status_code == 200:
    result = response.json()
    print("Anrop lyckades:", result)
else:
    print(f"Anrop misslyckades, statuskod: {response.status_code}")
    print(response.text)

Avancerad användning

För API:er som stödjer asynkrona uppgifter kan resultat erhållas via en callback-URL:
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Resultatet skickas sedan till din server via callback-URL

Felhantering

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräcklig balans eller ingen åtkomst
429För många förfrågningar (rate limit)
500Internt serverfel

Andra endpoints

Suno-tjänsten erbjuder även följande endpoints:
  • POST https://api.acedata.cloud/suno/lyrics
  • POST https://api.acedata.cloud/suno/persona
  • POST https://api.acedata.cloud/suno/wav
  • POST https://api.acedata.cloud/suno/mp4
  • POST https://api.acedata.cloud/suno/tasks

Nästa steg