models

suno-api

Markdown · JSON

suno-api

Suno қысқа жазбаша идеядан музыка жасайды. Құжатталған автоматты үдеріс екі ән шығарады және аспаптық нұсқаны таңдауға мүмкіндік береді; дайын аудио мен трек метадеректері генерация тапсырмасы арқылы қайтарылады.

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Suno — жазбаша идеяны әнге айналдыратын музыка генерациялау қызметі. Құжатталған автоматты үдеріс көзделген музыканың қысқа сипаттамасын және аспаптық нұсқа таңдауын қабылдап, екі ән жасайды. Дайын тректерден естігіңіз келетін тақырыпты, көңіл күйді және музыкалық бағытты белгілеу үшін тапсырма сипаттамасын қолданыңыз.

Алдымен музыканың атқаратын рөлін анықтаңыз. Түсіндірмеге арналған тыныш фон, қысқа видеоның серпінді басталуы немесе сапар туралы ойлы ән тапсырмаға нақты мақсат береді. Көзделген көңіл күйді және сол мақсатқа маңызды музыкалық ерекшеліктерді бірнеше анық тіркеспен сипаттаңыз.

Вокалы бар ән үшін шығармашылық тапсырмада тақырып пен тілді анық көрсетіңіз. Трек жеткізуі тиіс идеяны және орындау арқылы берілуі тиіс реңкті сипаттаңыз. Дайын нәтижені тыңдап, вокалдың, сөздердің және аранжировканың қалай үйлесетінін бағалаңыз. Қарап шығу үшін жасалған трек туралы ақпаратты аудиомен бірге сақтаңыз.

Аспаптық нәтиже үшін құжатталған аспаптық нұсқа таңдауын қолданып, музыкалық бағытты мәтінде сипаттаңыз. Жоба үшін маңызды болса, қажетті атмосфераны және негізгі аспаптарды көрсетіңіз. Дайын тректі монтажда алатын орнына қарай бағалаңыз, соның ішінде сөзге фон ретінде естілуі немесе визуалдық ауысуды сүйемелдеуі тиіс бөліктерін тексеріңіз.

Автоматты үдеріс жіберілген идеядан екі ән жасайды. Оларды бөлек нұсқалар ретінде қарастырып, дайын екі аудиофайлды да сақтаңыз. Әрқайсысын басталуын, даму барысын және аяқталуын қоса толық тыңдаңыз. Нақты тректерді бірдей мақсатқа сай салыстырыңыз, соның ішінде көңіл күйін, аранжировкасын және жоспарланған қолданысқа жарамдылығын бағалаңыз.

Генерация тапсырма түрінде ұйымдастырылады. Нәтижесін тексергенде қайтарылған тапсырма ID мәнін сақтап, дайын тректерді әлі орындалып жатқан элементтерден ажыратыңыз. Құжатталған нәтижеде атауы, күйі, аудионың орналасуы және ұзақтығы сияқты әр трекке қатысты ақпарат бар. Дайын аудионың өзін қолжетімді метадеректермен және бастапқы тапсырмамен бірге сақтаңыз.

Видео немесе таныстырылым үшін таңдалған музыканы нақты материалмен бірге тыңдап көріңіз. Басталуын, ауысуларын және аяқталуын көзделген дыбыс деңгейінде тексеріңіз. Монтажға қызмет ететін бөлікті белгілеп, кейінгі өзгерістер үшін толық тректі сақтаңыз. Музыкалық үзіндінің жарамдылығы дайын туындының даусымен, бейнелерімен және ырғағымен бірлікте бағаланады.

Жазбаша идеяны, аспаптық нұсқа таңдауын, модель таңдауын және барлық дайын тректерді бірге сақтаңыз. Нұсқаны түзету қажет болса, сөзге фон болғанда тым тығыз естілетін аранжировка немесе тым баяу дамитын басталу сияқты музыкалық сәйкессіздікті анықтаңыз. Пайдалы бағытты сақтап, тапсырманың сол мәселеге қатысты бөлігін өзгертіңіз.

Ailoot Ultra · Music POST /v1/music/generations suno-api

suno-api

Suno /suno-api

Бастау

Suno қысқа жазбаша идеядан музыка жасайды. Құжатталған автоматты үдеріс екі ән шығарады және аспаптық нұсқаны таңдауға мүмкіндік береді; дайын аудио мен трек метадеректері генерация тапсырмасы арқылы қайтарылады.

Қабылданатын кіріс деректері
Мәтін
Нәтижелер
Аудио · Суреттер · Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Music POST /v1/music/generations
Кіріс
text
Шығыс
audio, image, video
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
suno-api
Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз.
Әдепкі—
Өрісgpt_description_promptТүріstringТалапМіндеттіМәндер мен шектеулер
Шарттар: Музыкалық идеяны немесе әннің тақырыбын сипаттаңыз.
Әдепкі—
ӨрісmvТүріstringТалапМіндеттіМәндер мен шектеулер
chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5
Шарттар: Suno жүйесінің нақты құжатталған нұсқасын таңдаңыз; мысалда chirp-crow (v5) қолданылады.
Әдепкі—
Өрісmake_instrumentalТүріbooleanТалапМіндеттіМәндер мен шектеулер
Шарттар: Аспаптық музыка үшін true, ал ән үшін false мәнін орнатыңыз.
Әдепкі—
Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, gpt_description_prompt, mv, make_instrumental
ПараметрoptionalПараметр талаптары
Параметрmaterial_typesПараметр талаптарыtext
ПараметрconditionsПараметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Музыкалық идеяны немесе әннің тақырыбын сипаттаңыз., Suno жүйесінің нақты құжатталған нұсқасын таңдаңыз; мысалда chirp-crow (v5) қолданылады., Аспаптық музыка үшін true, ал ән үшін false мәнін орнатыңыз.

Өмірлік цикл: submit_once_poll_original

GET /v1/music/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим
Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим
Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі
Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

БаптауМөлшерлемелер кестесіБолжамды мөлшерЕсептелетін мөлшерТөлем
БаптауТокендердің базалық тарифтеріМөлшерлемелер кестесіНегізгі мөлшерлемеБолжамды мөлшер—Есептелетін мөлшер—Төлем
Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен
Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауӘр сұрауғаМөлшерлемелер кестесі—Болжамды мөлшер—Есептелетін мөлшербір сұрауТөлем
Кіріс · Тек салыстыруға арналған бағалау $0.2 әр сұрау үшін
БаптауГенерацияның болжамды құныМөлшерлемелер кестесі—Болжамды мөлшербір генерацияға арналған болжамЕсептелетін мөлшер—Төлем
Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.2 жасауға дейінгі бағалау

Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Music

curl · бір рет құрып, қабылдау жазбасын сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз
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

Нәтижелерді алу және сақтау

Ailoot Ultra · Music

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

  • GET /v1/music/generations/{request_id}
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Барлық дайын нәтижені сақтау

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.

Бастапқы жауапты тексеру қажет болса

Қайтарылған ашық тапсырма не операция id мәнін және барлық тақырыптарды сақтаңыз. Тек бастапқы тапсырманы оқыңыз; unknown немесе result_pending_check күйі қайта жасауға рұқсат бермейді.

Жауап өрістері
ӨрісТүрі
ӨрісidТүріstring
Өрісpolling_urlТүріstring
Өрісprovider_task_idТүріstring
Өрісdata.task_idТүріstring
Өрісdata.statusТүріstring
Өрісdata.data[].audio_urlТүріstring
Өрісdata.data[].image_urlТүріstring
Өрісdata.data[].image_large_urlТүріstring
Өрісdata.data[].video_urlТүріstring

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra suno-api

Әдіс жолдарының балама атаулары

Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.

Шақыруға арналған байланысты ID

suno-api

FAQ · suno-api
Қандай кіріс деректері мен нәтижелер қолжетімді?

POST /v1/music/generations · suno-api: text → audio, image, video

Сұрау қандай өрістерді пайдаланады?

POST /v1/music/generations · suno-api: model, gpt_description_prompt, mv, make_instrumental

Толығырақ

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым
Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.
50% дейінгі промокод
Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.
Тарихтағы шығындар
Әр сұрауға модель, токен және сома сақталады.

Жазылым таңдау · Модель бағасын көру

API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба
Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.
Реселлер лицензиясы
Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.
Сайттағы құжаттар
Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

Реселлер лицензиясын сұрау · Оферта мен лицензиялық шарт