Hoppa till huvudinnehåll

Introduktion

Producer är en AI-ljudtjänst som tillhandahålls av Ace Data Cloud, FUZZ Producer AI musikgenerering. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Producer med Python för att skapa musik från text, anpassa texter, fortsätta låtar, göra covers, separera sångröster, generera musikvideor med mera.

Förutsättningar

  • Ett konto på 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 Producer API är:
POST https://api.acedata.cloud/producer/audios
Det här exemplet använder modellen FUZZ-2.0 Pro. Tillgängliga modeller inkluderar: FUZZ-2.0 Pro, FUZZ-2.0, FUZZ-1.1 Pro, FUZZ-1.0 Pro. Fullständigt Python-exempel:
import requests

url = "https://api.acedata.cloud/producer/audios"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "generate",
    "prompt": "A relaxing jazz piece for a coffee shop",
    "model": "FUZZ-2.0 Pro",
    "lyric": "[Verse]\nSoft piano keys in the morning light",
    "custom": true
}

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äckligt saldo eller ingen åtkomst
429För många förfrågningar
500Intern serverfel

Övriga endpoints

Producer-tjänsten erbjuder även följande endpoints:
  • POST https://api.acedata.cloud/producer/videos
  • POST https://api.acedata.cloud/producer/wav
  • POST https://api.acedata.cloud/producer/tasks
  • POST https://api.acedata.cloud/producer/lyrics

Nästa steg