Source: https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/
Canonical: https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/
Language: kk

# Kling: Video v3.0 Pro

[Markdown](https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/index.md) · [JSON](https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/facts.json)

## [Kling: Video v3.0 Pro](https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/)

Kling VIDEO 3.0 Pro — мәтінге және суретке негізделген көріністерге арналған Kuaishou 1080p кәсіби бейне профилі. Ол үш–он бес секундтық роликтерді, бейнемен бірге тікелей жасалатын дыбысты, бағытталған шеткі кадрларды және бір не бірнеше план нұсқауын біріктіріп, кинематографиялық тұжырымдамалар мен қысқа қойылымдарға қызмет етеді.

- [**Ailoot Ultra · Бейне** `POST /v1/videos` `kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/kk/kwaivgi-kling-v3-0-pro/#method-0)

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

Бұл сипаттама модель мүмкіндіктерін қамтиды. 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`](https://ailoot.ai/models/kk/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

Kuaishou /`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 сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. [Резервтеу мен төлемді есептеу тәртібі →](https://ailoot.ai/docs/kk/billing/reserve/)

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

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған 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 · Бейне

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

```bash
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`

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

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

```bash
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
```

Басқа мазмұнды оқу

Өзіңізге тиесілі әр дайын нәтижені сақтау

```bash
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`](https://ailoot.ai/models/kk/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

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

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

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

[`kwaivgi/kling-v3.0-pro`](https://ailoot.ai/models/kk/#m=kwaivgi%2Fkling-v3.0-pro&route=Ultra&caller=kwaivgi%2Fkling-v3.0-pro&fmt=videos)

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`

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

## Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

## Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым

Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.

50% дейінгі промокод

Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.

Тарихтағы шығындар

Әр сұрауға модель, токен және сома сақталады.

[Жазылым таңдау](https://ailoot.ai/docs/kk/billing/subscriptions/) · [Модель бағасын көру](https://ailoot.ai/models/kk/)

## API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба

Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.

Реселлер лицензиясы

Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.

Сайттағы құжаттар

Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

[Реселлер лицензиясын сұрау](mailto:support@ailoot.ai) · [Оферта мен лицензиялық шарт](https://ailoot.ai/legal/offer?lang=kk)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.