Hoppa till huvudinnehåll
Huvudfunktionen för Suno Tasks API är att fråga efter körningsstatusen för uppgiften genom att ange uppgifts-ID:t som genererats av Suno Audios Generation API eller Suno Lyrics Generation API. Detta dokument kommer att introducera integreringsanvisningarna för Suno Tasks API i detalj, för att hjälpa dig att enkelt integrera och fullt ut utnyttja de kraftfulla funktionerna i detta API. Genom Suno Tasks API kan du enkelt fråga efter uppgiftskörningsstatusen för Suno Lyrics Generation API eller Suno Audios Generation API.

​
Ansökningsprocess

För att använda Suno Audios Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API-token och spara den för senare användning. Om du ännu inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan för att bli inbjuden att registrera dig och logga in. När detta är klart återvänder du automatiskt till den aktuella sidan. En API-token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Vid den första ansökan ges en kostnadsfri kvot, som kan användas för att prova tjänsten gratis; när kvoten inte räcker till kan du fylla på det allmänna saldot i konsolen.
📘 Fullständig dokumentation: Suno Audios Generation API →

​
Begäransexempel

Suno Tasks API kan användas för att fråga efter resultaten från både Suno Audios Generation API och Suno Lyrics Generation API. För information om hur du använder Suno Audios Generation API, se dokumentationen Suno Audios Generation API . För information om hur du använder Suno Lyrics Generation API, se Suno Lyrics Generation API . Vi använder ett uppgifts-ID som returneras av tjänsten Suno Audios Generation API som exempel för att visa hur detta API används. Anta att vi har ett uppgifts-ID: eae26f89-b64b-404d-a80c-761996660b1c, därefter visar vi hur man genom att skicka in ett uppgifts-ID kan.

​
Bildexempel för uppgift

​
Ställ in begärandehuvuden och begärandetext

Request Headers inkluderar:
  • accept: Anger att svarsresultat i JSON-format ska tas emot, här anges application/json.
  • authorization: Nyckeln för att anropa API:t, efter ansökan kan den väljas direkt från rullgardinsmenyn.
Request Body inkluderar:
  • id: Det uppladdade uppgifts-ID:t.
  • action: Åtgärdssättet för uppgiften.
Inställningarna visas i bilden nedan:

​
Kodexempel

Det går att se att kod för olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Några kodexempel är följande:

​
CURL

​
Python

​
Svarsexempel

Efter att begäran har lyckats kommer API:t att returnera detaljinformation om låtuppgiften här. Till exempel:
Resultatet innehåller flera fält. Fältet request är request body när uppgiften initieras, medan fältet response är response body som returneras efter att uppgiften har slutförts. Fältbeskrivningarna är följande.
  • id, ID:t för uppgiften som genererar denna låt, som används för att unikt identifiera denna låtgenereringsuppgift.
  • request, begärandeinformation i frågan av låtuppgiften.
  • response, returinformation i frågan av låtuppgiften.
  • created_at, tidpunkt då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
  • started_at, tidpunkt då uppgiften började köras, Unix-tidsstämpel (sekunder, flyttal).
  • finished_at, tidpunkt då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte när uppgiften inte är slutförd.
  • elapsed, tidsåtgång för uppgiftens körning, i sekunder (flyttal, behåll 3 decimaler). Detta fält returneras inte när uppgiften inte är slutförd.

​
Batchfrågeåtgärd

Detta är för att fråga detaljinformation om låtuppgifter för flera uppgifts-ID:n. Skillnaden från ovan är att action måste väljas som retrieve_batch. Request Body omfattar:
  • ids: Den uppladdade arrayen med uppgifts-ID:n.
  • action: Åtgärdssättet för uppgiften.
Inställningen visas i figuren nedan:

​
Kodexempel

Det går att se att kod på olika språk redan har genererats automatiskt på höger sida av sidan, som visas i figuren:

Några kodexempel är följande:

​
Exempel på svar

Efter att begäran har lyckats kommer API:t att returnera specifik detaljinformation för alla batch-låtuppgifter denna gång. Till exempel:
Det finns flera fält i returresultatet, där items innehåller den specifika detaljinformationen för batchuppgifter för låtar. Den specifika informationen för varje låtuppgift är densamma som fälten ovan, och fältinformationen är följande.
  • items, all specifik detaljinformation för batchuppgifter för låtar. Det är en array, och formatet för varje element i arrayen är detsamma som returresultatet för att fråga efter en enskild uppgift ovan.
  • count, antalet låtuppgifter som frågas efter i batch här.

​
CURL

​
Python

​
Felhantering

Vid anrop av API:t returnerar API:t motsvarande felkod och information om ett fel uppstår. Till exempel:
  • 400 token_mismatched: Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obehörig, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begäranden, du har överskridit hastighetsgränsen.
  • 500 api_error: Internt serverfel, något gick fel på servern.

​
Exempel på felsvar

​
Slutsats

Genom detta dokument har du lärt dig hur du använder Suno Tasks API för att fråga efter all specifik detaljinformation för enskilda eller batchvisa låtuppgifter. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, kontakta gärna vårt tekniska supportteam när som helst.