Black Forest Labs: FLUX.3 Video
FLUX 3 Video мәтіннен, бекітілген суреттерден немесе жалғастырылатын клиптен синхрондалған диалогы, әсерлері және атмосферасы бар клиптер жасайды. Негізгі кадрлар, көпкадрлы композиция және алдын ала нұсқаны күшейту басқарылатын тізбекті дамытуға және таңдалған дубльді сақтауға көмектеседі.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
FLUX 3 Video — синхрондалған аудиосы бар бейне жасауға арналған Black Forest Labs мультимодалды моделі. Ол мәтіндік тапсырмадан көріністер жасайды, бекітілген суреттер айналасында қозғалыс құрады немесе бар клипті жалғастырады. Сөйлеу, әсерлер және атмосфера кадрлармен бірге жасала алады; осылай камера қозғалысы, әрекет және дыбыс бір тізбек ретінде жобаланған қысқа көріністі қолдайды.
Мәтіннен бейне жасау үшін нысанды, ортаны, көрінетін әрекетті, камера мінез-құлқын және дыбысты сипаттаңыз. Пайдалы өнім көрінісі жалпы көріністен басталып, материал бөлшегіне жақындап, өнімнің қолданылуымен аяқтала алады. Көпкадрлы тапсырмалар тізбек бойында нысан мен визуалды стильді бірізді сақтап, әр кадрды және камера бұрыштары арасындағы ауысуды атай алады. Типографика көріністің ішінде пайда бола алады, сондықтан белгі не тақырып маңызды болса, нақты сөздерді және олардың орнын беріңіз. Модель тірі түсірілімді, анимацияны, қозғалыс графикасын және стильденген келбеттерді қамтиды.
Суреттен бейне жасау бірден онға дейін негізгі кадр суретін қолданады. Бір сурет бастапқы кадрды анықтайды; жұп басталу мен аяқталуды бекітеді, ал уақыт белгілері бар реттелген суреттер клиптің нақты сәттерін бағыттайды. Бұл суреттер тек жалпы стиль референсі болмай, бейне кадрларына айналады. Уақыт белгілері жоқ үш не одан көп сурет болса, өндіруші айқын ұзақтықты талап етеді: бірінші мен соңғы шекараларды бекітеді, басқалары олардың арасына біркелкі орналастырылады. Уақыт белгісі бар кадрлар уақыт ретімен болуы тиіс; автоматты ұзақтық соңғы уақыт белгісіне дейін жоғары дөңгелектеліп, 20 секундтық ең үлкен шек ішінде жүреді. Негізгі кадрларды үйлесімді нысандармен, кадрлаумен және визуалды бөлшектермен дайындап, кейін олардың арасындағы қозғалысты сипаттаңыз. Өнімді ашып көрсетуде бірінші кадр жабық нысанды, соңғысы ашылған орналасуды көрсете алады, ал арадағы әрекет нұсқауда анықталады.
Бейне жалғастыру берілген клиптің соңғы кадрларынан іліп әкетеді. Іске қосу үдерісі келесі әрекетке контекст ретінде төрт секундқа дейін бар бейне мен аудионы қолданып, камера мінез-құлқын, қозғалысты және дыбысты жалғану арқылы өткізеді. Нысан мен камераның қайда бара жатқанын анық белгілейтін бастапқы аяқталуды таңдап, әрі қарай не болатынын сипаттаңыз. Жалғастыру бар кадрды қайта жазудан өзгеше: FLUX Video Edit — бөлек өңдеу моделі және екеуі де бейне қабылдағаны үшін генерация моделінің бөлігіне айналмайды.
Мәтінмен және суретпен шартталған генерация 5–20 секундтық клиптерді қолдайды. Режимге тән шолу бейне жалғастыруға 5–15 секундтық нәтиже ауқымын береді. Ұзақтық пен арақатынасты автоматты таңдауға болады немесе тапсырма 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 және 9:21 кіретін қолдау көрсетілетін көлденең, шаршы не тік пішінді белгілей алады. Нәтиже — секундына 24 кадр. Бір қысқа генерацияға бүкіл оқиғаны сыйғызуға тырыспай, ұзақтықты аз ғана көрінетін әрекетке сай таңдаңыз.
HD нәтижесі генерациядан тікелей келеді; FHD, QHD және UHD сол көріністі бейне үлкейткішпен аяқтайды. 16:9 үшін берілетін өлшемдер тиісінше 1280 × 704, 1920 × 1088, 2560 × 1440 және 3840 × 2176. Өлшемдер 32 еселіктеріне тураланған, сондықтан аталған ажыратымдылық сыныбы дәстүрлі жеткізу өлшемінен ерекшеленуі мүмкін. Дәл стандартты кенеп керек болса, шеттеріндегі маңызды мазмұнды сақтай отырып, дайын кадрды қиыңыз. Жоғарырақ ажыратымдылық — кадрдың басқа түсіндірілуі емес, аяқтау қадамы.
Төл аудио әдепкі бойынша қосулы және дыбыссыз клип үшін өшіріле алады. Диалогта репликаны тырнақшаға алып, сөйлеушіні анықтап, орындауын сипаттаңыз; көптілді сөйлеу, акценттер және ерін синхрондауы — модельдің аудио-бейне мүмкіндіктерінің бөлігі. Диалог пен дыбыс белгілерін қақпақ жабылуы немесе алыстап бара жатқан қадамдар сияқты көрінетін оқиғамен байланыстырыңыз. Дыбысты генерациядан кейін қосылған қатыссыз қабат деп қабылдамай, дауысты, уақытты және айтылған тұжырымды суретпен бірге тексеріңіз.
Draft режимі HD алдын ала көрінісін және draft жинағын жасайды. Таңдалған жинақты күшейтіп, сол генерацияны толық сапада рендерлеңіз; сол нұсқауды жаңа толық рендер сұрауы ретінде жіберу — жаңа түсіндіру, ол басқа дубль беруі мүмкін. Draft тек HD қолданады, ал күшейту төрт ажыратымдылық сыныбын таңдай алады және әдепкісі — FHD. Бұл алдымен әрекет пен композицияны зерттеп, кейін таңдалған дубльді қажетті жеткізу өлшемінде аяқтаудың практикалық тізбегін береді.
Өндіруші үдерісі MP4 дайын болмай тұрып міндет идентификаторын қайтарады, кейін өңдеу аяқталғанда дайын клипті береді. Қолтаңбаланған нәтиже орындары шамамен екі сағаттан кейін жарамсыз болады, сондықтан кадр таңдалған соң нақты материалды сақтаңыз. Негізгі кадр ауысуларын, кесулерді, типографиканы, нысан бөлшектерін және аудио жалғануын тапсырмамен салыстырып тексеріңіз. Ұзынырақ тізбек үшін бір қысқа сұрау бүкіл өндірісті қамтиды деп ойламай, сәтті кадрдың референстері мен аяқталу контекстін келесі клиптің кірісі ретінде сақтаңыз.
Ailoot Ultra · Бейне POST /v1/videos black-forest-labs/flux-3-video
black-forest-labs/flux-3-video
black-forest-labs/flux-3-videoБастау
FLUX 3 Video мәтіннен, бекітілген суреттерден немесе жалғастырылатын клиптен синхрондалған диалогы, әсерлері және атмосферасы бар клиптер жасайды. Негізгі кадрлар, көпкадрлы композиция және алдын ала нұсқаны күшейту басқарылатын тізбекті дамытуға және таңдалған дубльді сақтауға көмектеседі.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер black-forest-labs/flux-3-video | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 Ең азы: 1 Ең көбі: 600 | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 720p, 1080p | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Әдепкі— |
Өрісgenerate_audio | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false, true | Әдепкі— |
Өрісframe_images | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 1 Элементтердің ең көп саны: 2 Кіріс мазмұны: Кадр объектілерінің массиві. Әр объектіде type=image_url, ішінде url бар image_url және frame_type өрістері болады. HTTPS сурет URL мекенжайын пайдаланып, frame_type өрісіне first_frame немесе last_frame мәнін орнатыңыз. Әр кадр рөлі ең көбі бір рет кездеседі. Нақты кілттер: type, image_url, frame_type Шарттар: Бұл кілттер әр кадр объектісін сипаттайды; image_url ішінде тек url болады. Тек мәтіндік сұрауда frame_images өрісін қоспаңыз. | Әдепкі— |
Өрісinput_references | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісprevious_job_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Үлгі: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ | Әдепкі— |
Өрісcallback_url | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Үлгі: ^https:// | Әдепкі— |
Өрісsession_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісtrace | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісuser | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Кіріс материалдарының үйлесімдері
Мәтіннен бейне жасау · Жазбаша промпт. · Міндетті: model, prompt, duration
Промптты мәтін түрінде, ал ұзақтықты бүтін секундпен беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.
model: Түрі: string · black-forest-labs/flux-3-video
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Суреттен бейне жасау · Жазбаша промпт және алғашқы кадр суреті. · Міндетті: model, prompt, duration, frame_images
frame_images — массив. Әр кадр объектісінде type, image_url және frame_type өрістері бар; image_url ішінде url болады. type өрісіне image_url мәнін орнатыңыз. first_frame мәнін қолданыңыз, last_frame міндетті емес. Әр кадр рөлі ең көбі бір рет кездеседі. Әр кадр үшін жалпыға қолжетімді HTTPS сурет URL мекенжайын беріңіз. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.
Нақты кілттер: type, image_url, frame_type
model: Түрі: string · black-forest-labs/flux-3-video
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Continue a video · Жазбаша промпт және сіздің аяқталған бастапқы бейнеңіз. · Міндетті: model, prompt, duration, previous_job_id
previous_job_id өрісіне аяқталған бастапқы бейнеңіздің ашық ID мәнін орнатыңыз. Сол модельді, есептік жазбаны және API кілтін қолданыңыз. Оның бар тапсырма идентификаторын сақтаңыз; бұл сұрау жалғастыруға арналған бөлек тапсырма жасайды. Қолдау көрсетілетін ажыратымдылықты және қажет болса, жақтар арақатынасын таңдаңыз.
model: Түрі: string · black-forest-labs/flux-3-video
prompt: Түрі: string · UTF-8 байттарының ең көп саны: 10 000 · Бос таңбаға жатпайтын кемінде бір таңба қажет: Иә
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt, duration |
Параметрmaterial_types | Параметр талаптарыtext, image |
Параметрadditional_properties | Параметр талаптарыfalse |
Параметрoptional_controls | Параметр талаптарыresolution, aspect_ratio, generate_audio, frame_images, input_references, previous_job_id, 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 токен |
| БаптауМәтіннен бейне жасау · Суреттен бейне жасау (кадр суреттері) · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі режиміМәтіннен бейне жасау · Суреттен бейне жасау (кадр суреттері) | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.34 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі режимі— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыresolution: 1080p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.58 бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі режимі— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыresolution: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.34 бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі режимі— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыкіріс: video_continuation; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $1.06 бейне секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі режимі— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыкіріс: video_continuation; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.82 бейне секунды үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем құрамдасы— | Үлгі режимі— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $1.7 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео бағасы $0.34 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыresolution: 720p | Төлем Шығыс · Видео бағасы $0.34 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыresolution: 1080p | Төлем Шығыс · Видео бағасы $0.58 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыкіріс: video_continuation; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.82 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыкіріс: video_continuation; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы $1.06 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"black-forest-labs/flux-3-video","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 black-forest-labs/flux-3-video
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · Black Forest Labs: FLUX.3 Video
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·black-forest-labs/flux-3-video:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·black-forest-labs/flux-3-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,previous_job_id,callback_url,session_id,trace,user- Қандай шектеулер қолданылады?
POST /v1/videos·black-forest-labs/flux-3-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1