POST https://api.acedata.cloud/suno/projects är Beta-gränssnittet för att hantera flerspårsprojekt. Använd action för att skilja mellan skapande, sparande, generering av kandidater, inskickning av kandidater och export.
retrieve kräver varje åtgärd Idempotency-Key. Samma nyckel och samma begäran läser endast tillbaka det ursprungliga resultatet; samma nyckel med en annan begäran returnerar 409. Vid nätverkstimeout eller osäkerhet kring inskickningsresultatet för avgiftsbelagd generering, fråga först med det ursprungliga uppgifts-ID:t eller samma idempotensnyckel; byt inte direkt nyckel och skicka igen.
Identifierare och tidsenheter
start_seconds / end_seconds är sekunder inom källjudet; start_beats / end_beats är antal taktslag på projektets tidslinje. state.timing.bps är taktslag per sekund, med standardvärdet 2. Till exempel har ett segment på 41 sekunder som börjar vid taktslag 0 som standard ett slut vid taktslag 82. Sekundintervallet för generate_track används för att ange genereringsreferensen och garanterar inte att kandidaten endast har längden för det intervallet.
Åtgärdsflöde
Om endast lokal ersättning utförs räcker befintligt användbart källjud, och
render behöver inte köras först; om källjudet redan finns i projektet kan även upload och add_track hoppas över. render_audio_id är endast en obligatorisk referens för generate_track.
Vid inskickning av en asynkron åtgärd returneras först { "task_id": "...", "trace_id": "..." }, vilket inte betyder att genereringen har lyckats. Pollning:
finished_at och dess response.success är true; när response.success=false ska response.error läsas. Även om save kan innehålla task_id, slutförs den synkront i detta gränssnitt. upload, render, generate_track, replace_section ändrar inte projektversionen; efter lyckad save, add_track, commit_candidate eller remove_track ska det nya version_id hämtas.
Begärandekonventioner
Följande exempel visar kopplat hur ID:n och versioner överförs mellan åtgärder. Svaren listar endast fält som är relevanta för det aktuella steget; vid integrering ska exempel-ID:n ersättas med svarsvärden från den aktuella applikationen.
Skapa och läsa projekt
Skapa projekt: create
Begäran:
Läs projekt: retrieve
Begäran:```json
{
“action”: “retrieve”,
“id”: “af0e104a-2a4c-40e0-9c70-7614566824a6”
}
start_seconds/end_seconds är inte en garanti för utdata-längd.
Använd kandidat: commit_candidate
Generering producerar endast kandidater och placerar dem inte automatiskt i projektet.
commit_candidate kontrollerar att kandidaten fortfarande tillhör den aktuella versionen. Kandidater för lokal ersättning kan endast skickas automatiskt när den faktiska längden tillförlitligt kan matchas mot hela källjudet eller det valda intervallet; vid bristande matchning behålls det ursprungliga projektet och ett fel returneras, och det går inte att framtvinga sammanfogning genom att manuellt gissa taktantalet.
Exportera efter inlämning
Efter att kandidaten för det nya spåret har skickats in avvisades exporten av hela låten som innehåller kandidaten. Begäran och slutlig status:studio_audio_unavailable tas emot ska det ursprungliga projektet behållas och tillgängligheten för det refererade ljudet kontrolleras.
Ersätt befintligt klipp
replace_section kan direkt använda befintligt källjud utan att först exportera en mix. Generering returnerar endast kandidater; vid inlämning väljs originalspåret som innehåller det unika källklippet.
Generera ersättningskandidat: replace_section
Kandidatlängder stämmer inte överens
När en kandidat för partiell ersättning skickas in skatrack_id peka på det ursprungliga spåret som innehåller det enda källsegmentet, och start_beats och end_beats ska utelämnas. Endast när kandidatens längd på ett tillförlitligt sätt kan matchas med hela källjudet eller det valda intervallet uppdaterar gränssnittet projektet.
Efter att ha valt ett 8-sekundersintervall är båda kandidaterna 36 sekunder, vilket varken är lika med originaljudets 41 sekunder eller det valda intervallets 8 sekunder. När en av kandidaterna skickas in returneras:
Ta bort spår
remove_track kräver aktuellt version_id och state.tracks[].id; använd den nya version som returneras efter lyckad åtgärd. Nedan tas kandidatspåret bort som inte kan användas för export av hela låten, och projektets status läses tillbaka.
Export efter borttagning
Efter att detta kandidatspår tagits bort finns det ursprungliga källspåret fortfarande kvar, och exporten lyckas igen med den senaste versionen:audio_url kan användas för nedladdning eller uppspelning. Att ljudlänken är åtkomlig bevisar inte att andra kandidater också är kvalificerade för projektexport.
Fel och återställning
Projekt och kandidater är kopplade till det program som skapade dem; använd det ursprungliga programmet för åtkomst. Spara den slutliga ljud-URL:en efter en lyckad export och behåll
trace_id för felsökning.
