Source: https://ailoot.ai/models/sl/suno-api/ Canonical: https://ailoot.ai/models/sl/suno-api/ Language: sl # suno-api [Markdown](https://ailoot.ai/models/sl/suno-api/index.md) · [JSON](https://ailoot.ai/models/sl/suno-api/facts.json) ## [suno-api](https://ailoot.ai/models/sl/suno-api/) Suno ustvarja glasbo iz kratke pisne zamisli. Dokumentirani samodejni postopek ustvari dve skladbi in vključuje možnost instrumentalne izvedbe, dokončani zvočni posnetki in metapodatki skladb pa se vrnejo prek opravila generiranja. - [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/sl/suno-api/#method-0) O modelu Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo. Suno je storitev za ustvarjanje glasbe, ki pisno zamisel spremeni v skladbe. Dokumentirani samodejni postopek sprejme kratek opis želene glasbe in izbiro instrumentalne izvedbe, nato pa ustvari dve skladbi. Z opisom določite temo, razpoloženje in glasbeno usmeritev, ki jih želite slišati v dokončanih skladbah. Začnite z vlogo, ki naj jo ima glasba. Mirno ozadje za razlago, energičen uvod v kratek video ali razmišljujoča pesem o potovanju dajejo opisu konkreten namen. V nekaj jasnih povedih opišite želeno razpoloženje in glasbene značilnosti, ki so pomembne za ta namen. Pri pesmi z vokalom v ustvarjalnem opisu jasno določite temo in jezik. Opišite zamisel, ki naj jo skladba izrazi, in ton, ki naj ga izraža izvedba. Pri poslušanju dokončanega rezultata ocenite, kako vokal, besedilo in aranžma delujejo skupaj. Podatke o ustvarjeni skladbi hranite skupaj z zvočnim posnetkom za pregled. Pri instrumentalnem rezultatu uporabite dokumentirano izbiro instrumentalne izvedbe in v besedilu opišite glasbeno usmeritev. Navedite želeno vzdušje in izstopajoča glasbila, kadar so pomembna za projekt. Dokončano skladbo ocenite glede na mesto, ki ga bo imela v montaži, vključno z odseki, ki morajo služiti kot podlaga govoru ali podpreti vizualni prehod. Samodejni postopek iz poslane zamisli ustvari dve skladbi. Obravnavajte ju kot ločeni različici in ohranite obe dokončani zvočni datoteki. Vsako poslušajte skozi začetek, razvoj in zaključek. Dejanski skladbi primerjajte glede na isti namen, vključno z razpoloženjem, aranžmajem in primernostjo za načrtovano uporabo. Generiranje poteka kot opravilo. Med preverjanjem njegovega rezultata ohranite vrnjeni ID opravila in razlikujte med dokončanimi skladbami ter tistimi, ki so še v izdelavi. Dokumentirani rezultat vključuje podatke za posamezno skladbo, kot so naslov, stanje, lokacija zvočnega posnetka in trajanje. Dokončani zvočni posnetek shranite skupaj z razpoložljivimi metapodatki in izvirnim opisom. Pri videu ali predstavitvi izbrano glasbo preizkusite ob dejanskem gradivu. Začetek, prehode in zaključek preverite pri predvideni glasnosti poslušanja. Označite odsek, ki podpira montažo, in ohranite celotno skladbo za poznejše spremembe. Primeren glasbeni izsek presojajte v kontekstu glasu, slik in ritma dokončanega izdelka. Pisno zamisel, izbiro instrumentalne izvedbe, izbiro modela in vse dokončane skladbe hranite skupaj. Ko je treba različico popraviti, določite glasbeno neskladje, denimo aranžma, ki je pod govorom preveč zgoščen, ali uvod, ki se razvija prepočasi. Ohranite uporabno usmeritev in popravite del opisa, povezan s to težavo. **Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api` [`suno-api`](https://ailoot.ai/models/sl/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) Suno /`suno-api` ### Začetek Suno ustvarja glasbo iz kratke pisne zamisli. Dokumentirani samodejni postopek ustvari dve skladbi in vključuje možnost instrumentalne izvedbe, dokončani zvočni posnetki in metapodatki skladb pa se vrnejo prek opravila generiranja. Dovoljeni vhodi Besedilo Rezultati Zvok · Slike · Video ### Na voljo v Ailoot · vhodi in metode **Ailoot Ultra · Music** `POST /v1/music/generations` Vhod `text` Izhod `audio`, `image`, `video` | Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto | | --- | --- | --- | --- | --- | | Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve suno-api Pogoji: Uporabite natanko ta izbirnik usmerjanja Ailoot. | Privzeto— | | Polje`gpt_description_prompt` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Opišite glasbeno zamisel ali temo pesmi. | Privzeto— | | Polje`mv` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Pogoji: Izberite konkretno dokumentirano različico Suno; primer uporablja chirp-crow (v5). | Privzeto— | | Polje`make_instrumental` | Vrsta`boolean` | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Za instrumentalno glasbo nastavite true, za pesem pa false. | Privzeto— | Parametri in življenjski cikel metode | Parameter | Specifikacija | | --- | --- | | Parameter`content_type` | Specifikacijaapplication/json | | Parameter`required` | Specifikacijamodel, gpt\_description\_prompt, mv, make\_instrumental | | Parameter`optional` | Specifikacija | | Parameter`material_types` | Specifikacijatext | | Parameter`conditions` | SpecifikacijaUporabite natanko ta izbirnik usmerjanja Ailoot., Opišite glasbeno zamisel ali temo pesmi., Izberite konkretno dokumentirano različico Suno; primer uporablja chirp-crow (v5)., Za instrumentalno glasbo nastavite true, za pesem pa false. | Življenjski cikel: `submit_once_poll_original` `GET /v1/music/generations/{request_id}` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Cenik ##### Kako se izračuna končni strošek Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina. Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi. Hitri način Ni navedeno Ko je izbran hitri način Način flex Ni navedeno Ko je izbran način flex Najvišja raven razmišljanja Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default) #### Ocenjene cene za primerjavo #### Cene po nastavitvah Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno. | Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska količina | Strošek | | --- | --- | --- | --- | --- | | NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo **—** / 1K žetonov | | NastavitevNa zahtevo | Cenovna lestvica— | Predvidena količina— | Obračunska količinaena zahteva | Strošek Vhod · Ocena samo za primerjavo **$0.2** na zahtevo | | NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska količina— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo **$0.2** ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. | Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/) ### Primeri zahtev #### Ailoot Ultra · Music curl · ustvarite enkrat in ohranite potrdiloPreberite izvirno opraviloShranite vsako dokončano datoteko v svoji lasti ```bash 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. ``` ```bash 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 ``` ```bash 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 ``` ### Prejmi in shrani rezultate #### Ailoot Ultra · Music Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64 - `GET /v1/music/generations/{request_id}` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Ohrani vse dokončane rezultate Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine. Ohranite celoten odgovor in glave, prvotne identifikatorje, vsak dejanski izhod in vsa polja porabe/obračuna. Shranite vsako enolično sredstvo v vaši lasti in ohranite vsako vlogo, ki kaže nanj. ##### Če je treba preveriti izvirni odgovor Ohranite vrnjeni javni id opravila ali operacije in vse glave. Berite samo prvotno opravilo; unknown ali result\_pending\_check ne dovoljujeta novega ustvarjanja. Polja odgovora | Polje | Vrsta | | --- | --- | | Polje`id` | Vrstastring | | Polje`polling_url` | Vrstastring | | Polje`provider_task_id` | Vrstastring | | Polje`data.task_id` | Vrstastring | | Polje`data.status` | Vrstastring | | Polje`data.data[].audio_url` | Vrstastring | | Polje`data.data[].image_url` | Vrstastring | | Polje`data.data[].image_large_url` | Vrstastring | | Polje`data.data[].video_url` | Vrstastring | ### Druga imena #### Druga imena modelov **Ailoot Ultra** [`suno-api`](https://ailoot.ai/models/sl/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) #### Druga imena poti metod Uporabite zgoraj navedene poti metod. #### Povezani ID-ji za klic [`suno-api`](https://ailoot.ai/models/sl/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) FAQ · suno-api Kateri vhodi in rezultati so na voljo? `POST /v1/music/generations` · `suno-api`: `text` → `audio`, `image`, `video` Katera polja uporablja zahteva? `POST /v1/music/generations` · `suno-api`: `model`, `gpt_description_prompt`, `mv`, `make_instrumental` Ailoot povežite s Claude Code, OpenCode, Hermes ali svojo aplikacijo. ## Podjetje in njegov portfelj projektov Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah. ## Žetone kupujte s popustom. Naročniški popust za redno delo. Promocijske kode prinesejo do 50% popusta na nakup žetonov. Naročnina Za redne zahteve izberite paket s popustom. Promocijska koda do 50% Kodo vnesite ob nakupu. Cena se preračuna po veljavni akciji. Poraba v zgodovini Za vsako zahtevo se shranijo model, žetoni in znesek. [Izberite naročnino](https://ailoot.ai/docs/sl/billing/subscriptions/) · [Oglejte si cene modelov](https://ailoot.ai/models/sl/) ## API povežite z izdelkom, ki ga prodajate. SaaS, aplikacije in boti po ponudbi in licenčni pogodbi Ailoot. Za nadaljnjo prodajo zaprosite za preprodajno licenco. Komercialna aplikacija Ustvarjanje besedila, slik, videa in zvoka vključite v plačljive funkcije svoje storitve. Licenca za preprodajalca Pošljite opis projekta in shemo dostopa. Zahtevajte pisne pogoje uporabe in nadaljnje prodaje. Dokumenti na strani Ponudba, licenčna pogodba in politika obdelave podatkov so dostopne pred povezavo. [Zaprosite za preprodajno licenco](mailto:support@ailoot.ai) · [Ponudba in licenčna pogodba](https://ailoot.ai/legal/offer?lang=sl) ## Ailoot · Podjetje in njegov portfelj projektov Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI. Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah. Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.