ByteDance: Seedance 2.0 Fast
ByteDance Seedance 2.0 Fast мәтіннен, сурет, бейне және дыбыс референстерінен аудио-бейне көріністер жасайды. Жылдамдыққа бағытталған шығарылым қозғалыс пен стильді көшіруді, бейне өңдеуді және алға не артқа ұзартуды қолдайды; құжатталған нәтижесі — 480p және 720p.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Seedance 2.0 Fast — ByteDance Seed-тің Seedance 2.0 тобындағы жылдамдыққа бағытталған шығарылымы. Ол бейне мен аудионы бірге жасауды және мәтіннен, суреттерден, бейнеден және дыбыстан құралған мультимодалды тапсырманы қолдайды. Шығармашылық мүмкіндіктеріне жаңа референске негізделген көріністер, бар кадрларды өңдеу және көріністі ұзарту кіреді; құжатталған нәтиже деңгейлері — 480p және 720p.
Мультимодалды референс: материалға рөл тағайындау
Сурет кейіпкерді, өнімді, композицияны немесе визуалды өңдеуді бере алады. Референстік бейне әрекетті, камера қозғалысын немесе әсерді бере алады. Референстік аудио дауыс тембрін, музыкалық әуенді немесе диалог мазмұнын бере алады. Әр дереккөздің қай бөлігін жаңа көрініске жеткізгіңіз келетінін түсіндіріңіз; нақты шығармашылық рөлі болса, референс пайдалырақ.
Мысалы: «Image 1 суретіндегі қыш шамды өнім ретінде қолданыңыз. Video 1 бейнесіндегі баяу камера айналымына ілесіңіз, бірақ шамды тыныш кітап оқу бұрышына қойыңыз. Музыкалық көңіл күй үшін Audio 1 қолданыңыз». Қажетті нәтиже — референстердегі әр бөлшектің белгісіз еліктеуі емес, таңдалған келбет, қозғалыс және дыбыстық бағытты біріктіретін жаңа көрініс.
Құжатталған тіркесімдерге суреттер мен аудио, суреттер мен бейне, бейне мен аудио және үшеуі бірге кіреді. Тек мәтін мен аудио, сондай-ақ тек аудио кірісі қолдау таппайды. Модель мәтіннен бейне жасауды және бірінші кадрдан немесе бірінші-соңғы кадр жұбынан суретке негізделген генерацияны да қолдайды. Нақты соңғы нүкте тапсырмада негізгі болса, арнайы шекаралық үдерісті қолданыңыз; omni-reference нұсқауында референстік суретті соңғы нүкте деп сипаттау — жанама басқару.
Бар бейнені өңдеу
Модель элементтерді қоса, алып тастай немесе өзгерте алады, нысанды алмастырып, көрініс бөліктерін қайта сала не жөндей алады. Бастапқы бейнені, өзгеретін нысанды және қалуы тиіс элементтерді анықтаңыз. Қосу үшін қай жерде және қашан көрінетінін сипаттаңыз. Алып тастау үшін нысанды бүкіл клип бойында бірізді анықтаңыз.
Практикалық өңдеу тапсырмасы көрсетілімдегі қарапайым бөтелкені Image 1 суретіндегі бөтелкемен алмастырып, Video 1 бейнесінің қол қозғалысын, фонын және камера жолын сақтауды сұрай алады. Алмастыруды да, тұрақты қалуы тиіс аймақтарды да тексеріңіз. Сақтау туралы анық нұсқаулар кадрларды жалпы «жақсарту» өтінішіне қарағанда қажетті өңдеуді бағалауды жеңілдетеді.
Клиптерді ұзарту және жалғау
Seedance 2.0 Fast алға немесе артқа ұзартуды және екі не үш клипті жасалған ауысулармен жалғауды қолдайды. Ұзартуда жаңа әрекет берілген бейненің алдында ма, артында ма болатынын айтып, сол әрекетті сипаттаңыз. Жалғауда клиптерді қажетті ретімен беріп, оларды қосатын визуалды оқиғаны түсіндіріңіз.
Қарапайым ұзарту әдетте бүкіл бастапқы клип қайталанады деп ойламай, бастапқы кадрлар айналасында жаңадан дамыған жалғастыруды қайтарады. Нәтижеде бастапқы сегмент болуы керек болса, оны тапсырмада айтыңыз. Екі не үш бейне арасындағы ауысуды толтырғанда құжатталған үдеріс бастапқы және жаңадан жасалған мазмұнды біріктіре алады. Бұл өнімнің жалпы көрінісін мақсатты камера қозғалысы арқылы бөлшек кадрмен жалғауға пайдалы.
Нәтиже және шығарылым айырмашылықтары
Құжатталған Fast нәтижесі — 24 fps MP4, 480p немесе 720p, 8-биттік түс тереңдігі және 4–15 секундтық клиптер. Қолдау көрсетілетін арақатынастар — 21:9, 16:9, 4:3, 1:1, 3:4 және 9:16. Стандартты Seedance 2.0 шығарылымы 1080p және 4K нәтижесін бөлек атайды; бұл деңгейлер Fast сипаттамасына кірмейді. 2.0 тобы соңғы жасалған кадрды қайтаруды қолдайды, бірақ бөлек Draft алдын ала қарау режимін қолдамайды.
Аудионы кадрлармен бірге жасауға немесе дыбыссыз клип үшін қоспауға болады. Жасалған аудио моно. Құжатталған нұсқау тілдеріне ағылшын, испан, индонезия, португал және жапон кіреді. Диалог ішінде сөйленетін тілді бірізді ұстаңыз; нұсқаулық жалқы есімдерден басқа жағдайда тілдерді араластырмауды ұсынады. Сөйлейтін көрініс үшін сөйлеушіні атап, репликаны тырнақшаға қойыңыз, кейін орындауды және тиісті дыбыс әсерлерін көрсетіңіз. Қажетті орындауды таңдалған клип ұзақтығына лайық ұстаңыз.
Референстерді дайындау және кіріс шектерін сақтау
Құжатталған референс шектері — тоғызға дейін сурет, үш бейне және үш аудиоклип. Нақты адам беті бар референстік сурет не бейнені тікелей жүктеу осы құжатталған өндіруші профилінде қабылданбайды; портрет жұмысы қолдау көрсетілетін портрет материалы үдерісін қолданады. Әр бейне немесе аудиоклип 2–15 секунд болуы керек; бейнелердің жиынтық ұзақтығы ең көбі 15 секунд, ал аудиолардың жиынтық ұзақтығы бөлек ең көбі 15 секунд. Бейне референстер MP4 не MOV, 24–60 fps қолданады және әрқайсысы 200 MB-тан аспауы тиіс. Аудио референстер WAV не MP3 қолданады және әрқайсысы 15 MB-тан аспауы тиіс. Аталған сурет пішімдері — JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC және HEIF. Әр сурет 30 MB-тан кіші болуы керек; жалпы сұрау денесінің шегі — 64 MB. Құжатталған референстік кіріс профилінде сурет ені мен биіктігінің әрқайсысы қатаң түрде 300 және 6,000 пиксель арасында, ені-биіктігі арақатынасы қатаң түрде 0.4 және 2.5 арасында болуы тиіс. Референстік бейнелер әр өлшемде 300–6,000 пиксельге және шеттерін қоса 0.4–2.5 арақатынасына, жалпы 407,696–8,295,044 пиксельге рұқсат береді. MP4 не MOV бейнелері H.264/AVC немесе H.265/HEVC бейнесін және AAC не MP3 аудиосын қолданады.
Материалдарды реттеп, оларды Image 1, Video 1 немесе Audio 1 деп бірізді атаңыз. Материал нөмірімен қатар көрінетін нысанның атын немесе айрықша белгісін қолданыңыз. Шекаралық суреттердің кадрлауын қажетті бейне арақатынасына сәйкестендіріңіз, өйткені сәйкессіздік суретті қиып жіберуі немесе кадрлауды күрт өзгертуі мүмкін. Тапсырманы көшірілетін белгілерге, жасалатын оқиғаға және өзгермей қалатын нәрсеге шоғырландырыңыз; ұзын нұсқау нұсқауларды шашыратып, қосалқы бөлшектерді шешілмеген күйде қалдыруы мүмкін.
Кадр жоспарлау, мәтін және белгілі мінез-құлықтар
Күрделі тапсырманы Shot 1, Shot 2 және Shot 3 деп ұйымдастырып, әрқайсысына анық нысан, әрекет, орын және дыбыс беріңіз. Нұсқаулық бір кадрға бір камера қозғалысын ұсынады және кадрға тән нақты уақыт белгілері тұрақсыз дейді. Әр кейіпкерге тұрақты атау және бірнеше айрықша белгі беріңіз; бет сәйкестігі маңызды болса, біріктірілген кейіпкер айналым парағы орнына бөлек анық бет портреті мен толық бой референсін қолданыңыз.
Модель ұрандар, субтитрлер және сөйлеу бұлттары сияқты кең таралған мәтінді жасай алады; оның түсін, стилін, орнын және пайда болуын бағыттауға болады. Сирек таңбалардан немесе арнайы символдардан гөрі кең таралған таңбалар жақсырақ. Әріптерді қозғалыста тексеріңіз. Қажетсіз субтитрлер, логотиптер және қайталанған кейіпкерлер — құжатталған мінез-құлықтар; анық шектеулер мен таза референстер оларды азайта алады, бірақ жоқ болуына кепілдік бермейді. Төрттен көп референстік адам қатаң файл саны шегі емес, тұрақтылық қаупі деп хабарланған.
Қайталанған ұзартулар сурет сапасының жоғалуын жинақтай алады, ал ұзарту жалғануы секіруі немесе кері оралуы мүмкін. Қатарланған жалғастыруларды шектеп, монтажда жалғануды тексеріңіз. Референстік дауыс тембрі ауытқуы, баяндау соңында сырт еткен дыбыс болуы және қытайдың көп оқылымды немесе сирек таңбалары қате айтылуы мүмкін. Репликаны және аяқталу аудиосын тексеріңіз; қысқа дыбыс бәсеңдеуі үзіліске көмектесе алады. Бұл тексерулер шығармашылық нәтижені дайындаудың бөлігі, әсіресе оқиғаны сөйлеу немесе кейіпкер сабақтастығы жеткізгенде.
Ailoot Ultra · Бейне POST /v1/videos bytedance/seedance-2.0-fast
bytedance/seedance-2.0-fastБастау
ByteDance Seedance 2.0 Fast мәтіннен, сурет, бейне және дыбыс референстерінен аудио-бейне көріністер жасайды. Жылдамдыққа бағытталған шығарылым қозғалыс пен стильді көшіруді, бейне өңдеуді және алға не артқа ұзартуды қолдайды; құжатталған нәтижесі — 480p және 720p.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер · Аудио
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image,audio- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер bytedance/seedance-2.0-fast | Әдепкі— |
Өріс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-fast
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-fast
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-fast
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.0084 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігі1K бейне токені үшін | Төлемді есептеу шарттарыкіріс: with_video_input | Төлем reference · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.00495 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Есептеу бірлігі1K бейне токені үшін | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.0084 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.18144 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео токенінің бағасы $0.0084 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыаудио: without_audio | Төлем Шығыс · Видео токенінің бағасы $0.0084 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес. |
| БаптауБейне токенінің бағасы | Төлемді есептеу шарттарыкіріс: with_video_input | Төлем reference · Видео токенінің бағасы $0.00495 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-fast","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-fast
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · ByteDance: Seedance 2.0 Fast
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·bytedance/seedance-2.0-fast:text,image,audio→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·bytedance/seedance-2.0-fast: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-fast:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807