Source: https://ailoot.ai/models/kk/suno-api/ Canonical: https://ailoot.ai/models/kk/suno-api/ Language: kk # suno-api [Markdown](https://ailoot.ai/models/kk/suno-api/index.md) · [JSON](https://ailoot.ai/models/kk/suno-api/facts.json) ## [suno-api](https://ailoot.ai/models/kk/suno-api/) Suno қысқа жазбаша идеядан музыка жасайды. Құжатталған автоматты үдеріс екі ән шығарады және аспаптық нұсқаны таңдауға мүмкіндік береді; дайын аудио мен трек метадеректері генерация тапсырмасы арқылы қайтарылады. - [**Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api`](https://ailoot.ai/models/kk/suno-api/#method-0) Модель туралы Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген. Suno — жазбаша идеяны әнге айналдыратын музыка генерациялау қызметі. Құжатталған автоматты үдеріс көзделген музыканың қысқа сипаттамасын және аспаптық нұсқа таңдауын қабылдап, екі ән жасайды. Дайын тректерден естігіңіз келетін тақырыпты, көңіл күйді және музыкалық бағытты белгілеу үшін тапсырма сипаттамасын қолданыңыз. Алдымен музыканың атқаратын рөлін анықтаңыз. Түсіндірмеге арналған тыныш фон, қысқа видеоның серпінді басталуы немесе сапар туралы ойлы ән тапсырмаға нақты мақсат береді. Көзделген көңіл күйді және сол мақсатқа маңызды музыкалық ерекшеліктерді бірнеше анық тіркеспен сипаттаңыз. Вокалы бар ән үшін шығармашылық тапсырмада тақырып пен тілді анық көрсетіңіз. Трек жеткізуі тиіс идеяны және орындау арқылы берілуі тиіс реңкті сипаттаңыз. Дайын нәтижені тыңдап, вокалдың, сөздердің және аранжировканың қалай үйлесетінін бағалаңыз. Қарап шығу үшін жасалған трек туралы ақпаратты аудиомен бірге сақтаңыз. Аспаптық нәтиже үшін құжатталған аспаптық нұсқа таңдауын қолданып, музыкалық бағытты мәтінде сипаттаңыз. Жоба үшін маңызды болса, қажетті атмосфераны және негізгі аспаптарды көрсетіңіз. Дайын тректі монтажда алатын орнына қарай бағалаңыз, соның ішінде сөзге фон ретінде естілуі немесе визуалдық ауысуды сүйемелдеуі тиіс бөліктерін тексеріңіз. Автоматты үдеріс жіберілген идеядан екі ән жасайды. Оларды бөлек нұсқалар ретінде қарастырып, дайын екі аудиофайлды да сақтаңыз. Әрқайсысын басталуын, даму барысын және аяқталуын қоса толық тыңдаңыз. Нақты тректерді бірдей мақсатқа сай салыстырыңыз, соның ішінде көңіл күйін, аранжировкасын және жоспарланған қолданысқа жарамдылығын бағалаңыз. Генерация тапсырма түрінде ұйымдастырылады. Нәтижесін тексергенде қайтарылған тапсырма ID мәнін сақтап, дайын тректерді әлі орындалып жатқан элементтерден ажыратыңыз. Құжатталған нәтижеде атауы, күйі, аудионың орналасуы және ұзақтығы сияқты әр трекке қатысты ақпарат бар. Дайын аудионың өзін қолжетімді метадеректермен және бастапқы тапсырмамен бірге сақтаңыз. Видео немесе таныстырылым үшін таңдалған музыканы нақты материалмен бірге тыңдап көріңіз. Басталуын, ауысуларын және аяқталуын көзделген дыбыс деңгейінде тексеріңіз. Монтажға қызмет ететін бөлікті белгілеп, кейінгі өзгерістер үшін толық тректі сақтаңыз. Музыкалық үзіндінің жарамдылығы дайын туындының даусымен, бейнелерімен және ырғағымен бірлікте бағаланады. Жазбаша идеяны, аспаптық нұсқа таңдауын, модель таңдауын және барлық дайын тректерді бірге сақтаңыз. Нұсқаны түзету қажет болса, сөзге фон болғанда тым тығыз естілетін аранжировка немесе тым баяу дамитын басталу сияқты музыкалық сәйкессіздікті анықтаңыз. Пайдалы бағытты сақтап, тапсырманың сол мәселеге қатысты бөлігін өзгертіңіз. **Ailoot Ultra · Music** `POST /v1/music/generations` `suno-api` [`suno-api`](https://ailoot.ai/models/kk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) 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 сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. [Резервтеу мен төлемді есептеу тәртібі →](https://ailoot.ai/docs/kk/billing/reserve/) ### Сұрау мысалдары #### Ailoot Ultra · Music curl · бір рет құрып, қабылдау жазбасын сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз ```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 ``` ### Нәтижелерді алу және сақтау #### 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`](https://ailoot.ai/models/kk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) #### Әдіс жолдарының балама атаулары Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз. #### Шақыруға арналған байланысты ID [`suno-api`](https://ailoot.ai/models/kk/#m=suno-api&route=Ultra&caller=suno-api&fmt=music) 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% дейінгі промокод Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі. Тарихтағы шығындар Әр сұрауға модель, токен және сома сақталады. [Жазылым таңдау](https://ailoot.ai/docs/kk/billing/subscriptions/) · [Модель бағасын көру](https://ailoot.ai/models/kk/) ## API-ді сататын өніміңізге қосыңыз. SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз. Коммерциялық қолданба Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз. Реселлер лицензиясы Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз. Сайттағы құжаттар Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді. [Реселлер лицензиясын сұрау](mailto:support@ailoot.ai) · [Оферта мен лицензиялық шарт](https://ailoot.ai/legal/offer?lang=kk) ## Ailoot · Компания және оның жобалар портфелі Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді. Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі. Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.