Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard — мәтіндік және суреттік тапсырмаларға арналған Kuaishou 720p бейне профилі. Бейнемен бірге тікелей жасалатын дыбыс, нысан референстері, алғашқы/соңғы кадр бағдары және бір не бірнеше планды баяндау арқылы үш–он бес секундтық көрініс жасаңыз.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Kling VIDEO 3.0 Standard — мәтіннен немесе берілген суреттен бейне көрініс жасауға арналған Kuaishou 720p профилі. Ол VIDEO 3.0 нұсқасының бейнемен бірге тікелей жасалатын дыбысын, нысан референстерін және бірнеше планды баяндауын қолданады; ұзақтық үштен он бес секундқа дейін икемді. Бұл профиль көрнекі бағыт әзірлеуге, қысқа оқиғаны алдын ала көруге немесе әрекеті мен дыбысы анық шағын көрініс жасауға пайдалы.
Мәтіндік көріністе нысанды, ортаны, әрекетті, жарықты және камера мінезін белгілеңіз. Суреттік көріністе қозғалысқа келетін келбет пен композицияны анық көрсететін алғашқы сурет дайындаңыз. Авторлық тапсырма шеберхана үстелі жанындағы кейіпкерді көрсетіп, кейін оның ұсақ затты алуын және камераның әрекетке жақындауын сипаттай алады. Мәтінде нысан қозғалысын камера қозғалысынан ажыратыңыз.
Бірнеше план генерациясы көрініс сипаттамасынан түсіру қамтуын автоматты жоспарлай алады. Арнайы бірнеше план нұсқауы жеке пландардың мазмұны мен ұзақтығын бөледі. Өндірушінің арнайы план профилі бірден алтыға дейін планды, әрқайсысына ең көбі 512 таңбаны және кемінде бір секундты қабылдайды. План ұзақтықтарының қосындысы жалпы ролик ұзындығына тең болуға тиіс. Бір үздіксіз көрініс оқиғаны анық жеткізсе, бір план тапсырмасы қажетсіз ауысудан сақтайды.
Қысқа сториборд орта көрінісінен басталып, әрекетке көшіп, нәтижені түсіндіретін бөлшекпен аяқтала алады. Әр планда қай нысан қалатынын және кадрлау қалай өзгеретінін көрсетіңіз. Автоматты режим қамтуды көрініске бейімдей алады, ал арнайы тізбек оның бөлек бөліктеріне нақты нұсқау береді. Өндіруші анықтамасында кәдімгі бір промпт 2,500 таңбаға дейін қабылдайды.
Нысан референсін басқару кейіпкерлерді, заттарды және ортаны бекітуге көмектеседі. Анық референс материалын пайдаланып, әр нысанға тұрақты сипаттама беріңіз. Құжатталған суреттік профиль үшке дейін дайын элементке рұқсат етеді. Иллюстрациялық өнім көрінісінде бір референс затты анықтай алады, ал алғашқы композиция оның қайда тұрғанын белгілейді; қозғалыс тапсырмасы айналасындағы оқиғаны сипаттайды. Референс кез келген өзгерісті болдырмайды деп ойламай, дайын келбетті план бойымен тексеріңіз.
Алғашқы және соңғы кадрлар суретпен шартталған ауысуды керекті соңғы композицияға бағыттай алады. Шынайы байланыс ұсынатын кадрларды қолданып, олардың арасындағы әрекетті сипаттаңыз. Өндірушінің сурет профилі JPG, JPEG және PNG қабылдайды: көлемі 10 MB-тан аспайды, өлшемдері кемінде 300 пиксель; алғашқы сурет арақатынасы 1:2.5 пен 2.5:1 арасында болуы керек. Сториборд сипаттамасын өзара алмастырылатын кіріс жиыны деп қарамай, осы міндетке кадр материалын дайындаңыз.
Standard профилі режим қосылса, бейнемен бірге дыбыс жасай алады; өндірушінің анықтамасында дыбыс әдепкіде өшірулі. Репликаларды, атмосфераны және тиісті дыбысты көріністің бөлігі ретінде сипаттаңыз. VIDEO 3.0 қытай, ағылшын, жапон, корей және испан тілдеріндегі сөйлеуді, соның ішінде тіл алмастыру мен қолдау көрсетілетін акценттерді не диалектілерді қолдайды. Өндірушінің нұсқаулығы басқа тілде енгізілген диалог ағылшын тіліне аударылатынын айтады. Бірнеше кейіпкер көрінісінде сөйлеушіні анық көрсетіп, сөздерді жоспарланған орындауға сыятындай қысқа ұстаңыз.
Авторлық диалог тапсырмасы A сөйлеушіге бір реплика, B сөйлеушіге көрінетін реакция және әңгімеге ілесетін көру нүктесі өзгерісін бере алады. Фон әсері сөйлеуге қатысты екіұшты нұсқауға айналмас үшін орта дыбысын диалогтан бөлек сипаттаңыз. Референстер нысандар келбетін, мәтін олардың не істеп, не айтатынын белгілесін.
Көрінетін жазу — 3.0 ағынының тағы бір бөлігі. Бастапқы суретте анимация кезінде келбеті маңызды маңдайша, титр не өнім жапсырмасы болуы мүмкін. Сол мәтінді және көріністегі рөлін атап, нәтижедегі емлені, оқылуын және тұрақтылығын тексеріңіз. Қысқа науқандық көріністе өте ұсақ фон жазуына сүйенбей, маңызды хабарды композицияда анық көрсетіңіз.
Standard нәтижесі — 720p. Pro — бөлек таңдалатын 1080p профиль, ал бастапқы 4K — Standard-тың автоматты параметрі емес, өндірушінің басқа режимі. Мәтіндік арақатынас таңдауларына 16:9, 9:16 және 1:1 кіреді. Пішім мен кадрлауды қолданылатын орынға сай таңдап, әрекет, жарық не план ретіндегі өзгерістерді салыстырғанда сол көрнекі бағытты сақтаңыз.
Аяқталған генерация нақты ұзақтығы бар бейне артефактісін береді. Өндірушінің нәтиже құжаттамасы жасалған бейнелер 30 күннен кейін жойылатынын айтады, сондықтан дайын роликті дереу сақтаңыз. Кейінгі түзетулерге бірізді бастапқы нүкте беру үшін көрініс тапсырмасын, референс суреттерін және таңдалған профильді роликпен бірге сақтаңыз. Көрінетін әрекетті, нысан сабақтастығын, камера қамтуын, диалогты және жазуды ролик қолданылатын ортада тексеріңіз. Сәтсіз бөлшекке бағытталған түзету бүкіл тапсырманы қатысы жоқ нұсқаулармен алмастырудан пайдалырақ.
Ailoot Ultra · Бейне POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdБастау
Kling VIDEO 3.0 Standard — мәтіндік және суреттік тапсырмаларға арналған Kuaishou 720p бейне профилі. Бейнемен бірге тікелей жасалатын дыбыс, нысан референстері, алғашқы/соңғы кадр бағдары және бір не бірнеше планды баяндау арқылы үш–он бес секундтық көрініс жасаңыз.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер kwaivgi/kling-v3.0-std | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ең азы: 1 Ең көбі: 600 | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 720p | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 16:9, 9:16, 1:1 | Әдепкі— |
Өрісgenerate_audio | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false, true Шарттар: Бұл параметрді қоспау аудиосы бар бағаны таңдайды. Аудиосыз бағаны таңдау үшін false орнатыңыз. Аудиожол қайтарылғанын білу үшін нәтижедегі has_audio өрісін тексеріңіз. | Әдепкі— |
Өріс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 | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1280x720, 720x1280, 720x720 Үлгі: ^[1-9][0-9]*x[1-9][0-9]*$ | Әдепкі— |
Өрісcallback_url | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Үлгі: ^https:// | Әдепкі— |
Өрісsession_id | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісtrace | Түріobject | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісuser | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Кіріс материалдарының үйлесімдері
Мәтіннен бейне жасау · Жазбаша промпт. · Міндетті: model, prompt, duration
Промптты мәтін түрінде, ал ұзақтықты бүтін секундпен беріңіз. Қолдау көрсетілетін ажыратымдылықты таңдаңыз; жақтар арақатынасын қосыңыз немесе тізімдегі өлшемді қолданыңыз.
model: Түрі: string · kwaivgi/kling-v3.0-std
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 · kwaivgi/kling-v3.0-std
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, size, 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.168 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.252 бейне секунды үшін |
| БаптауСуреттен бейне жасау (кадр суреттері) · 1080p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы1080p | Үлгі режиміСуреттен бейне жасау (кадр суреттері) | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.168 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.168 бейне секунды үшін |
| БаптауМәтіннен бейне жасау · 1080p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы1080p | Үлгі режиміМәтіннен бейне жасау | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.168 нәтиженің секунды үшін |
| БаптауМәтіннен бейне жасау · 480p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы480p | Үлгі режиміМәтіннен бейне жасау | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.168 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.168 бейне секунды үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.504 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы $0.252 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 480p | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы $0.168 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
Сұрау мысалдары
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":"kwaivgi/kling-v3.0-std","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 kwaivgi/kling-v3.0-std
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · Kling: Video v3.0 Standard
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·kwaivgi/kling-v3.0-std:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Қандай шектеулер қолданылады?
POST /v1/videos·kwaivgi/kling-v3.0-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1