ByteDance: Seedance 2.5

Seedance 2.5 ұзынырақ көріністер, бай сурет/бейне/аудио референстері және нысаналы түзетулер үшін аудио мен бейнені бірге жасайды. ByteDance Seed 30 секундқа дейінгі генерацияны, саз рендерімен бағыттауды, басқарылатын камера жұмысын және бар кадрларды жалғастыруды құжаттайды.

Ailoot Ultra · Бейне POST /v1/videos bytedance/seedance-2.5

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

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

Seedance 2.5 — ByteDance Seed-тің аудио мен бейнені бірге жасау моделі. Ол Seedance 2.0 негізіне ұзынырақ әңгімелеуді, байырақ мультимодалды референстерді және дәлірек өңдеуді қосады. Мәтіндік тапсырма көріністі анықтай алады, ал суреттер, бейне және аудио сыртқы келбетті, қозғалысты, камера тілін және дыбысты жеткізеді. Нәтиже — фильм тұжырымына, өнім оқиғасына, музыкалық бейнеге, алдын ала визуализацияға немесе қысқа баяндауға арналған аудиовизуалды кадрлар.

Бір генерациядағы толық көрініс Өндіруші бір өтімдік генерация шегін бұрынғы 15 секундтан 30 секундқа дейін ұзартады. Бұл тапсырмаға бірнеше байланысқан кадрмен немесе үздіксіз камера қозғалысымен басталу, даму және аяқталу үшін орын береді. Оның сахналық орындау мысалы әншінің тек сахнаға шығуын емес, грим бөлмесінен дәліз арқылы сахнаға дейінгі жолын қадағалайды. Әрекеттер тізбегі мен камера бағытын қажетті ретімен сипаттаңыз. Өнім оқиғасында әр сәт көзге көрінетін бір нәрсе қосуы үшін ашып көрсетуді, көрсетілімді және соңғы композицияны жоспарлаңыз.

Бар кадрларды жалғастыру Seedance 2.5 қалыптасқан кейіпкерлерді, ортаны, қозғалысты және камера бағытын сабақтастық белгілері ретінде қолданып, клипті алға немесе артқа ұзарта алады. Алға жалғастыру соңғы сәттен кейін не болатынын; артқа жалғастыру бастапқы көрініске не алып келетінін сипаттайды. Бар кадрларды беріп, жаңа әрекетті, орта өзгерісін немесе камера қозғалысын түсіндіріңіз. Жаңа сегментпен қатар жалғану орнын да, соның ішінде нысан келбетін, дыбысты және қозғалыс бағытын тексеріңіз. Өндірушінің іске қосу материалы қайталанған ұзартуды талқылайды, ал модель парағы екі ұзарту қадамын сипаттайды; қолдануға болатын ұзарту бюджеті әмбебап шексіз бейне уәдесіне емес, нақты үдеріске жатады.

Сурет, бейне және аудио референстері Жарияланған референс бюджеті бір генерацияға 50 материалға дейін: 30 сурет, 10 бейнеклип және 10 аудиоклип. Суреттер кейіпкерлерді, өнімдерді, орындарды, реквизитті немесе стильді анықтай алады. Бейнелер орындауды, қарқынды және камера қозғалысын жеткізе алады. Аудио диалогты, музыканы, атмосфераны немесе ырғақты бере алады. Әр материалға анық рөл тағайындаңыз: бір референс нысанға, екіншісі ортаға, бейне камера қозғалысына, аудиоклип уақытқа. Бұл материалдар түсіндіруді бағыттайды; олар әр бөлшектің дәл қайталануына кепілдік бермейді.

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

Уақыт белгісі бойынша түзету және камера басқаруы Seedance 2.5 генерация кезінде уақыт аралығын нысанаға алуды және бар клиптегі кейіпкерлерді, әрекеттерді немесе оқиға элементтерін түзетуді қолдайды. Уақыт белгісіне негізделген өңдеу аудионы да, визуалды мазмұнды да нысанаға ала алады; уақыт аралығын және түзетілетін элементті көрсетіңіз. Өндіруші жасыл экран фонын алмастыруды, референске негізделген өңдеуді және көрініс әрекеті мен стилін сақтай отырып камера қозғалысын өзгертуді көрсетеді. Өңдеу тапсырмасы бастапқы клипті, аралықты, өзгеретін элементті және сақталатын сабақтастықты анықтауы тиіс. Мысалы, бүкіл фильмді қайта жобалауды сұрамай, бір сегменттегі жарық не фон өзгерісін сипаттаңыз. Өңдеуден кейін түзетілген мазмұнмен қатар аралықтың алдындағы және кейінгі сәттерді де тексеріңіз.

Аудиовизуалды нәтиже және көптілді жасау Өндірушінің өнім сипаттамасы 480p, 720p немесе 1080p, 24 FPS мәндерімен 4–30 секундтық генерацияны және MP4 не MOV нәтижесін сипаттайды. Ресми таныстыруы 10-нан астам тілге төл қолдауды және диалогқа негізделген жасауды сипаттайды. Бұлар — өндірушінің мүмкіндіктері мен пішім таңдаулары; олар Ailoot файл кірісі, ұзақтық немесе нәтиже пішімі келісімін анықтамайды. Диалогқа негізделген жұмыста қажетті сөзді және оның әрекетпен байланысын көрсетіп, жергіліктендірілген нұсқаны қолданар алдында тілді еркін білетін адамға тұжырымы мен айтылымын тексертіңіз.

Қолданыстар және елеулі шектеулер Модель науқан тұжырымдарына, өнім көрсетілімдеріне, кейіпкерге негізделген оқиғаларға және референстік кадрлардан немесе қарапайым 3D қойылымнан шынайы алдын ала көрініс жасауға пайдалы. Өндіруші білім беру түсіндірмелерін және өндіріс не құрастыру визуалдарын да көрсетеді. Жасалған нұсқаулық немесе симуляциялық кадрларды бейнеленетін нақты үдеріспен бәрібір салыстырып тексеру керек. Шығарылым күрделі қозғалыс физикасын және бірнеше нысан арасындағы тұрақты өзара әрекетті әрі қарай жақсартылатын салалар деп анық атайды. Бүкіл клипте қол мен нысан жанасуын, топтық әрекеттерді, қозғалыс жолдарын, кейіпкер бірізділігін және дыбыс пен суреттің уақыт сәйкестігін тексеріңіз. Күшті бастапқы кадр толық тізбек тапсырмаға сай екенін бекітпейді.

Ailoot Ultra · Бейне POST /v1/videos bytedance/seedance-2.5

bytedance/seedance-2.5

ByteDance /bytedance/seedance-2.5

Бастау

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

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

Ailoot Ultra · Бейне POST /v1/videos

Кіріс: text, image, audio
Шығыс: video
Шығыс пішімі: бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер bytedance/seedance-2.5	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер	Әдепкі—
Өріс`duration`	Түрі`integer`	ТалапМіндетті	Мәндер мен шектеулер 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Ең азы: 1 Ең көбі: 600	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 480p, 720p	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 16:9, 4:3, 1:1, 3:4, 9:16, 21:9	Әдепкі—
Өріс`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`	ТалапМіндетті емес	Мәндер мен шектеулер 854x480, 752x560, 640x640, 560x752, 480x854, 992x432, 1280x720, 1112x834, 960x960, 834x1112, 720x1280, 1470x630 Үлгі: ^[1-9][0-9]x[1-9][0-9]$ Шарттар: Тізімдегі 1280x720 өлшемінен басқа өлшемдер үшін aspect_ratio өрісін қоспаңыз. 1280x720 өлшемін 16:9 арақатынасымен біріктіруге болады. resolution берілсе, ол таңдалған өлшемнің 480p немесе 720p деңгейіне сәйкес келуі керек.	Әдепкі—
Өріс`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.5

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.5

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.5

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.0214 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.
БаптауБейне токенінің бағасы	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлемді есептеу шарттарыкіріс: with_video_input	Төлем reference · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.0128 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.
БаптауБейне токенінің бағасы	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігі1K бейне токені үшін	Төлемді есептеу шарттарыаудио: without_audio	Төлем Шығыс · Видео токенінің бағасы · Тек салыстыруға арналған бағалау $0.0214 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлемді есептеу шарттары—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.822402 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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

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

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

Бейне конфигурацияларының баға сілтемелері

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

Баптау	Төлемді есептеу шарттары	Төлем
БаптауБейне токенінің бағасы	Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген.	Төлем Шығыс · Видео токенінің бағасы $0.0214 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.
БаптауБейне токенінің бағасы	Төлемді есептеу шарттарыаудио: without_audio	Төлем Шығыс · Видео токенінің бағасы $0.0214 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.
БаптауБейне токенінің бағасы	Төлемді есептеу шарттарыкіріс: with_video_input	Төлем reference · Видео токенінің бағасы $0.0128 1K бейне токені үшін Бейнетокен тарифі — бағаның негізгі анықтамалық көрсеткіші. Қысқаша шолудағы секундына шаққандағы болжамды бағалар — бөлек анықтамалық мәндер; олар қосымша төлем емес.

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

Ailoot Ultra · Бейне

curl · бейне құрыңыз

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.5","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"854x480","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

Тапсырма күйін тексеру

GET бастапқы операцияның күйі

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.5

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

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

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

bytedance/seedance-2.5

FAQ · ByteDance: Seedance 2.5

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/videos · bytedance/seedance-2.5: text, image, audio → video
Сұрау қандай өрістерді пайдаланады?: POST /v1/videos · bytedance/seedance-2.5: 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.5: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1; seed.minimum: -9223372036854775808; seed.maximum: 9223372036854775807

ByteDance: Seedance 2.5