ByteDance: Seedance 2.0 Mini
Seedance 2.0 Mini мәтіннен, сурет, бейне және аудио референстерінен міндетті емес жасалған дыбысы бар қысқа бейнелер жасайды. Ол көрініс жасауды, бейненің нысаналы түзетулерін және жалғастыруды қолдайды; құжатталған нәтиже профилі — 480p немесе 720p.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Seedance 2.0 Mini — ByteDance-тың Seedance 2.0 аудиовизуалды тобындағы бөлек аталған модель. Өндіруші мәтіннен бейне жасауды, бірінші кадрдан және бірінші-соңғы кадрдан суретті бейнеге айналдыруды, мультимодалды референс генерациясын, бейне өңдеуді және бейне ұзартуды құжаттайды. Дыбыс суретпен бірге жасала алады. Жасау режимін бар материалыңызға сай таңдаңыз: жазбаша тапсырма, бекітілген бастапқы сурет, екі шекаралық кадр немесе өңдеу не жалғастыру қажет клип.
Mini моделінің өз нәтиже профилі бар. Өндіруші 8-биттік түспен, секундына 24 кадрмен және MP4 нәтижесімен 480p және 720p бейнені атайды. Қолдау көрсетілетін арақатынастары — 21:9, 16:9, 4:3, 1:1, 3:4 және 9:16; құжатталған генерация ұзақтығы — 4–15 секунд. Өндірушінің ұзақтық параметрі осы аралықта автоматты таңдауға да мүмкіндік береді. Толық Seedance 2.0 моделінің 1080p және 4K нұсқалары бөлек; олар Mini баптаулары емес. Топ мүмкіндіктері кестесінде соңғы жасалған кадрды қайтару көрсетілген, ал Draft режимі қолдау таппайды.
Omni reference берілген материалдан таңдалған ақпаратты қолданып жаңа көрініс жасайды. Сурет нысанның келбетін, композициясын немесе визуалды өңдеуін анықтай алады. Бейне әрекетті, камера қозғалысын немесе әсерді; аудио референс дауыс тембрін, әуенді немесе айтылатын мазмұнды анықтай алады. Әр қасиетті көшіруді сұрамай, модельге әр референстен не алу керегін айтыңыз. Мысалы, өнім фотосын пішін мен түске, қысқа камера қозғалысы клипін жақындауға, дыбыс референсін атмосфераға қолданыңыз.
Топ үдерісі тоғызға дейін референстік суретке, үш бейнеклипке және үш аудиоклипке мүмкіндік береді. Бейне референстердің әрқайсысы 2–15 секунд, жиынтығы 15 секундтан аспайды; аудио референстерде де әр клип пен жалпы ұзақтық шектері сондай. Тек аудио және визуалды референссіз мәтін мен аудио тіркесімі қолдау таппайды. Тек мәтіннен жасау — бөлек қолдау көрсетілетін режим. Тізбек үшін материалдарды қажетті ретпен беріп, әр медиа түрі ішіндегі ретті қолданып оларды Image 1, Video 1 немесе Audio 1 деп бірізді атаңыз. Жазбаша нұсқауда нөмірленген референсті материал идентификаторымен алмастырмаңыз.
Бірінші кадр суреті суретке негізделген кадрдың басталуын анықтайды. Бірінші-соңғы кадр режимі екі шекараны да анықтайды. Дәл осы шекаралық суреттер маңызды болса, omni-reference нұсқауында референстерді басталу мен аяқталу деп сипаттаудың орнына арнайы режимді таңдаңыз. Соңғысы — нұсқаумен бағытталған әсер, қатаң шекаралық кадр таңдауына тең емес. Суреттерді нәтиже композициясына дайындап, бастапқы және соңғы жағдайды жалғайтын әрекетті айтыңыз.
Бейне өңдеу бар клипті тек шабыт ретінде қолданбай, оны өзгертеді. Өңделетін бейнені, өзгеретін нысанды немесе аймақты, оның көріну уақыты мен орнын және сақталатын бөлшектерді көрсетіңіз. Пайдалы тапсырма: «Video 1 ішінде саптыаяқты Image 1 суретіндегі ыдыспен алмастырыңыз; қол қозғалысын, кадрлауды, жарықты және үстел орналасуын сақтаңыз». Алып тастау үшін қажетсіз нысанды және қалуы тиіс айнала элементтерді атаңыз. Жасаушы өңдеу не ұзарту үшін мақсатты бейнеге тікелей сілтеуді ұсынады; оны референс деп атау жаңадан жасалатын көрініс сұрауын жеткізуі мүмкін.
Бейне ұзарту бар клиптің алдына немесе артына оқиғалар қосады. Жалғастыру бағытын және әрі қарай не бұрын не болатынын сипаттаңыз. Құжатталған үдеріс екі не үш клипті жасалған ауысулармен жалғай да алады; үш кіріс бейненің барлығы бәрібір 15 секундтық референс бюджетіне сыяды. Оқулық негізінен бастапқы клиптің шекаралық кадрларын қамтитын жалғастыруды бастапқы мазмұнды анық сақтайтын сұраудан ажыратады. Нәтиженің қажетті құрамын айтыңыз: тек жалғасы ма, әлде берілген клип пен жаңа әрекетті қамтитын көрініс пе.
Анық бағыттау үшін тұрақты көрініс сипаттамасын оқиғалар тізбегінен бөліңіз. Әр нысанды екі не үш айрықша визуалды белгімен және бірізді атаумен анықтаңыз. Кейін әрекеттерді, ортаны, жарықты, камера қозғалысын, визуалды стильді және шектеулерді сипаттаңыз. Диалогта әр репликаны сөйлеушісімен және тиісті әрекетпен байланыстырыңыз. Нақты уақыт белгілерін сенімді параметр деп қабылдамай, ретті кадр атауларын қолданыңыз: жасаушы дәл уақыт тұрақсыз болуы мүмкін дейді. Кезеңді өнім тапсырмасы былай болуы мүмкін: «Image 1 Product A нысанын анықтайды. Shot 1: үстелдегі Product A нысанына баяу жақындаңыз. Shot 2: қол оны жарыққа қарай бұрады. Shot 3: алдыңғы жапсырмаға тоқтаңыз. Бөлменің жұмсақ фондық дыбысы; басылған жазуды сақтаңыз».
Референстерді құжатталған топ кіріс ережелеріне дайындаңыз. Қолдау көрсетілетін сурет пішімдері — JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC және HEIF; әр сурет 30 MB-тан кіші. Нұсқаулық сурет ені мен биіктігін қатаң түрде 300 және 6,000 пиксель арасында, арақатынасын қатаң түрде 0.4 және 2.5 арасында белгілейді. Бейне референстер H.264 немесе H.265 бейнесі және AAC не MP3 аудиосы бар MP4 не MOV қолданады, әрқайсысы ең көбі 200 MB және секундына 24–60 кадр. Ені мен биіктігі — 300–6,000 пиксель, арақатынасы — 0.4–2.5, жалпы пиксель саны — 407,696–8,295,044. Аудио референстер WAV немесе MP3 қолданады, әрқайсысы ең көбі 15 MB. Бұлар — белгілі бір қолданбаның жүктеу параметрлерінен бөлек өндірушінің кіріс дайындау сипаттамалары.
Жасаушының портрет үдерісі нақты адам беті бар суреттерге не бейнелерге арнайы дайындық талап етеді: референсті тікелей жүктеу стандартты қолдау көрсетілетін жол емес. Ол сенімді модель нәтижелерін, дайын цифрлық кейіпкерлерді және рұқсат етілген нақты адам материалы үдерісін бөлек шешімдер ретінде құжаттайды. Дауыс сәйкестігі, айтылым және клип шекарасындағы дыбыс та тексеруді қажет етеді. Нұсқау нұсқаулығы қажетті дауыс сипаттарын сипаттап, диалог стилін аудио референске жақын ұстауды ұсынады. Соңғы материалды нысан бірізділігі, нақты айтылған сөздер, әрекет уақыты, кадр ауысулары және аяқталу аудиосы бойынша тексеріп, тапсырмадан ерекшеленген нақты элементті жетілдіріңіз.
Ailoot Ultra · Бейне POST /v1/videos bytedance/seedance-2.0-mini
bytedance/seedance-2.0-miniБастау
Seedance 2.0 Mini мәтіннен, сурет, бейне және аудио референстерінен міндетті емес жасалған дыбысы бар қысқа бейнелер жасайды. Ол көрініс жасауды, бейненің нысаналы түзетулерін және жалғастыруды қолдайды; құжатталған нәтиже профилі — 480p немесе 720p.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер · Аудио
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image,audio- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер bytedance/seedance-2.0-mini | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ең азы: 1 Ең көбі: 600 | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480p, 720p | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Әдепкі— |
Өрісgenerate_audio | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false, true Шарттар: generate_audio өрісін қоспау аудиосы бар бағаны, ал false мәні аудиосыз бағаны таңдайды. Аудиожол қайтарылғанын білу үшін нәтижедегі has_audio өрісін тексеріңіз. | Әдепкі— |
Өрісframe_images | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 2 Кіріс мазмұны: Кадр объектілерінің массиві. Әрқайсысында type=image_url, ішінде url бар image_url және frame_type=first_frame немесе last_frame болады. Әр рөл ең көбі бір рет кездеседі. Жалпыға қолжетімді HTTPS URL мекенжайларын қолданыңыз. Нақты кілттер: type, image_url, frame_type Шарттар: Бұл кілттер әр кадр объектісіне қолданылады. Тек мәтіндік сұрауда frame_images өрісін қоспаңыз. | Әдепкі— |
Өрісinput_references | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер Кіріс мазмұны: Үлгі сурет немесе аудио объектілерінің массиві. type өрісіне image_url немесе audio_url мәнін орнатып, ішінде url бар сәйкес URL объектісін беріңіз. Үлгі бейнелердің бағасын есептеу әзірге мүмкін емес. Шарттар: Үлгі материалдар режимін пайдалану үшін frame_images өрісін қоспаңыз. Жалпыға қолжетімді HTTPS URL мекенжайларын қолданыңыз. | Әдепкі— |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720 Үлгі: ^[1-9][0-9]*x[1-9][0-9]*$ | Әдепкі— |
Өрісseed | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: -9 223 372 036 854 775 808 Ең көбі: 9 223 372 036 854 775 807 | Әдепкі— |
Өрісcallback_url | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Үлгі: ^https:// | Әдепкі— |
Өрісsession_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісtrace | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісuser | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Кіріс материалдарының үйлесімдері
Мәтіннен бейне жасау · Жазбаша промпт. · Міндетті: model, prompt, duration
Мәтіндік промптты және қолдау көрсетілетін бүтін секундтық ұзақтықты беріңіз. Тізімдегі нақты өлшемді немесе сол тізімдегі өлшемдерге сәйкес келетін ажыратымдылық пен жақтар арақатынасын қолданыңыз.
model: Түрі: string · bytedance/seedance-2.0-mini
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Суреттен бейне жасау · Жазбаша промпт және кадр суреті. · Міндетті: model, prompt, duration, frame_images
frame_images — type=image_url, ішінде url бар image_url және frame_type өрістері бар объектілер массиві. Жалпыға қолжетімді HTTPS сурет URL мекенжайын қолданыңыз; first_frame және last_frame әрқайсысы бір реттен кездесуі мүмкін. Тізімдегі шығыс өлшемін немесе үйлесімді өлшемдерді қолданыңыз. Үлгі бейнелерді қоспаңыз.
Нақты кілттер: type, image_url, frame_type
model: Түрі: string · bytedance/seedance-2.0-mini
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Reference to video · Жазбаша промпт және үлгі суреттер немесе аудио. · Міндетті: model, prompt, duration, input_references
input_references — массив. Әр объектіде type=image_url немесе type=audio_url және ішінде url бар сәйкес URL объектісі болады. Жалпыға қолжетімді HTTPS сілтемелерін пайдаланыңыз. Үлгі материалдар режимін таңдау үшін frame_images өрісін қоспаңыз. Үлгі бейнелердің бағасын есептеу мүмкін емес.
model: Түрі: string · bytedance/seedance-2.0-mini
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration |
Параметрmaterial_types | Параметр талаптарыtext, image, audio |
Параметрadditional_properties | Параметр талаптарыfalse |
Параметрoptional_controls | Параметр талаптарыresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Өмірлік цикл: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Есептеу бірлігі | Төлемді есептеу шарттары | Төлем |
|---|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауБейне токенінің бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігі1K бейне токені үшін | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.007 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігі1K бейне токені үшін | Төлемді есептеу шарттарыкіріс: with_video_input | Төлем reference · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.0042 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігі1K бейне токені үшін | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.007 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.1512 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео токенінің бағасы $0.007 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео токенінің бағасы $0.007 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыкіріс: with_video_input | Төлем reference · Видео токенінің бағасы $0.0042 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0-mini","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
иелігіңіздегі мазмұнның қолтаңбасы бар URL мекенжайлары
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Басқа мазмұнды оқу
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
Иелігіңіздегі әрбір нақты шығыс нәтижесін және онымен қайтарылған өлшенген метадеректерді сақтаңыз.
Бастапқы жауапты тексеру қажет болса
503 result_pending_check + бастапқы id + X-Should-Retry:false; бастапқы сұрауды ешқашан қайталамаңыз
Жауап өрістері
| Өріс | Түрі | Мағынасы |
|---|---|---|
Өрісindex | Түріinteger | МағынасыОсы бейненің шығыс тізіміндегі нөлден басталатын орны. |
Өрісcontent_url | Түріstring | МағынасыОсы аяқталған бейнені жүктеп алуға арналған қолтаңбасы бар HTTPS URL мекенжайы. |
Өрісsha256 | Түріstring | null | МағынасыБастапқы бейне байттарының SHA-256 хэші; қолжетімсіз болса, null. |
Өрісsize_bytes | Түріinteger | null | МағынасыБастапқы бейне файлының байтпен өлшенетін көлемі; қолжетімсіз болса, null. |
Өрісduration_ms | Түріinteger | null | МағынасыБейненің миллисекундпен өлшенген ұзақтығы; қолжетімсіз болса, null. |
Өрісwidth | Түріinteger | null | МағынасыБейненің пиксельмен өлшенетін ені; қолжетімсіз болса, null. |
Өрісheight | Түріinteger | null | МағынасыБейненің пиксельмен өлшенетін биіктігі; қолжетімсіз болса, null. |
Өрісvideo_codec | Түріstring | null | МағынасыБейне кодегінің идентификаторы; тіркелмесе, null. |
Өрісhas_audio | Түріboolean | null | МағынасыБейнеде аудиожол бар-жоғы; өлшенбесе, null. |
Өрісaudio_codec | Түріstring | null | МағынасыАудио кодегінің идентификаторы; идентификатор тіркелмесе, null. |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап404 · not_found_error | ШартБейнеге қол жеткізу мүмкін емес немесе бұл бейне ID мәні табылмады. | Келесі қадамБейнеге қолжетімділікті тексеріңіз. Бар бейне үшін оның бастапқы ашық ID мәнін және сол API кілтін пайдаланыңыз. |
Жауап401 · authentication_error | ШартAPI кілті аутентификациядан өткен есептік жазбаға сәйкес келмейді. | Келесі қадамЖібермес бұрын API кілтіңізді және есептік жазбаға қолжетімділікті тексеріңіз. |
Жауап400 · invalid_request_error | ШартСұрауды оқу мүмкін болмады немесе жүктеп алу индексі жарамсыз. | Келесі қадамСұрау денесін түзетіңіз. Жүктеп алу үшін бастапқы тапсырма қайтарған шығыс индексін таңдаңыз. |
Жауап422 · price_unavailable | ШартТаңдалған бейне конфигурациясының бағасын есептеу мүмкін емес. | Келесі қадамҚолдау көрсетілетін бейне конфигурациясын таңдап, түзетілген сұрауды жібермес бұрын оның міндетті параметрлерін толтырыңыз. |
Жауап422 · invalid_request_error | ШартКіріс бейне немесе бастапқы жалғастыру тапсырмасы жарамсыз. | Келесі қадамЖарамды HTTPS кірістерін пайдаланыңыз. Жалғастыру үшін аяқталған бастапқы бейнеңіздің ашық ID мәнін сол API кілтімен қолданыңыз. |
Жауап402 · billing_error | ШартҚолда бар баланс немесе лимиттер қаражатты резервтеуге мүмкіндік бермейді. | Келесі қадамЖаңа сұрауды жібермес бұрын қолда бар балансты және лимиттерді тексеріңіз. |
Жауап503 · server_error | ШартБейнені тексеру, сақтау немесе қызметке қол жеткізу уақытша қолжетімсіз. | Келесі қадамҚызметтің қолжетімді болуын күтіңіз. Егер сізде бейне ID мәні бар болса, басқа генерация жасаудың орнына сол бастапқы тапсырманы тексеріңіз. |
Жауап503 · result_pending_check | ШартБастапқы бейне нәтижесі мен есептелген төлемді тексеру қажет. | Келесі қадамҚайтарылған бейне ID мәнін сақтап, сол тапсырманы тексеріңіз. Тексеру жүріп жатқанда оның орнына жаңа генерация сұрауын жібермеңіз. |
Жауап503 · owned_result_unavailable | ШартБар бейнені жүктеп алу уақытша қолжетімсіз. | Келесі қадамСол бейне тапсырмасын кейінірек тексеріп, оның бар шығыс нәтижесін жүктеп алыңыз. Жаңа генерация бөлек операция жасайды. |
Жауап409 · video_not_ready | ШартБейне мазмұны жарияланбаған. | Келесі қадамБастапқы тапсырманың күйін тексеріңіз. completed күйін хабарлағаннан кейін жүктеп алыңыз; failed күйін хабарласа, оның төлемді тексеру туралы ескертуін орындаңыз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra bytedance/seedance-2.0-mini
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · ByteDance: Seedance 2.0 Mini
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·bytedance/seedance-2.0-mini:text,image,audio→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·bytedance/seedance-2.0-mini:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Қандай шектеулер қолданылады?
POST /v1/videos·bytedance/seedance-2.0-mini:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807