Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro — мәтінге және суретке негізделген көріністерге арналған Kuaishou 1080p кәсіби бейне профилі. Ол үш–он бес секундтық роликтерді, бейнемен бірге тікелей жасалатын дыбысты, бағытталған шеткі кадрларды және бір не бірнеше план нұсқауын біріктіріп, кинематографиялық тұжырымдамалар мен қысқа қойылымдарға қызмет етеді.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Kling VIDEO 3.0 Pro — Kuaishou VIDEO 3.0 моделінің кәсіби профилі. Құжатталған Pro режимі мәтіндік тапсырмадан немесе суретке негізделген көріністен үш–он бес секундтық 1080p бейне жасайды. 3.0 нұсқасы бейнемен бірге тікелей жасалатын дыбысты, нысан тұрақтылығын басқаруды және бірнеше план нұсқауын біріктіріп, қысқа қойылымның келбетін, әрекетін, камера қамтуын және дыбысын анық белгілеуге мүмкіндік береді.
Көріністің негізгі әрекетінен бастаңыз. Мәтіндік планда нысанды, ортаны, жарықты және әрекетті түсінікті ететін көру нүктесін сипаттаңыз. Суреттік планда алғашқы сурет келбет пен композицияны белгілесін, ал мәтін уақыт өте не өзгеретінін берсін. Авторлық өнім тұжырымдамасында дайын сурет затты студиялық бетте көрсете алады, ал промпт оның материалы мен пішінін баяу ашып көрсетуді сипаттайды.
Бірнеше план нұсқауы автоматты қамтуды немесе арнайы тізбекті ұсынады. Автоматты бірнеше план генерациясы тапсырмадан кадрлау мен камера бұрышы өзгерістерін жоспарлайды; бір үздіксіз көрініске сыятын оқиға бір план болып қала алады. Арнайы сториборд әр планның мазмұны мен ұзақтығын анықтауға мүмкіндік береді. Өндірушінің арнайы план профилі бір–алты планға, әрқайсысына ең көбі 512 таңбаға және кемінде бір секундқа рұқсат етеді; ұзақтықтар қосындысы жалпы ролик ұзақтығына тең болуы керек.
Қысқа оқиға үшін орта көрсетілетін көріністі, негізгі әрекетті және қорытынды бөлшекті бөлек пландармен сипаттаңыз. Әр планда камера өңдеуін және көрермен не байқауы керегін айтыңыз. Қайталанатын нысанның келбетін тапсырмада тұрақты ұстап, әрекет пен қамтуды мақсатты өзгертіңіз. Өндіруші анықтамасындағы бір промпт өрісі 2,500 таңбаға дейін қабылдайды; арнайы тізбек жеке план сипаттамаларын қолданады.
Кейіпкер, өнім немесе орта танылатын күйде қалуы қажет болса, нысан референстері суреттік көріністі қолдайды. Сақталатын белгілерді жеткізетін анық көріністерді таңдап, әр референстік нысанды бірізді атаңыз. Құжатталған суреттік профиль үшке дейін дайын элементке рұқсат етеді. Нысан келбетіне қайшы нұсқау беретін бірнеше ресурсты біріктірудің орнына референс рөлдерін шоғырландырыңыз.
Алғашқы және соңғы кадрлар суретпен шартталған ауысуға көрнекі шекара береді. Нысаны мен жоспарланған көрінісі үйлесетін кадрлар дайындап, қозғалыстың оларды қалай байланыстыратынын сипаттаңыз. Өндіруші қолдайтын кадр кірісі JPG, JPEG немесе PNG суреттерін қолданады: файл 10 MB-тан аспайды, өлшемдері кемінде 300 пиксель, алғашқы сурет арақатынасы 1:2.5–2.5:1 арасында. Кадрмен басқарылатын тапсырма мен арнайы сториборд кірісті әртүрлі өңдейді, сондықтан толық тапсырманы жазар алдында материалды таңдалған ағынға сай ұйымдастырыңыз.
Бейнемен бірге тікелей жасалатын дыбыс репликаларды, атмосфераны және көрнекі орындауды біріктіре алады. Өндіруші анықтамасында дыбыс әдепкіде өшірулі, аудиовизуалдық көрініс үшін қосылады. 3.0 тіл профиліне қытай, ағылшын, жапон, корей және испан тілдері, сонымен бірге тіл алмастыру және қолдау көрсетілетін диалект не акцент өңдеуі кіреді. Өндіруші нұсқаулығында басқа тілде енгізілген диалог ағылшын тіліне аударылатыны айтылған. Әр репликаны қажетті нысанға тағайындап, диалогты фон дыбысынан ажыратыңыз: дыбыс тапсырмасы кім сөйлейтінін және әрекетті не қоршайтынын түсіндірсін.
Авторлық екі кейіпкер тапсырмасы A және B сөйлеушіні атап, әрқайсысына қысқа реплика беріп, олардың арасындағы көрінетін реакцияны сипаттай алады. Диалогты ролик ұзақтығына сәйкестендіріп, көрініс өзгергенде сөйлеушіні атаңыз. Дауыс нұсқауы мен кейіпкер референсі әртүрлі мақсатқа қызмет етеді; референс сурет айтылатын сөздерді қамтиды деп ойламай, тапсырмада қажетті орындауды көрсетіңіз.
VIDEO 3.0 суреттік көріністегі көрінетін жазуды өңдеуді де жақсартады. Маңдайша, жапсырма не титр маңызды болса, оны тапсырмада атап, референстік келбетін сақтаңыз. Дайын роликте сол жазудың емлесін, оқылуын және қозғалысын, әсіресе өнім не науқан хабарын жеткізгенде тексеріңіз. Модельдің жазу мүмкіндігі генерацияны бағыттайды, соңғы визуалдық тексеруді алмастырмайды.
Pro профилі — 1080p; Standard — 720p. Өндірушінің бөлек таңдалатын 4K режимі басқа шығыс профилі, сондықтан Pro барлық жоғары ажыратымдылық параметрінің баламасы емес. Мәтіндік генерацияның құжатталған кадрлау таңдауларына 16:9, 9:16 және 1:1 кіреді. Кадрды қолданылатын орынға сай таңдап, композицияны оның ішінде түсінікті сақтаңыз.
Генерация тапсырма ретінде жүреді; сәтті нәтиже дайын бейне артефактісін және нақты ұзақтығын береді. Өндірушінің нәтиже құжаттамасында жасалған бейнелер 30 күннен кейін жойылатыны айтылады, сондықтан дайын роликті дереу сақтаңыз. Бейнені тапсырмасы және референс ресурстарымен бірге сақтап, нысан сабақтастығын, сұралған план ретін, камера қозғалысын, диалогты және жазуды тексеріңіз. Таңдалған роликті кинематографиялық тұжырымдама, өнім көрінісі немесе қысқа оқиға ретінде қолданып, керекті нәтижеге жетпеген бөлігіне нысаналы түзету енгізіңіз.
Ailoot Ultra · Бейне POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proБастау
Kling VIDEO 3.0 Pro — мәтінге және суретке негізделген көріністерге арналған Kuaishou 1080p кәсіби бейне профилі. Ол үш–он бес секундтық роликтерді, бейнемен бірге тікелей жасалатын дыбысты, бағытталған шеткі кадрларды және бір не бірнеше план нұсқауын біріктіріп, кинематографиялық тұжырымдамалар мен қысқа қойылымдарға қызмет етеді.
- Қабылданатын кіріс деректері
- Мәтін · Суреттер
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text,image- Шығыс
video- Шығыс пішімі
- бастапқы MP4 байттары; қалыпқа келтірусіз/қайта кодтаусыз
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер kwaivgi/kling-v3.0-pro | Әдепкі— |
Өріс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-pro
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-pro
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.224 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.336 бейне секунды үшін |
| БаптауСуреттен бейне жасау (кадр суреттері) · 1080p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы1080p | Үлгі режиміСуреттен бейне жасау (кадр суреттері) | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.224 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.224 бейне секунды үшін |
| БаптауМәтіннен бейне жасау · 1080p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы1080p | Үлгі режиміМәтіннен бейне жасау | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.224 нәтиженің секунды үшін |
| БаптауМәтіннен бейне жасау · 480p · Анықтамалық тариф | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасыreference_output_rate | Үлгі ажыратымдылығы480p | Үлгі режиміМәтіннен бейне жасау | Үлгі аудиоАудиосыз | Есептеу бірлігінәтиженің секунды үшін | Төлемді есептеу шарттары— | Төлем Шығыс · Шығыс видео секундының анықтамалық тарифі · Тек салыстыруға арналған бағалау $0.224 нәтиженің секунды үшін |
| БаптауБейне бағасы | Мөлшерлемелер кестесі— | Болжамды мөлшер— | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігібейне секунды үшін | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы · Тек салыстыруға арналған бағалау $0.224 бейне секунды үшін |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем құрамдасы— | Үлгі ажыратымдылығы— | Үлгі режимі— | Үлгі аудио— | Есептеу бірлігі— | Төлемді есептеу шарттары— | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.672 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Анықтамалық тариф мәліметтері
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
Бейне конфигурацияларының баға сілтемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауБейне бағасы | Төлемді есептеу шарттарыБұл баға кілтінде қосымша шарт көрсетілмеген. | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыаудио: with_audio | Төлем Шығыс · Видео бағасы $0.336 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 480p | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 720p | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: text_to_video; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
| БаптауБейне бағасы | Төлемді есептеу шарттарыжасау режимі: image_to_video; ажыратымдылық: 1080p | Төлем Шығыс · Видео бағасы $0.224 бейне секунды үшін Көрсетілген конфигурация үшін жарияланған анықтамалық баға. Соңғы төлемдер ақысы есептелген нақты конфигурацияға сай алынады. |
Сұрау мысалдары
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-pro","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-pro
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · Kling: Video v3.0 Pro
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·kwaivgi/kling-v3.0-pro: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-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1