{ "aboutHtml": "

Жылдамырақ кескін жасау нұсқасы

Seedream 5.0 Flash — генерация жылдамдығына басымдық беретін ағындарға арналған ByteDance Seed кескін генерациясы және өңдеу моделі. Өндірушінің Pro/Flash нұсқаулығы мәтіннен сурет және бір не бірнеше референсті суреттен сурет жасауды сипаттайды. Ол әр тапсырмаға бекітілген жауап уақытын белгілемей, Flash жылдам генерациясын Pro жоғары сурет сапасы басымдығынан ажыратады.

Негізгі ортақ мүмкіндіктер — интерактивті өңдеу, қабаттарға бөлу және бірнеше тілде тікелей генерация жасау. Қалыпты генерация бір дайын сурет қайтарады. Өндірушінің Flash ағыны ретті байланысты суреттер генерациясын, веб іздеуді немесе суретті ағынмен беруді қолдамайды. Промпт оңтайлауы standard режимін қолданады; бөлек fast оңтайлау басқаруы Flash-қа емес, Pro-ға тиесілі.

Тапсырма мен референстерден жасау

Қажетті суретті, негізгі нысанды, композицияны және көрнекі өңдеуді айтып, кейін әр референс нені басқаратынын атаңыз. Өнім көрінісінде затты анықтайтын референсті палитра не бет материалын беретіннен ажыратыңыз. «Бірінші суреттегі зат сұлбасы мен көру бұрышын сақта; екінші суретті тек бәсең фон палитрасы үшін қолдан» референстерге бөлек рөл береді.

Өндіруші қысқа промпттарды, ең көбі 300 қытай таңбасын немесе 600 ағылшын сөзін ұсынады. Бұл — мәлімделген қатаң мәтін кірісі шегі емес, дайындық бағдары. Шешуші талаптарды, соның ішінде көрінуі тиіс нақты мәтінді, қажетті арақатынасты және өзгермеуі тиіс бөлшектерді алдыға қойыңыз. Жалпы келбетке ғана сүйенбей, дайын суретті сол тізіммен салыстырыңыз.

Кеңістікпен бағытталған өңдеу

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

Өндірушінің координаттық өңдеу нұсқаулығы көрсетілген кіріс суретке қатысты 0–999-ға қалыптанған координаттары бар <point> және <bbox> тегтерін қолданады. Нүкте x пен y-ді, қорап сол жақ жоғарғы және оң жақ төменгі координаттарды қамтиды. Әсіресе қорапта бірнеше нысан болса, сурет нөмірі мен мақсатты затты атаңыз. Суреттер арасындағы өңдеуде бір референстен алынатын затты және екіншісіндегі мақсатты аумақты ажыратыңыз.

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

Композицияны өңделетін қабаттарға бөліңіз

Қабаттарға бөлу — дәл бір сурет алып, негізгі сурет пен 16-ға дейін тәуелсіз қабат қайтаратын бөлек режим. Әр қабат — alpha арнасы бар PNG. Промпт тақырып, негізгі нысан және әшекейлер сияқты бөлінетін элементтерді атай алады; бөлу промпты болмаса, модель негізгі элементтерді автоматты анықтайды.

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

Постер түзетуінде негізгі көркем суретті тақырып пен әшекейлерден бөліп, шеттерін және қалпына келтірілген фон аумақтарын тексеріңіз. Мөлдір қабатты alpha арнасы бар жалғыз кіріс ретінде өңдеп, мөлдір PNG нәтижесін алуға болады. Мөлдір фон таңдауы осы бір кірісті сурет өңдеу ағынымен шектеледі; қалыпты мәтіннен сурет генерациясы — бөлек операция.

Көптілді композиция

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

Референс файлдары және шығыс сипаттамалары

Кескін генерациясы JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC не HEIF түріндегі 10-ға дейін референс қабылдайды. Әрқайсысы 30 MB-қа дейін, екі жағы 14 пиксельден үлкен, жалпы 196–36,000,000 пиксель және арақатынасы 1:16–16:1 болуы мүмкін. Қабаттарға бөлу, керісінше, сол арақатынас ауқымында, 30 MB-қа дейінгі, 262,144–36,000,000 пиксель болатын бір JPEG не PNG талап етеді.

Генерация 1K, 1.5K және 2K шығыс деңгейлерін, әдепкі 2K-ны немесе жалпы 921,600–4,624,220 пиксель және 1:16–16:1 арақатынастағы нақты өлшемдерді ұсынады. Арнайы өлшемдерге екі шектеу де қолданылады. Қабат нәтижесі 1K, 1.5K, 2K не auto қолданады, әдепкісі — auto; негізгі сурет пен әр қабат өзіне тиісті бастапқы арақатынасты сақтайды.

Дайын суреттер JPEG не PNG болады. Негізгі сурет пішімін бөлек таңдауға болады, бөлінген қабаттар alpha бар PNG болып қалады. Жеткізу кодталған сурет дерегін немесе 24 сағат сақталатын жүктеу сілтемелерін қолдана алады. Қажетті дизайн ағынына әр қайтарылған суретті және метадерегін сақтаңыз. Мәтінді, өңделген бөлшектерді және қабат туралануын сурет қолданылатын өлшемде тексеріңіз.

", "aboutText": "Жылдамырақ кескін жасау нұсқасы\n\nSeedream 5.0 Flash — генерация жылдамдығына басымдық беретін ағындарға арналған ByteDance Seed кескін генерациясы және өңдеу моделі. Өндірушінің Pro/Flash нұсқаулығы мәтіннен сурет және бір не бірнеше референсті суреттен сурет жасауды сипаттайды. Ол әр тапсырмаға бекітілген жауап уақытын белгілемей, Flash жылдам генерациясын Pro жоғары сурет сапасы басымдығынан ажыратады.\n\nНегізгі ортақ мүмкіндіктер — интерактивті өңдеу, қабаттарға бөлу және бірнеше тілде тікелей генерация жасау. Қалыпты генерация бір дайын сурет қайтарады. Өндірушінің Flash ағыны ретті байланысты суреттер генерациясын, веб іздеуді немесе суретті ағынмен беруді қолдамайды. Промпт оңтайлауы standard режимін қолданады; бөлек fast оңтайлау басқаруы Flash-қа емес, Pro-ға тиесілі.\n\nТапсырма мен референстерден жасау\n\nҚажетті суретті, негізгі нысанды, композицияны және көрнекі өңдеуді айтып, кейін әр референс нені басқаратынын атаңыз. Өнім көрінісінде затты анықтайтын референсті палитра не бет материалын беретіннен ажыратыңыз. «Бірінші суреттегі зат сұлбасы мен көру бұрышын сақта; екінші суретті тек бәсең фон палитрасы үшін қолдан» референстерге бөлек рөл береді.\n\nӨндіруші қысқа промпттарды, ең көбі 300 қытай таңбасын немесе 600 ағылшын сөзін ұсынады. Бұл — мәлімделген қатаң мәтін кірісі шегі емес, дайындық бағдары. Шешуші талаптарды, соның ішінде көрінуі тиіс нақты мәтінді, қажетті арақатынасты және өзгермеуі тиіс бөлшектерді алдыға қойыңыз. Жалпы келбетке ғана сүйенбей, дайын суретті сол тізіммен салыстырыңыз.\n\nКеңістікпен бағытталған өңдеу\n\nFlash өңдеу орнын анықтау үшін нүктелерді, шектеуші қораптарды, бағыттауыштарды және еркін белгілерді қолдана алады. Бастапқы суретті орнымен және өзгеріспен бірге беріңіз. Интерьер тұжырымдамасында орындықты белгілеп, мата алмастыруды сұраңыз және сақталатын еденді, қабырғаны, камера бұрышын әрі жақын заттарды атаңыз. Белгілер тек бағдар болса, оларды дайын суреттен алып тастауды нақты сұраңыз.\n\nӨндірушінің координаттық өңдеу нұсқаулығы көрсетілген кіріс суретке қатысты 0–999-ға қалыптанған координаттары бар және тегтерін қолданады. Нүкте x пен y-ді, қорап сол жақ жоғарғы және оң жақ төменгі координаттарды қамтиды. Әсіресе қорапта бірнеше нысан болса, сурет нөмірі мен мақсатты затты атаңыз. Суреттер арасындағы өңдеуде бір референстен алынатын затты және екіншісіндегі мақсатты аумақты ажыратыңыз.\n\nПропорциялық орынды алғанда көрсетілген суреттің өз өлшемдерін қолданыңыз; кенеп масштабтауы, жылжытуы немесе браузер координаттары қалыптанған сурет координаттары емес. Өңделетін аумақпен бірге қорғалатын аумақтарды да сипаттаңыз. Нәтиже перспективасын, жарығын және айнала бөлшегін бастапқы көзбен салыстырыңыз.\n\nКомпозицияны өңделетін қабаттарға бөліңіз\n\nҚабаттарға бөлу — дәл бір сурет алып, негізгі сурет пен 16-ға дейін тәуелсіз қабат қайтаратын бөлек режим. Әр қабат — alpha арнасы бар PNG. Промпт тақырып, негізгі нысан және әшекейлер сияқты бөлінетін элементтерді атай алады; бөлу промпты болмаса, модель негізгі элементтерді автоматты анықтайды.\n\nНәтижелерге қабат атаулары, сипаттамалары, қабаттасу реті және орналастыру қораптары кіреді. Негізгі суретті нөлдік қабаттасу индексімен қолданып, басқа қабаттарды өсу ретімен орналастырыңыз. Абсолютті қораптар шығыс негізгі суреттегі орынды, қалыптанған қораптар басқа кенептегі пропорциялық орынды сипаттайды. Қайта орналастырмас бұрын бастапқы композицияны қалпына келтіру үшін осы орналастыру метадерегін сурет файлдарымен бірге сақтаңыз.\n\nПостер түзетуінде негізгі көркем суретті тақырып пен әшекейлерден бөліп, шеттерін және қалпына келтірілген фон аумақтарын тексеріңіз. Мөлдір қабатты alpha арнасы бар жалғыз кіріс ретінде өңдеп, мөлдір PNG нәтижесін алуға болады. Мөлдір фон таңдауы осы бір кірісті сурет өңдеу ағынымен шектеледі; қалыпты мәтіннен сурет генерациясы — бөлек операция.\n\nКөптілді композиция\n\nҚытай және ағылшыннан бөлек өндіруші орыс, араб, филиппин, тай, түрік, корей, малай, испан, португал, индонезия, француз, неміс, вьетнам және жапон тілдерінде промпт қабылдау мен сурет мәтінін жасауға тікелей қолдауын құжаттайды. Нақты бекітілген мәтін мен оқу бағытын беріп, әр мәтін блогы орналасатын аумақты атаңыз. Соңғы суретте диакритикалық белгілерді, жалғанған таңбаларды, жол бөлінуін және ұсақ белгілерді тексеріңіз.\n\nРеференс файлдары және шығыс сипаттамалары\n\nКескін генерациясы JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC не HEIF түріндегі 10-ға дейін референс қабылдайды. Әрқайсысы 30 MB-қа дейін, екі жағы 14 пиксельден үлкен, жалпы 196–36,000,000 пиксель және арақатынасы 1:16–16:1 болуы мүмкін. Қабаттарға бөлу, керісінше, сол арақатынас ауқымында, 30 MB-қа дейінгі, 262,144–36,000,000 пиксель болатын бір JPEG не PNG талап етеді.\n\nГенерация 1K, 1.5K және 2K шығыс деңгейлерін, әдепкі 2K-ны немесе жалпы 921,600–4,624,220 пиксель және 1:16–16:1 арақатынастағы нақты өлшемдерді ұсынады. Арнайы өлшемдерге екі шектеу де қолданылады. Қабат нәтижесі 1K, 1.5K, 2K не auto қолданады, әдепкісі — auto; негізгі сурет пен әр қабат өзіне тиісті бастапқы арақатынасты сақтайды.\n\nДайын суреттер JPEG не PNG болады. Негізгі сурет пішімін бөлек таңдауға болады, бөлінген қабаттар alpha бар PNG болып қалады. Жеткізу кодталған сурет дерегін немесе 24 сағат сақталатын жүктеу сілтемелерін қолдана алады. Қажетті дизайн ағынына әр қайтарылған суретті және метадерегін сақтаңыз. Мәтінді, өңделген бөлшектерді және қабат туралануын сурет қолданылатын өлшемде тексеріңіз.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "05e2ff425a3cc5c398122ad4dbb58f93255a353826c5c6692b5eabbd187f3c4c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "
•

ByteDance Seed: Seedream 5.0 Flash

ByteDance Seed /bytedance-seed/seedream-5-0-flash

Бастау

Мәтіндік тапсырма бойынша бір дайын кескін жасаңыз.

  • Өнімнің статикалық кескінін жасаңыз
  • Визуалды тұжырымдаманы зерттеңіз
  • Көріністі бейнелеңіз
Қабылданатын кіріс деректері
Мәтін
Нәтижелер
Суреттер
Модель туралы

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

Жылдамырақ кескін жасау нұсқасы

Seedream 5.0 Flash — генерация жылдамдығына басымдық беретін ағындарға арналған ByteDance Seed кескін генерациясы және өңдеу моделі. Өндірушінің Pro/Flash нұсқаулығы мәтіннен сурет және бір не бірнеше референсті суреттен сурет жасауды сипаттайды. Ол әр тапсырмаға бекітілген жауап уақытын белгілемей, Flash жылдам генерациясын Pro жоғары сурет сапасы басымдығынан ажыратады.

Негізгі ортақ мүмкіндіктер — интерактивті өңдеу, қабаттарға бөлу және бірнеше тілде тікелей генерация жасау. Қалыпты генерация бір дайын сурет қайтарады. Өндірушінің Flash ағыны ретті байланысты суреттер генерациясын, веб іздеуді немесе суретті ағынмен беруді қолдамайды. Промпт оңтайлауы standard режимін қолданады; бөлек fast оңтайлау басқаруы Flash-қа емес, Pro-ға тиесілі.

Тапсырма мен референстерден жасау

Қажетті суретті, негізгі нысанды, композицияны және көрнекі өңдеуді айтып, кейін әр референс нені басқаратынын атаңыз. Өнім көрінісінде затты анықтайтын референсті палитра не бет материалын беретіннен ажыратыңыз. «Бірінші суреттегі зат сұлбасы мен көру бұрышын сақта; екінші суретті тек бәсең фон палитрасы үшін қолдан» референстерге бөлек рөл береді.

Өндіруші қысқа промпттарды, ең көбі 300 қытай таңбасын немесе 600 ағылшын сөзін ұсынады. Бұл — мәлімделген қатаң мәтін кірісі шегі емес, дайындық бағдары. Шешуші талаптарды, соның ішінде көрінуі тиіс нақты мәтінді, қажетті арақатынасты және өзгермеуі тиіс бөлшектерді алдыға қойыңыз. Жалпы келбетке ғана сүйенбей, дайын суретті сол тізіммен салыстырыңыз.

Кеңістікпен бағытталған өңдеу

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

Өндірушінің координаттық өңдеу нұсқаулығы көрсетілген кіріс суретке қатысты 0–999-ға қалыптанған координаттары бар <point> және <bbox> тегтерін қолданады. Нүкте x пен y-ді, қорап сол жақ жоғарғы және оң жақ төменгі координаттарды қамтиды. Әсіресе қорапта бірнеше нысан болса, сурет нөмірі мен мақсатты затты атаңыз. Суреттер арасындағы өңдеуде бір референстен алынатын затты және екіншісіндегі мақсатты аумақты ажыратыңыз.

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

Композицияны өңделетін қабаттарға бөліңіз

Қабаттарға бөлу — дәл бір сурет алып, негізгі сурет пен 16-ға дейін тәуелсіз қабат қайтаратын бөлек режим. Әр қабат — alpha арнасы бар PNG. Промпт тақырып, негізгі нысан және әшекейлер сияқты бөлінетін элементтерді атай алады; бөлу промпты болмаса, модель негізгі элементтерді автоматты анықтайды.

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

Постер түзетуінде негізгі көркем суретті тақырып пен әшекейлерден бөліп, шеттерін және қалпына келтірілген фон аумақтарын тексеріңіз. Мөлдір қабатты alpha арнасы бар жалғыз кіріс ретінде өңдеп, мөлдір PNG нәтижесін алуға болады. Мөлдір фон таңдауы осы бір кірісті сурет өңдеу ағынымен шектеледі; қалыпты мәтіннен сурет генерациясы — бөлек операция.

Көптілді композиция

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

Референс файлдары және шығыс сипаттамалары

Кескін генерациясы JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC не HEIF түріндегі 10-ға дейін референс қабылдайды. Әрқайсысы 30 MB-қа дейін, екі жағы 14 пиксельден үлкен, жалпы 196–36,000,000 пиксель және арақатынасы 1:16–16:1 болуы мүмкін. Қабаттарға бөлу, керісінше, сол арақатынас ауқымында, 30 MB-қа дейінгі, 262,144–36,000,000 пиксель болатын бір JPEG не PNG талап етеді.

Генерация 1K, 1.5K және 2K шығыс деңгейлерін, әдепкі 2K-ны немесе жалпы 921,600–4,624,220 пиксель және 1:16–16:1 арақатынастағы нақты өлшемдерді ұсынады. Арнайы өлшемдерге екі шектеу де қолданылады. Қабат нәтижесі 1K, 1.5K, 2K не auto қолданады, әдепкісі — auto; негізгі сурет пен әр қабат өзіне тиісті бастапқы арақатынасты сақтайды.

Дайын суреттер JPEG не PNG болады. Негізгі сурет пішімін бөлек таңдауға болады, бөлінген қабаттар alpha бар PNG болып қалады. Жеткізу кодталған сурет дерегін немесе 24 сағат сақталатын жүктеу сілтемелерін қолдана алады. Қажетті дизайн ағынына әр қайтарылған суретті және метадерегін сақтаңыз. Мәтінді, өңделген бөлшектерді және қабат туралануын сурет қолданылатын өлшемде тексеріңіз.

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

Ailoot Ultra · Суреттер POST /v1/images/generations
Кіріс
text
Шығыс
image
Шығыс пішімі
Сурет файлы
Нәтижелер саны
1 шығыс
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
bytedance-seed/seedream-5-0-flash
Әдепкі—
ӨрісpromptТүріstringТалапМіндеттіМәндер мен шектеулер
Ең аз ұзындық: 1
Шарттар: Бос емес UTF8 промпты. Өндірушінің барлық модельдеріне ортақ таңба шегі ойдан қосылмайды.
Әдепкі—
ӨрісnТүріintegerТалапМіндетті емесМәндер мен шектеулер
1
Әдепкі1
Өрісresponse_formatТүріstringТалапМіндетті емесМәндер мен шектеулер
url, b64_json
Әдепкі—
ӨрісstreamТүріbooleanТалапМіндетті емесМәндер мен шектеулер
false
Әдепкіfalse
Кіріс материалдарының үйлесімдері

Мәтіннен сурет жасау · Міндетті: prompt

Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, prompt
Параметрmaterial_typesПараметр талаптарыtext
ПараметрoptionalПараметр талаптарыn, response_format, stream
ПараметрnПараметр талаптары1
ПараметрstreamПараметр талаптарыfalse
Параметрresponse_formatПараметр талаптарыurl, b64_json
Параметрreference_imagesПараметр талаптарыfalse
ПараметрeditПараметр талаптарыfalse
Параметрoutput_format_optionalПараметр талаптары
Параметрresolution_controlПараметр талаптарыnull
Параметрaspect_ratio_controlПараметр талаптарыnull
Параметрother_fieldsПараметр талаптарыдәл бекітілген ішкі жеткізуші маршрутизациясынан басқасының бәрі қабылданбайды

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

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Промпт бойынша бір сурет жасаңыз.

Әрбір дерек элементін сақтаңыз; url/b64_json — нәтижені кодтау пішімдері.

Тарифтер

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

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

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

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

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

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

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

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

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

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

Анықтамалық тариф мәліметтері

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.

Суреттердің баға конфигурациялары

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

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

БаптауТөлемді есептеу шарттарыТөлем
БаптауШығыс суретіТөлемді есептеу шарттарыБаға нұсқасы мәлімделмеген.Төлем
Шығыс · Шығыс кескін $0.036 сурет үшін
БаптауКіріс суретіТөлемді есептеу шарттарыБаға нұсқасы мәлімделмеген.Төлем
Кіріс · Кіріс кескін $0 сурет үшін

Баламалы жазбалар бір төлемді сипаттайды; олар екінші алым қоспайды.

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

Ailoot Ultra · Суреттер

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "bytedance-seed/seedream-5-0-flash", "prompt": "A lighthouse on a cliff, watercolor", "n": 1, "response_format": "b64_json"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n    if not items: raise SystemExit("No completed images; retain the full response")\n    for index, item in enumerate(items):\n        encoded=item.get("b64_json")\n        uri=item.get("url", "")\n        if not encoded and uri.startswith("data:image/"):\n            header, separator, encoded=uri.partition(",")\n            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n        if encoded:\n            raw=base64.b64decode(encoded,validate=True)\n        elif uri:\n            uri=urljoin("https://api.ailoot.ai",uri)\n            parsed=urlsplit(uri)\n            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n                raise SystemExit("Invalid returned image URL")\n            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n            args=["curl","--fail-with-body","--silent","--show-error",uri]\n            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n            temporary=Path(f"image-{index}.bin")\n            subprocess.run(args+["-o",str(temporary)],check=True)\n            raw=temporary.read_bytes()\n            temporary.unlink()\n        else: raise SystemExit("Image has neither bytes nor URL")\n        if not raw: raise SystemExit("Empty image result")\n        ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n        Path(f"image-{index}.{ext}").write_bytes(raw)\n    print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n

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

Ailoot Ultra · Суреттер

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

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

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.

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

Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз.

Жауап өрістері
ӨрісТүрі
ӨрісcreatedТүріinteger
Өрісdata[].urlТүріstring
Өрісdata[].b64_jsonТүріbase64 string
ӨрісusageТүріobject
Қателер және келесі қадамдар
ЖауапШартКелесі қадам
Жауап400 · invalid_request_errorШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қатеКелесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.
Жауапserver_errorШартҚайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілгенКелесі қадамБастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.

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

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

Ailoot Ultra bytedance-seed/seedream-5-0-flash

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

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

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

bytedance-seed/seedream-5-0-flash

", "method_identity": { "effective_request_model_id": "bytedance-seed/seedream-5-0-flash", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "bytedance-seed/seedream-5-0-flash", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|bytedance-seed%2Fseedream-5-0-flash", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Міндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате", "http_status": 400, "recovery": "Жаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.", "type": "invalid_request_error" }, { "code": null, "condition": "Қайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген", "http_status": null, "recovery": "Бастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Бос емес UTF8 промпты. Өндірушінің барлық модельдеріне ортақ таңба шегі ойдан қосылмайды.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Промпт бойынша бір сурет жасаңыз.", "Әрбір дерек элементін сақтаңыз; url/b64_json — нәтижені кодтау пішімдері." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "дәл бекітілген ішкі жеткізуші маршрутизациясынан басқасының бәрі қабылданбайды", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Нақты қайтарылған task_id немесе медиатека жазбасы", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "кіріс суреті", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\" және тегтерін қолданады. Нүкте x пен y-ді, қорап сол жақ жоғарғы және оң жақ төменгі координаттарды қамтиды. Әсіресе қорапта бірнеше нысан болса, сурет нөмірі мен мақсатты затты атаңыз. Суреттер арасындағы өңдеуде бір референстен алынатын затты және екіншісіндегі мақсатты аумақты ажыратыңыз.\n\nПропорциялық орынды алғанда көрсетілген суреттің өз өлшемдерін қолданыңыз; кенеп масштабтауы, жылжытуы немесе браузер координаттары қалыптанған сурет координаттары емес. Өңделетін аумақпен бірге қорғалатын аумақтарды да сипаттаңыз. Нәтиже перспективасын, жарығын және айнала бөлшегін бастапқы көзбен салыстырыңыз.\n\nКомпозицияны өңделетін қабаттарға бөліңіз\n\nҚабаттарға бөлу — дәл бір сурет алып, негізгі сурет пен 16-ға дейін тәуелсіз қабат қайтаратын бөлек режим. Әр қабат — alpha арнасы бар PNG. Промпт тақырып, негізгі нысан және әшекейлер сияқты бөлінетін элементтерді атай алады; бөлу промпты болмаса, модель негізгі элементтерді автоматты анықтайды.\n\nНәтижелерге қабат атаулары, сипаттамалары, қабаттасу реті және орналастыру қораптары кіреді. Негізгі суретті нөлдік қабаттасу индексімен қолданып, басқа қабаттарды өсу ретімен орналастырыңыз. Абсолютті қораптар шығыс негізгі суреттегі орынды, қалыптанған қораптар басқа кенептегі пропорциялық орынды сипаттайды. Қайта орналастырмас бұрын бастапқы композицияны қалпына келтіру үшін осы орналастыру метадерегін сурет файлдарымен бірге сақтаңыз.\n\nПостер түзетуінде негізгі көркем суретті тақырып пен әшекейлерден бөліп, шеттерін және қалпына келтірілген фон аумақтарын тексеріңіз. Мөлдір қабатты alpha арнасы бар жалғыз кіріс ретінде өңдеп, мөлдір PNG нәтижесін алуға болады. Мөлдір фон таңдауы осы бір кірісті сурет өңдеу ағынымен шектеледі; қалыпты мәтіннен сурет генерациясы — бөлек операция.\n\nКөптілді композиция\n\nҚытай және ағылшыннан бөлек өндіруші орыс, араб, филиппин, тай, түрік, корей, малай, испан, португал, индонезия, француз, неміс, вьетнам және жапон тілдерінде промпт қабылдау мен сурет мәтінін жасауға тікелей қолдауын құжаттайды. Нақты бекітілген мәтін мен оқу бағытын беріп, әр мәтін блогы орналасатын аумақты атаңыз. Соңғы суретте диакритикалық белгілерді, жалғанған таңбаларды, жол бөлінуін және ұсақ белгілерді тексеріңіз.\n\nРеференс файлдары және шығыс сипаттамалары\n\nКескін генерациясы JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC не HEIF түріндегі 10-ға дейін референс қабылдайды. Әрқайсысы 30 MB-қа дейін, екі жағы 14 пиксельден үлкен, жалпы 196–36,000,000 пиксель және арақатынасы 1:16–16:1 болуы мүмкін. Қабаттарға бөлу, керісінше, сол арақатынас ауқымында, 30 MB-қа дейінгі, 262,144–36,000,000 пиксель болатын бір JPEG не PNG талап етеді.\n\nГенерация 1K, 1.5K және 2K шығыс деңгейлерін, әдепкі 2K-ны немесе жалпы 921,600–4,624,220 пиксель және 1:16–16:1 арақатынастағы нақты өлшемдерді ұсынады. Арнайы өлшемдерге екі шектеу де қолданылады. Қабат нәтижесі 1K, 1.5K, 2K не auto қолданады, әдепкісі — auto; негізгі сурет пен әр қабат өзіне тиісті бастапқы арақатынасты сақтайды.\n\nДайын суреттер JPEG не PNG болады. Негізгі сурет пішімін бөлек таңдауға болады, бөлінген қабаттар alpha бар PNG болып қалады. Жеткізу кодталған сурет дерегін немесе 24 сағат сақталатын жүктеу сілтемелерін қолдана алады. Қажетті дизайн ағынына әр қайтарылған суретті және метадерегін сақтаңыз. Мәтінді, өңделген бөлшектерді және қабат туралануын сурет қолданылатын өлшемде тексеріңіз.", "alias_of": null, "aliases": [], "author": "ByteDance Seed", "available": null, "canonical_model": "bytedance-seed/seedream-5-0-flash", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "image" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Конфигурация бағалары туралы толық ақпарат — егжей-тегжейлі мәліметтерде." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "c28268da12f5c8a4b252dcc4", "label": "Суреттердің баға конфигурациялары", "profiles": [ { "basis": "Баламалы жазбалар бір төлемді сипаттайды; олар екінші алым қоспайды.", "dimensions": { "conditions": "Баға нұсқасы мәлімделмеген." }, "label": "Шығыс суреті", "units": [ { "amount": "0.036", "amount_unit": "usd_per_image", "billing_input": false, "key": "output_image", "label": "Output image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "out", "unit": "image" } ] }, { "basis": "Баламалы жазбалар бір төлемді сипаттайды; олар екінші алым қоспайды.", "dimensions": { "conditions": "Баға нұсқасы мәлімделмеген." }, "label": "Кіріс суреті", "units": [ { "amount": "0", "amount_unit": "usd_per_image", "billing_input": false, "key": "input_image", "label": "Input image", "public_unit_label": "per image", "quantity": 1, "rate_role": "typed_image_reference", "side": "in", "unit": "image" } ] } ] } ], "entity_type": "model", "formats": [ "images" ], "id": "bytedance-seed/seedream-5-0-flash", "input": [ "text" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "Міндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате", "http_status": 400, "recovery": "Жаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.", "type": "invalid_request_error" }, { "code": null, "condition": "Қайтарылған жауапта операцияны немесе нәтижені тексеру қажет екені көрсетілген", "http_status": null, "recovery": "Бастапқыда қайтарылған операцияның/тапсырманың ID мәнін, сұрау тақырыптарын және жауабын сақтаңыз; сол бастапқы операцияны қолдау көрсетілетін тәсілдермен оқуды жалғастырыңыз. Жасау сұрауын қайта жібермеңіз.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Кескінді генерациялау немесе өңдеу нәтижесін тексеру қажет болса, бастапқы operation_id/X-Client-Request-ID мәнін және қайтарылған нәтиже туралы ақпаратты сақтаңыз. Нақты task_id немесе asset_id мәндерін қолданып, өзіңізге тиесілі бұрыннан бар нәтижелерді медиатека арқылы қалпына келтіріңіз. Генерациялау/өңдеу сұрауын қайта жібермеңіз және operation_id мәнінен күйді сұратуға арналған URL мекенжайын құрастырмаңыз." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_image", "reference_images": false, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "Әрбір дерек элементін сақтаңыз. Әрбір b64_json мәнін декодтаңыз немесе қайтарылған әрбір қолтаңбаланған URL мекенжайынан жүктеп алыңыз. Файл атауының кеңейтімін нақты MIME түріне/байттарға қарап таңдаңыз.", "count": 1, "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance-seed/seedream-5-0-flash" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "conditions": "Бос емес UTF8 промпты. Өндірушінің барлық модельдеріне ортақ таңба шегі ойдан қосылмайды.", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": [ 1 ], "enum_known": true, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": [ false ], "enum_known": true, "name": "stream", "required": false, "type": "boolean" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "image edits/references", "resolution/size", "aspect_ratio", "stream=true", "n other than1", "other fields outside this exact facade profile", "output_format field must be omitted" ] }, "hints": [ "Промпт бойынша бір сурет жасаңыз.", "Әрбір дерек элементін сақтаңыз; url/b64_json — нәтижені кодтау пішімдері." ], "input": { "aspect_ratio_control": null, "content_type": "application/json", "edit": false, "material_types": [ "text" ], "n": [ 1 ], "optional": [ "n", "response_format", "stream" ], "other_fields": "дәл бекітілген ішкі жеткізуші маршрутизациясынан басқасының бәрі қабылданбайды", "output_format_optional": [], "reference_images": false, "required": [ "model", "prompt" ], "resolution_control": null, "response_format": [ "url", "b64_json" ], "stream": [ false ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "Нақты қайтарылған task_id немесе медиатека жазбасы", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "manufacturer_capability": null, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "operation_modes": [ "text_to_image" ], "output": { "count": 1, "family": "image", "format": "validated raster MIME", "result": "actual owned URL or b64_json" } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per input image" }, "label": "кіріс суреті", "units": [ { "amount": "0", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_input", "label": "input image", "native_amount_usd_per_unit": "0", "native_quantity": 1, "public_unit_label": "per input image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "image_input" } ] }, { "dimensions": { "quoted_unit": "per image output" }, "label": "Ultra", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_physical_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "image output", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "per image output", "quantity": "1", "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Генерацияның болжамды құны", "units": [ { "amount": "0.036", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.036", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{\"model\": \"bytedance-seed/seedream-5-0-flash\", \"prompt\": \"A lighthouse on a cliff, watercolor\", \"n\": 1, \"response_format\": \"b64_json\"}')\n\nPath(\"request.json\").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit(\"No completed images; retain the full response\")\n for index, item in enumerate(items):\n encoded=item.get(\"b64_json\")\n uri=item.get(\"url\", \"\")\n if not encoded and uri.startswith(\"data:image/\"):\n header, separator, encoded=uri.partition(\",\")\n if not separator or \";base64\" not in header: raise SystemExit(\"Unsupported image data URI\")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin(\"https://api.ailoot.ai\",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!=\"https\" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit(\"Invalid returned image URL\")\n owned=parsed.netloc==\"api.ailoot.ai\" and parsed.path.startswith(\"/v1/media/assets/\") and parsed.path.endswith(\"/content\")\n args=[\"curl\",\"--fail-with-body\",\"--silent\",\"--show-error\",uri]\n if owned: args += [\"-H\",\"Authorization: Bearer \"+os.environ[\"AILOOT_API_KEY\"]]\n temporary=Path(f\"image-{index}.bin\")\n subprocess.run(args+[\"-o\",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit(\"Image has neither bytes nor URL\")\n if not raw: raise SystemExit(\"Empty image result\")\n ext=\"png\" if raw.startswith(b\"\\x89PNG\") else \"jpg\" if raw.startswith(b\"\\xff\\xd8\") else \"webp\" if raw[:4]==b\"RIFF\" and raw[8:12]==b\"WEBP\" else \"svg\" if raw.lstrip().startswith((b\"