suno-api
Suno lager musikk fra en kort skriftlig idé. Den dokumenterte automatiske arbeidsflyten produserer to sanger og har et valg for instrumentalmusikk. Den ferdige lyden og metadataene for hvert spor returneres gjennom genereringsoppgaven.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Suno er en musikkgenereringstjeneste som gjør en skriftlig idé til sanger. Den dokumenterte automatiske arbeidsflyten tar imot en kort beskrivelse av ønsket musikk og et valg for instrumental musikk, og genererer deretter to sanger. Bruk beskrivelsen til å etablere temaet, stemningen og den musikalske retningen du vil høre i de ferdige sporene.
Start med rollen musikken skal ha. En rolig bakgrunn til en forklaring, en energisk åpning til en kort video eller en ettertenksom sang om en reise gir hver for seg beskrivelsen et konkret formål. Beskriv den ønskede stemningen og de musikalske egenskapene som betyr noe for formålet, med noen få tydelige formuleringer.
For en sang med vokal gjør du temaet og språket tydelige i den kreative beskrivelsen. Beskriv ideen sporet skal uttrykke, og tonen fremføringen skal formidle. Lytt til det ferdige resultatet for å vurdere hvordan vokalen, ordene og arrangementet fungerer sammen. Oppbevar den genererte sporinformasjonen sammen med lyden for gjennomgang.
For et instrumentalt resultat bruker du det dokumenterte instrumentalvalget og beskriver den musikalske retningen i teksten. Oppgi ønsket atmosfære og fremtredende instrumenter når disse har betydning for prosjektet. Vurder det ferdige sporet ut fra plassen det skal ha i klippingen, inkludert partiene som skal ligge under tale eller støtte en visuell overgang.
Den automatiske arbeidsflyten produserer to sanger fra den innsendte ideen. Behandle dem som separate alternativer, og behold begge de ferdige lydfilene. Lytt til hver av dem gjennom åpningen, utviklingen og avslutningen. Sammenlign de faktiske sporene opp mot det samme formålet, inkludert stemning, arrangement og egnethet for den planlagte bruken.
Genereringen er organisert som en oppgave. Behold den returnerte oppgave-ID-en mens du sjekker resultatet, og skill mellom ferdige spor og elementer som fortsatt er under behandling. Det dokumenterte resultatet omfatter informasjon om hvert spor, som tittel, status, plasseringen til lydfilen og varighet. Lagre selve den ferdige lyden sammen med tilgjengelige metadata og den opprinnelige beskrivelsen.
For en video eller presentasjon prøvelytter du den valgte musikken sammen med det faktiske materialet. Kontroller åpningen, overgangene og avslutningen på det tiltenkte lydnivået. Marker partiet som tjener klippingen, og behold hele sporet for senere endringer. Et passende musikkutdrag vurderes i sammenheng med stemmen, bildene og tempoet i det ferdige verket.
Oppbevar den skriftlige ideen, instrumentalvalget, modellvalget og alle ferdige spor samlet. Når en variant må revideres, angir du det musikalske avviket, som et arrangement som er for tett under tale, eller en åpning som utvikler seg for langsomt. Behold den nyttige retningen, og endre den delen av beskrivelsen som er knyttet til problemet.
Ailoot Ultra · Music POST /v1/music/generations suno-api
suno-apiStart
Suno lager musikk fra en kort skriftlig idé. Den dokumenterte automatiske arbeidsflyten produserer to sanger og har et valg for instrumentalmusikk. Den ferdige lyden og metadataene for hvert spor returneres gjennom genereringsoppgaven.
- Godkjente inndata
- Tekst
- Resultater
- Lyd · Bilder · Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Music POST /v1/music/generations
- Inndatatyper
text- Utdatatyper
audio,image,video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser suno-api Vilkår: Bruk nøyaktig denne rutingsvelgeren for Ailoot. | Standard— |
Feltgpt_description_prompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Beskriv den musikalske ideen eller sangens tema. | Standard— |
Feltmv | Typestring | KravPåkrevd | Verdier & grenser chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Vilkår: Velg en dokumentert Suno-versjon uttrykkelig; eksemplet bruker chirp-crow (v5). | Standard— |
Feltmake_instrumental | Typeboolean | KravPåkrevd | Verdier & grenser Vilkår: Angi true for instrumentalmusikk eller false for en sang. | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, gpt_description_prompt, mv, make_instrumental |
Parameteroptional | Avtale |
Parametermaterial_types | Avtaletext |
Parameterconditions | AvtaleBruk nøyaktig denne rutingsvelgeren for Ailoot., Beskriv den musikalske ideen eller sangens tema., Velg en dokumentert Suno-versjon uttrykkelig; eksemplet bruker chirp-crow (v5)., Angi true for instrumentalmusikk eller false for en sang. |
Livssyklus: submit_once_poll_original
GET /v1/music/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsmengde | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsmengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonPer forespørsel | Prisplan— | Forventet mengde— | Faktureringsmengdeén forespørsel | Kostnad Inndata · Estimat kun for sammenligning $0.2 per forespørsel |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsmengde— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.2 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "suno-api",
"gpt_description_prompt": "古诗词",
"mv": "chirp-crow",
"make_instrumental": false
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Motta og lagre resultater
Ailoot Ultra · Music
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/music/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle ferdige resultater
Behold alle fullstendige returnerte svar, filer og innholdsdeler.
Behold hele svaret og alle svarhoder, opprinnelige identifikatorer, alle faktiske utdata og alle felt for forbruk og avregning. Lagre hver unike ressurs du eier, og behold alle roller som viser til den.
Hvis det opprinnelige svaret må kontrolleres
Behold den returnerte offentlige oppgave- eller operasjons-ID-en og alle svarhoder. Les bare den opprinnelige oppgaven; unknown eller result_pending_check gir ikke tillatelse til en ny opprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Feltdata.task_id | Typestring |
Feltdata.status | Typestring |
Feltdata.data[].audio_url | Typestring |
Feltdata.data[].image_url | Typestring |
Feltdata.data[].image_large_url | Typestring |
Feltdata.data[].video_url | Typestring |
Aliaser
Modellaliaser
Ailoot Ultra suno-api
Aliaser for metodestier
Bruk metodestiene som vises ovenfor.
Tilknyttede anroper-ID-er
FAQ · suno-api
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/music/generations·suno-api:text→audio,image,video- Hvilke felt bruker forespørselen?
POST /v1/music/generations·suno-api:model,gpt_description_prompt,mv,make_instrumental