modely

suno-api

Markdown · JSON

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.

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

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
PoleTypPožiadavkaHodnoty a limityPredvolené
PolemodelTypstringPožiadavkaPovinnéHodnoty a limity
suno-api
Podmienky: Použite presne tento smerovací selektor Ailoot.
Predvolené—
Polegpt_description_promptTypstringPožiadavkaPovinnéHodnoty a limity
Podmienky: Opíšte hudobný nápad alebo tému piesne.
Predvolené—
PolemvTypstringPož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é—
Polemake_instrumentalTypbooleanPož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
Parametercontent_typeŠpecifikáciaapplication/json
ParameterrequiredŠpecifikáciamodel, gpt_description_prompt, mv, make_instrumental
ParameteroptionalŠpecifikácia
Parametermaterial_typesŠpecifikáciatext
ParameterconditionsŠ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áciaSadzobníkOdhadované množstvoÚčtovacie množstvoPoplatok
KonfiguráciaZákladné sadzby za tokenySadzobníkZákladná sadzbaOdhadované 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žiadavkuSadzobník—Odhadované množstvo—Účtovacie množstvojedna požiadavkaPoplatok
Vstup · Odhad iba na porovnanie $0.2 za požiadavku
KonfiguráciaOdhadované náklady na generovanieSadzobní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 →

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í
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

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
PoleTyp
PoleidTypstring
Polepolling_urlTypstring
Poleprovider_task_idTypstring
Poledata.task_idTypstring
Poledata.statusTypstring
Poledata.data[].audio_urlTypstring
Poledata.data[].image_urlTypstring
Poledata.data[].image_large_urlTypstring
Poledata.data[].video_urlTypstring

Aliasy

Aliasy modelov

Ailoot Ultra suno-api

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

suno-api

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

Viac podrobností

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é · Zobraziť ceny modelov

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 · Ponuka a licenčná zmluva