Source: https://ailoot.ai/models/fi/suno-api/ Canonical: https://ailoot.ai/models/fi/suno-api/ Language: fi # suno-api [Markdown](https://ailoot.ai/models/fi/suno-api/index.md) · [JSON](https://ailoot.ai/models/fi/suno-api/facts.json) ## [suno-api](https://ailoot.ai/models/fi/suno-api/) Suno luo musiikkia lyhyestä kirjallisesta ideasta. Dokumentoitu automaattinen työnkulku tuottaa kaksi kappaletta ja sisältää instrumentaalivalinnan. Valmis ääni ja kappaleiden metatiedot palautetaan generointitehtävän kautta. - [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/fi/suno-api/#method-0) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. Suno on musiikin generointipalvelu, joka muuttaa kirjallisen idean kappaleiksi. Dokumentoitu automaattinen työnkulku ottaa vastaan lyhyen kuvauksen tavoitellusta musiikista ja instrumentaalivalinnan ja luo sitten kaksi kappaletta. Määrittele ohjeistuksella teema, tunnelma ja musiikillinen suunta, jonka haluat kuulla valmiissa kappaleissa. Aloita musiikin tehtävästä. Rauhallinen tausta selitykselle, energinen aloitus lyhytvideoon tai pohdiskeleva laulu matkasta antaa ohjeistukselle konkreettisen tarkoituksen. Kuvaile tavoiteltu tunnelma ja tarkoituksen kannalta olennaiset musiikilliset piirteet muutamalla selkeällä ilmauksella. Määrittele laulua sisältävän kappaleen teema ja kieli selkeästi luovassa ohjeistuksessa. Kuvaile ajatus, jota kappaleen pitäisi ilmaista, ja sävy, jonka esityksen pitäisi välittää. Kuuntele valmiista tuloksesta, miten laulu, sanat ja sovitus toimivat yhdessä. Säilytä generoidun kappaleen tiedot äänen kanssa arviointia varten. Käytä instrumentaalikappaleen luomiseen dokumentoitua instrumentaalivalintaa ja kuvaile musiikillinen suunta tekstissä. Kerro toivottu tunnelma ja keskeiset soittimet, kun ne ovat projektille olennaisia. Arvioi valmista kappaletta sen leikkauksessa saaman paikan perusteella, myös niiltä osin, joiden on soitava puheen alla tai tuettava visuaalista siirtymää. Automaattinen työnkulku tuottaa lähetetystä ideasta kaksi kappaletta. Käsittele niitä erillisinä vaihtoehtoina ja säilytä molemmat valmiit äänitiedostot. Kuuntele kummankin alku, eteneminen ja loppu. Vertaile valmiita kappaleita saman käyttötarkoituksen perusteella: huomioi niiden tunnelma, sovitus ja sopivuus suunniteltuun käyttöön. Generointi tapahtuu tehtävän kautta. Säilytä palautettu tehtävätunnus sen tulosta tarkistaessasi ja erota valmiit kappaleet vielä keskeneräisistä kohteista. Dokumentoitu tulos sisältää kappalekohtaisia tietoja, kuten nimen, tilan, äänitiedoston sijainnin ja keston. Tallenna valmis äänitiedosto saatavilla olevien metatietojen ja alkuperäisen ohjeistuksen kanssa. Sovita valittua musiikkia videoon tai esitykseen kuuntelemalla sitä todellisen materiaalin yhteydessä. Tarkista alku, siirtymät ja loppu suunnitellulla kuunteluvoimakkuudella. Merkitse leikkausta palveleva osuus ja säilytä koko kappale myöhempiä muutoksia varten. Sopivaa musiikkikatkelmaa arvioidaan valmiin teoksen puheen, kuvien ja rytmityksen yhteydessä. Säilytä kirjallinen idea, instrumentaalivalinta, mallivalinta ja kaikki valmiit kappaleet yhdessä. Kun vaihtoehto tarvitsee korjausta, määrittele musiikillinen poikkeama, kuten puheen taustalle liian runsas sovitus tai liian hitaasti kehittyvä alku. Säilytä hyödyllinen suunta ja muuta ongelmaan liittyvää ohjeistuksen osaa. **Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api` [`suno-api`](https://ailoot.ai/models/fi/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) Suno /`suno-api` ### Aloitus Suno luo musiikkia lyhyestä kirjallisesta ideasta. Dokumentoitu automaattinen työnkulku tuottaa kaksi kappaletta ja sisältää instrumentaalivalinnan. Valmis ääni ja kappaleiden metatiedot palautetaan generointitehtävän kautta. Hyväksytyt syötteet Teksti Tulokset Ääni · Kuvat · Video ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · Music** `POST /v1/music/generations` Syötetyypit `text` Tulostyypit `audio`, `image`, `video` | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat suno-api Ehdot: Käytä täsmälleen tätä Ailoot-reititysvalitsinta. | Oletus— | | Kenttä`gpt_description_prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvaile musiikillinen idea tai kappaleen teema. | Oletus— | | Kenttä`mv` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Ehdot: Valitse nimenomaisesti dokumentoitu Suno-versio; esimerkissä käytetään versiota chirp-crow (v5). | Oletus— | | Kenttä`make_instrumental` | Tyyppi`boolean` | VaatimusPakollinen | Arvot & rajat Ehdot: Aseta arvoksi true instrumentaalimusiikille tai false laululle. | Oletus— | Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, gpt\_description\_prompt, mv, make\_instrumental | | Parametri`optional` | Sopimus | | Parametri`material_types` | Sopimustext | | Parametri`conditions` | SopimusKäytä täsmälleen tätä Ailoot-reititysvalitsinta., Kuvaile musiikillinen idea tai kappaleen teema., Valitse nimenomaisesti dokumentoitu Suno-versio; esimerkissä käytetään versiota chirp-crow (v5)., Aseta arvoksi true instrumentaalimusiikille tai false laululle. | Elinkaari: `submit_once_poll_original` `GET /v1/music/generations/{request_id}` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Hinnoittelu ##### Lopullisen veloituksen laskenta Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä. Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle. Nopea tila Ei määritetty Kun nopea tila on valittu Flex-tila Ei määritetty Kun flex-tila on valittu Päättelyn enimmäisteho Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä #### Arvioidut vertailuhinnat #### Hinnat asetusten mukaan Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden. | Asetukset | Hinnasto | Ennustettu määrä | Laskutusmäärä | Veloitus | | --- | --- | --- | --- | --- | | AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusmäärä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten **—** / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten **—** / 1K tokenia | | AsetuksetPyyntöä kohden | Hinnasto— | Ennustettu määrä— | Laskutusmääräyksi pyyntö | Veloitus Syöte · Arvio vain vertailua varten **$0.2** pyyntöä kohden | | AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusmäärä— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.2** arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. | Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. [Varauksen ja lopullisen veloituksen toiminta →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Music curl · luo vain kerran ja säilytä kuittiLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset ```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 ``` ### Vastaanota ja tallenna tulokset #### Ailoot Ultra · Music Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö - `GET /v1/music/generations/{request_id}` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Säilytä kaikki valmistuneet tulokset Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa. Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit. ##### Jos alkuperäinen vastaus on tarkistettava Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result\_pending\_check ei oikeuta uuteen luontipyyntöön. Vastauksen kentät | Kenttä | Tyyppi | | --- | --- | | Kenttä`id` | Tyyppistring | | Kenttä`polling_url` | Tyyppistring | | Kenttä`provider_task_id` | Tyyppistring | | Kenttä`data.task_id` | Tyyppistring | | Kenttä`data.status` | Tyyppistring | | Kenttä`data.data[].audio_url` | Tyyppistring | | Kenttä`data.data[].image_url` | Tyyppistring | | Kenttä`data.data[].image_large_url` | Tyyppistring | | Kenttä`data.data[].video_url` | Tyyppistring | ### Aliakset #### Mallin aliakset **Ailoot Ultra** [`suno-api`](https://ailoot.ai/models/fi/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) #### Menetelmäpolkujen aliakset Käytä yllä näytettyjä menetelmäpolkuja. #### Liittyvät kutsujan ID:t [`suno-api`](https://ailoot.ai/models/fi/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) FAQ · suno-api Mitä syötteitä ja tuloksia on saatavilla? `POST /v1/music/generations` · `suno-api`: `text` → `audio`, `image`, `video` Mitä kenttiä pyyntö käyttää? `POST /v1/music/generations` · `suno-api`: `model`, `gpt_description_prompt`, `mv`, `make_instrumental` Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.