Source: https://ailoot.ai/models/sk/suno-api/ Canonical: https://ailoot.ai/models/sk/suno-api/ Language: sk # suno-api [Markdown](https://ailoot.ai/models/sk/suno-api/index.md) · [JSON](https://ailoot.ai/models/sk/suno-api/facts.json) ## [suno-api](https://ailoot.ai/models/sk/suno-api/) Suno vytvára hudbu z krátkeho písomného nápadu. Zdokumentovaný automatický postup vytvára dve skladby a zahŕňa voľbu inštrumentálnej verzie, pričom hotový zvuk a metadáta skladieb sa vracajú prostredníctvom úlohy generovania. - [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/sk/suno-api/#method-0) O modeli Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu. Suno je služba na generovanie hudby, ktorá premieňa písomný nápad na skladby. Zdokumentovaný automatický postup prijíma krátky opis zamýšľanej hudby a voľbu inštrumentálnej verzie a následne vygeneruje dve skladby. Pomocou zadania určite tému, náladu a hudobné smerovanie, ktoré chcete počuť v hotových skladbách. Začnite úlohou, ktorú má hudba plniť. Pokojný podklad k vysvetľovaniu, energický úvod krátkeho videa alebo hĺbavá pieseň o ceste dávajú zadaniu konkrétny účel. V niekoľkých jasných formuláciách opíšte zamýšľanú náladu a hudobné vlastnosti, ktoré sú pre tento účel podstatné. Pri piesni so spevom jasne určite tému a jazyk v tvorivom zadaní. Opíšte myšlienku, ktorú má skladba vyjadrovať, a tón, ktorý má interpretácia sprostredkovať. Vypočujte si hotový výsledok a posúďte, ako spolu fungujú spev, slová a aranžmán. Uchovajte vygenerované informácie o skladbe spolu so zvukom na vyhodnotenie. Pri inštrumentálnom výsledku použite zdokumentovanú voľbu inštrumentálnej verzie a v texte opíšte hudobné smerovanie. Uveďte požadovanú atmosféru a výrazné nástroje, ak sú pre projekt podstatné. Posúďte hotovú skladbu vzhľadom na jej miesto v strihu vrátane úsekov, ktoré majú znieť pod hovoreným slovom alebo podporovať vizuálny prechod. Automatický postup vytvára z odoslaného nápadu dve skladby. Považujte ich za samostatné návrhy a uchovajte oba hotové zvukové súbory. Vypočujte si pri každom úvod, rozvoj aj záver. Porovnajte skutočné skladby podľa rovnakého účelu vrátane ich nálady, aranžmánu a vhodnosti na plánované použitie. Generovanie prebieha formou úlohy. Pri kontrole výsledku si uchovajte vrátené ID úlohy a odlišujte hotové skladby od položiek, ktoré sa ešte spracúvajú. Zdokumentovaný výsledok zahŕňa informácie na úrovni skladby, napríklad názov, stav, umiestnenie zvuku a trvanie. Uložte samotný hotový zvuk spolu s dostupnými metadátami a pôvodným zadaním. Pri videu alebo prezentácii si vybranú hudbu skúšobne vypočujte spolu so skutočným materiálom. Skontrolujte úvod, prechody a záver pri zamýšľanej hlasitosti počúvania. Označte úsek, ktorý slúži strihu, a uchovajte celú skladbu pre neskoršie zmeny. Vhodný hudobný úryvok sa posudzuje v kontexte hlasu, obrazov a tempa hotového diela. Uchovajte písomný nápad, voľbu inštrumentálnej verzie, výber modelu a všetky hotové skladby spolu. Keď návrh potrebuje úpravu, určite hudobný nesúlad, napríklad aranžmán príliš hutný pod hovoreným slovom alebo úvod, ktorý sa rozvíja príliš pomaly. Zachovajte užitočné smerovanie a upravte tú časť zadania, ktorá súvisí s daným problémom. **Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api` [`suno-api`](https://ailoot.ai/models/sk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) Suno /`suno-api` ### Úvod Suno vytvára hudbu z krátkeho písomného nápadu. Zdokumentovaný automatický postup vytvára dve skladby a zahŕňa voľbu inštrumentálnej verzie, pričom hotový zvuk a metadáta skladieb sa vracajú prostredníctvom úlohy generovania. Povolené vstupy Text Výsledky Audio · Obrázky · Video ### Dostupné v Ailoot · vstupy a metódy **Ailoot Ultra · Music** `POST /v1/music/generations` Vstup `text` Výstup `audio`, `image`, `video` | Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené | | --- | --- | --- | --- | --- | | Pole`model` | Typ`string` | PožiadavkaPovinné | Hodnoty a limity suno-api Podmienky: Použite presne tento smerovací selektor Ailoot. | Predvolené— | | Pole`gpt_description_prompt` | Typ`string` | PožiadavkaPovinné | Hodnoty a limity Podmienky: Opíšte hudobný nápad alebo tému piesne. | Predvolené— | | Pole`mv` | Typ`string` | PožiadavkaPovinné | Hodnoty a limity chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5 Podmienky: Vyberte konkrétnu zdokumentovanú verziu Suno; príklad používa chirp-crow (v5). | Predvolené— | | Pole`make_instrumental` | Typ`boolean` | PožiadavkaPovinné | Hodnoty a limity Podmienky: Pre inštrumentálnu hudbu nastavte true, pre pieseň false. | Predvolené— | Parametre a životný cyklus metódy | Parameter | Špecifikácia | | --- | --- | | Parameter`content_type` | Špecifikáciaapplication/json | | Parameter`required` | Špecifikáciamodel, gpt\_description\_prompt, mv, make\_instrumental | | Parameter`optional` | Špecifikácia | | Parameter`material_types` | Špecifikáciatext | | Parameter`conditions` | ŠpecifikáciaPoužite presne tento smerovací selektor Ailoot., Opíšte hudobný nápad alebo tému piesne., Vyberte konkrétnu zdokumentovanú verziu Suno; príklad používa chirp-crow (v5)., Pre inštrumentálnu hudbu nastavte true, pre pieseň false. | Životný cyklus: `submit_once_poll_original` `GET /v1/music/generations/{request_id}` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Cenník ##### Ako sa vypočíta konečný poplatok Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo. Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde. Rýchly režim Neuvedené Keď je zvolený rýchly režim Režim Flex Neuvedené Keď je zvolený režim flex Maximálna úroveň uvažovania Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default) #### Odhadované sadzby na porovnanie #### Ceny podľa konfigurácie Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu. | Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacie množstvo | Poplatok | | --- | --- | --- | --- | --- | | KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacie množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie **—** / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie **—** / 1K tokenov | | KonfiguráciaZa požiadavku | Sadzobník— | Odhadované množstvo— | Účtovacie množstvojedna požiadavka | Poplatok Vstup · Odhad iba na porovnanie **$0.2** za požiadavku | | KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacie množstvo— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie **$0.2** odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. | Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. [Ako funguje rezervácia a vyúčtovanie →](https://ailoot.ai/docs/sk/billing/reserve/) ### Príklady požiadaviek #### Ailoot Ultra · Music curl · vytvoriť iba raz a uchovať potvrdeniePrečítať pôvodnú úlohuUložiť každý hotový výstup, ktorý vám patrí ```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 ``` ### Prijať a uložiť výsledky #### Ailoot Ultra · Music Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64 - `GET /v1/music/generations/{request_id}` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Uchovať všetky dokončené výsledky Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu. Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje. ##### Ak treba overiť pôvodnú odpoveď Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result\_pending\_check neoprávňujú na ďalšie vytvorenie. Polia odpovede | Pole | Typ | | --- | --- | | Pole`id` | Typstring | | Pole`polling_url` | Typstring | | Pole`provider_task_id` | Typstring | | Pole`data.task_id` | Typstring | | Pole`data.status` | Typstring | | Pole`data.data[].audio_url` | Typstring | | Pole`data.data[].image_url` | Typstring | | Pole`data.data[].image_large_url` | Typstring | | Pole`data.data[].video_url` | Typstring | ### Aliasy #### Aliasy modelov **Ailoot Ultra** [`suno-api`](https://ailoot.ai/models/sk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) #### Aliasy ciest metód Použite cesty metód uvedené vyššie. #### Súvisiace ID na volanie [`suno-api`](https://ailoot.ai/models/sk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) FAQ · suno-api Aké vstupy a výsledky sú dostupné? `POST /v1/music/generations` · `suno-api`: `text` → `audio`, `image`, `video` Aké polia používa požiadavka? `POST /v1/music/generations` · `suno-api`: `model`, `gpt_description_prompt`, `mv`, `make_instrumental` Pripojte Ailoot k Claude Code, OpenCode, Hermes alebo vlastnej aplikácii. ## Spoločnosť a jej portfólio projektov Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách. ## Nakupujte tokeny so zľavou. Zľava predplatného na pravidelnú prácu. Promo kódy až 50% na nákup tokenov. Predplatné Na pravidelné požiadavky vyberte tarifu so zľavou. Promo kód až 50% Pri nákupe zadajte kód. Cena sa prepočíta podľa prebiehajúcej akcie. Výdavky v histórii Pri každej požiadavke sa uloží model, tokeny a suma. [Vybrať predplatné](https://ailoot.ai/docs/sk/billing/subscriptions/) · [Zobraziť ceny modelov](https://ailoot.ai/models/sk/) ## Pripojte API k produktu, ktorý predávate. SaaS, aplikácie a boti podľa ponuky a licenčnej zmluvy Ailoot. Na ďalší predaj požiadajte o licenciu predajcu. Komerčná aplikácia Začleňte generovanie textu, obrázkov, videa a zvuku do platených funkcií svojej služby. Licencia pre predajcu Pošlite popis projektu a spôsob poskytovania prístupu. Vyžiadajte písomné podmienky použitia a ďalšieho predaja. Dokumenty na webe Ponuka, licenčná zmluva a zásady spracovania dát sú dostupné pred pripojením. [Požiadať o licenciu predajcu](mailto:support@ailoot.ai) · [Ponuka a licenčná zmluva](https://ailoot.ai/legal/offer?lang=sk) ## Ailoot · Spoločnosť a jej portfólio projektov Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI. Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách. Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.