Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro — matn va rasmga asoslangan sahnalar uchun Kuaishou ning 1080p professional video profili. U kinematografik g‘oyalar va qisqa ishlab chiqarishlar uchun uch–o‘n besh soniyalik kliplar, ichki audio, yo‘naltirilgan chegara kadrlar va bir yoki ko‘p kadrli boshqaruvni birlashtiradi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Kling VIDEO 3.0 Pro — Kuaishou ning VIDEO 3.0 modelidagi professional profil. Hujjatlashtirilgan Pro rejimi matn topshirig‘i yoki rasmga asoslangan sahnadan uchdan o‘n besh soniyagacha 1080p video yaratadi. 3.0 nashri ichki audio, obyekt izchilligi boshqaruvlari va ko‘p kadrli yo‘nalishni birlashtiradi; qisqa ishlab chiqarishda ko‘rinish, harakat, kamera ko‘rsatishi va tovushni aniq belgilash yo‘lini beradi.
Sahnaning asosiy harakatidan boshlang. Matnga asoslangan kadrda obyekt, muhit, yorug‘lik va harakatni ravshan qiladigan qarash nuqtasini tasvirlang. Rasmga asoslangan kadrda boshlang‘ich rasm ko‘rinish va kompozitsiyani belgilasin, matn esa vaqt davomida nima o‘zgarishini aytsin. Asl mahsulot g‘oyasida tayyor rasm buyumni studiya sirtida ko‘rsatishi, ko‘rsatma esa material va shaklining sekin ochilishini tasvirlashi mumkin.
Ko‘p kadrli yo‘nalish avtomatik ko‘rsatish yoki maxsus ketma-ketlikni beradi. Avtomatik ko‘p kadrli yaratish topshiriqdan kadr tuzilishi va kamera burchagi o‘zgarishlarini rejalaydi; bitta uzluksiz qarashga sig‘adigan sahna bir kadr bo‘lib qolishi mumkin. Maxsus kadrlar rejasi har bir kadrning mazmuni va davomiyligini belgilashga imkon beradi. Ishlab chiqaruvchining maxsus kadr profili birdan oltitagacha kadrga ruxsat beradi, har biriga ko‘pi bilan 512 belgi va kamida bir soniya; davomiyliklari umumiy klip davomiyligiga teng bo‘lishi kerak.
Qisqa hikoyada muhitni belgilovchi ko‘rinish, asosiy harakat va yakuniy detalni alohida kadrlar sifatida tasvirlang. Har birida kamera ishlovi va auditoriya nimani payqashi kerakligini ayting. Harakat va ko‘rsatishni maqsadli o‘zgartirib, takrorlanuvchi obyekt ko‘rinishini topshiriqda izchil tuting. Yaratuvchi ma’lumotnomasidagi bitta ko‘rsatma maydoni 2,500 tagacha belgini qabul qiladi; maxsus ketma-ketlik alohida kadr tavsiflaridan foydalanadi.
Qahramon, mahsulot yoki joy tanib bo‘ladigan qolishi kerak bo‘lganda obyekt namunalari rasmga asoslangan sahnani qo‘llashi mumkin. Saqlanishi kerak bo‘lgan belgilarni yetkazadigan aniq rakurslarni tanlang va har bir namuna obyektini izchil nomlang. Hujjatlashtirilgan rasmga asoslangan profil uchtagacha tayyor elementga ruxsat beradi. Obyekt ko‘rinishiga zid yo‘riqlar beruvchi bir nechta materialni birlashtirmay, namuna rollarini aniq tuting.
Boshlang‘ich va yakuniy kadrlar rasmga shartlangan o‘tish uchun vizual chegaralar beradi. Obyekt va ko‘zlangan sahna bo‘yicha mos kadrlarni tayyorlang, keyin harakat ularni qanday bog‘lashini tasvirlang. Yaratuvchining qo‘llab-quvvatlanadigan kadr kirishi JPG, JPEG yoki PNG rasmlar, 10 MB dan katta bo‘lmagan fayllar, kamida 300 pikselli o‘lchamlar va 1:2.5 bilan 2.5:1 orasidagi boshlang‘ich rasm tomonlar nisbatini ishlatadi. Kadr bilan boshqariladigan vazifa va maxsus kadrlar rejasining kirishni qayta ishlashi alohida, shuning uchun to‘liq topshiriqni yozishdan oldin materialni tanlangan jarayonga mos tashkil qiling.
Ichki audio aytiladigan gaplar, muhit va vizual ijroni birlashtirishi mumkin. Yaratuvchi ma’lumotnomasida audio standart o‘chiq va audiovizual sahna uchun yoqiladi. 3.0 til profili xitoy, ingliz, yapon, koreys va ispan tillari, til almashishi hamda qo‘llab-quvvatlanadigan lahja yoki aksent ishlovlarini o‘z ichiga oladi. Yaratuvchi qo‘llanmasi boshqa tilda kiritilgan dialog inglizchaga tarjima qilinishini aytadi. Audio topshirig‘i kim gapirishi va harakat atrofida nima borligini tushuntirishi uchun har bir gapni tegishli obyektga biriktiring va dialogni fon tovushidan farqlang.
Asl ikki qahramonli topshiriq So‘zlovchi A va So‘zlovchi B ni belgilashi, har biriga qisqa gap berishi va ularning orasidagi ko‘rinadigan reaksiyani tasvirlashi mumkin. Dialogni klip uzunligiga mutanosib tuting va ko‘rinish o‘zgarganda so‘zlovchini belgilang. Ovoz yo‘nalishi va qahramon namunasi turli maqsadlarga xizmat qiladi; namuna rasm aytiladigan so‘zlarni o‘z ichiga oladi deb taxmin qilmay, topshiriq kerakli ijroni aytsin.
VIDEO 3.0 rasmga asoslangan sahnada ko‘rinadigan yozuv bilan ishlashni ham yaxshilaydi. Belgi, yorliq yoki yozuv muhim bo‘lsa, topshiriqda uni belgilang va namunadagi ko‘rinishini saqlang. Ayniqsa mahsulot yoki kampaniya xabarini yetkazganda tayyor klipni shu yozuvning imlosi, o‘qiluvchanligi va harakati bo‘yicha tekshiring. Modelning yozuv imkoniyati yakuniy vizual tekshiruvni almashtirmay, yaratishni yo‘naltiradi.
Pro profili 1080p; Standard profili 720p. Ishlab chiqaruvchining alohida tanlanadigan 4K rejimi boshqa chiqish profili, shuning uchun Pro ni har bir yuqoriroq aniqlik sozlamasining sinonimi deb ko‘rmaslik kerak. Matnga asoslangan yaratishda hujjatlashtirilgan kadr tanlovlariga 16:9, 9:16 va 1:1 kiradi. Kadrni kerakli joylashtirishga tanlang va kompozitsiyani uning ichida ravshan saqlang.
Yaratish muvaffaqiyatli natijasi tugallangan video artefakti va haqiqiy davomiylikni ochadigan vazifa sifatida ishlaydi. Yaratuvchining natija hujjati yaratilgan videolar 30 kundan keyin o‘chirilishini aytadi, shuning uchun tayyor klipni tezda saqlang. Videoni topshirig‘i va namuna materiallari bilan saqlang, keyin obyekt ko‘rinishining izchilligi, so‘ralgan kadr tartibi, kamera harakati, dialog va yozuvni tekshiring. Tanlangan klipni kinematografik g‘oya, mahsulot sahnasi yoki qisqa hikoya sifatida ishlating va kerakli natijani bermagan qismga maqsadli tuzatish kiriting.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proBoshlash
Kling VIDEO 3.0 Pro — matn va rasmga asoslangan sahnalar uchun Kuaishou ning 1080p professional video profili. U kinematografik g‘oyalar va qisqa ishlab chiqarishlar uchun uch–o‘n besh soniyalik kliplar, ichki audio, yo‘naltirilgan chegara kadrlar va bir yoki ko‘p kadrli boshqaruvni birlashtiradi.
- Qabul qilinadigan kirish ma’lumotlari
- Matn · Rasmlar
- Natijalar
- Video
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · Video POST /v1/videos
- Kirish
text,image- Chiqish
video- Chiqish formati
- asl MP4 baytlari; normallashtirishsiz/qayta kodlashsiz
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar kwaivgi/kling-v3.0-pro | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar | Standart— |
Maydonduration | Turinteger | TalabMajburiy | Qiymatlar va cheklovlar 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Eng kam: 1 Eng ko‘p: 600 | Standart— |
Maydonresolution | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 720p | Standart— |
Maydonaspect_ratio | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 16:9, 9:16, 1:1 | Standart— |
Maydongenerate_audio | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar false, true Shartlar: Bu parametrni bermaslik audioli narxni tanlaydi. Audiosiz narxni tanlash uchun false qilib belgilang. Audio yo‘lak qaytarilganini bilish uchun natijadagi has_audio ni tekshiring. | Standart— |
Maydonframe_images | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 1 Elementlarning eng ko‘p soni: 2 Kirish kontenti: Kadr obyektlari massivi. Har bir obyektda type=image_url, url saqlovchi image_url va frame_type mavjud. HTTPS rasm URL idan foydalaning va frame_type qiymatini first_frame yoki last_frame qilib belgilang. Har bir kadr vazifasi ko‘pi bilan bir marta uchraydi. Aniq kalitlar: type, image_url, frame_type Shartlar: Bu kalitlar har bir kadr obyektini tavsiflaydi; image_url faqat url ni saqlaydi. Faqat matnli so‘rov uchun frame_images ni yubormang. | Standart— |
Maydoninput_references | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 1280x720, 720x1280, 720x720 Andoza: ^[1-9][0-9]*x[1-9][0-9]*$ | Standart— |
Maydoncallback_url | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Andoza: ^https:// | Standart— |
Maydonsession_id | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydontrace | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonuser | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Kirish materiallari birikmalari
Matndan video · Yozma ko‘rsatma. · Majburiy: model, prompt, duration
prompt ni matn, duration ni butun soniyalarda bering. Qo‘llab-quvvatlanadigan aniqlikni tanlang; tomonlar nisbatini qo‘shing yoki ro‘yxatdagi o‘lchamdan foydalaning.
model: Turi: string · kwaivgi/kling-v3.0-pro
prompt: Turi: string · UTF-8 baytlarining eng ko‘p soni: 10 000 · Bo‘shliq belgisi bo‘lmagan kamida bitta belgi talab qilinadi: Ha
Rasmdan video · Yozma ko‘rsatma va birinchi kadr rasmi. · Majburiy: model, prompt, duration, frame_images
frame_images — massiv. Har bir kadr obyektida type, image_url va frame_type mavjud; image_url ichida url bo‘ladi. type qiymatini image_url qilib belgilang. first_frame va ixtiyoriy last_frame dan foydalaning. Har bir kadr vazifasi ko‘pi bilan bir marta uchraydi. Har bir kadr uchun ochiq HTTPS rasm URL ini bering. Qo‘llab-quvvatlanadigan aniqlikni tanlang; tomonlar nisbatini qo‘shing yoki ro‘yxatdagi o‘lchamdan foydalaning.
Aniq kalitlar: type, image_url, frame_type
model: Turi: string · kwaivgi/kling-v3.0-pro
prompt: Turi: string · UTF-8 baytlarining eng ko‘p soni: 10 000 · Bo‘shliq belgisi bo‘lmagan kamida bitta belgi talab qilinadi: Ha
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt, duration |
Parametrmaterial_types | Parametr talablaritext, image |
Parametradditional_properties | Parametr talablarifalse |
Parametroptional_controls | Parametr talablariresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Hayot sikli: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tariflar
Yakuniy to‘lov qanday hisoblanadi
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
- Tezkor rejim
- Ko‘rsatilmagan Tezkor rejim tanlanganda
- Flex rejimi
- Ko‘rsatilmagan flex rejimi tanlanganda
- Maksimal fikrlash darajasi
- Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda
Taqqoslash uchun taxminiy tariflar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | To‘lov tarkibiy qismi | Namuna aniqligi | Namuna rejimi | Namuna audio | Hisob birligi | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|---|---|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | To‘lov tarkibiy qismi— | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birligi— | To‘lovni hisoblash shartlari— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaVideo chiqishi · ma’lumot uchun tarif | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismireference_output_rate | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birliginatijaning soniyasi uchun | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Chiqish videosining soniyasi uchun ma’lumot tariqasidagi tarif · Faqat taqqoslash uchun taxmin $0.224 natijaning soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismi— | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariovoz: with_audio | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.336 video soniyasi uchun |
| SozlamaRasmdan video (kadr rasmlari) · 1080p · ma’lumot uchun tarif | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismireference_output_rate | Namuna aniqligi1080p | Namuna rejimiRasmdan video (kadr rasmlari) | Namuna audioAudiosiz | Hisob birliginatijaning soniyasi uchun | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Chiqish videosining soniyasi uchun ma’lumot tariqasidagi tarif · Faqat taqqoslash uchun taxmin $0.224 natijaning soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismi— | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariyaratish rejimi: image_to_video; aniqlik: 720p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.224 video soniyasi uchun |
| SozlamaMatndan video · 1080p · ma’lumot uchun tarif | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismireference_output_rate | Namuna aniqligi1080p | Namuna rejimiMatndan video | Namuna audioAudiosiz | Hisob birliginatijaning soniyasi uchun | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Chiqish videosining soniyasi uchun ma’lumot tariqasidagi tarif · Faqat taqqoslash uchun taxmin $0.224 natijaning soniyasi uchun |
| SozlamaMatndan video · 480p · ma’lumot uchun tarif | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismireference_output_rate | Namuna aniqligi480p | Namuna rejimiMatndan video | Namuna audioAudiosiz | Hisob birliginatijaning soniyasi uchun | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Chiqish videosining soniyasi uchun ma’lumot tariqasidagi tarif · Faqat taqqoslash uchun taxmin $0.224 natijaning soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | To‘lov tarkibiy qismi— | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariyaratish rejimi: text_to_video; aniqlik: 720p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.224 video soniyasi uchun |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | To‘lov tarkibiy qismi— | Namuna aniqligi— | Namuna rejimi— | Namuna audio— | Hisob birligi— | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.672 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
Ma’lumot uchun tarif tafsilotlari
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
Video sozlamalari narxiga havolalar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| SozlamaVideo narxi | To‘lovni hisoblash shartlariUshbu narxlash kalitida qo‘shimcha shart ko‘rsatilmagan. | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariovoz: with_audio | To‘lov Chiqish · Video narxi $0.336 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: text_to_video; aniqlik: 480p | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: text_to_video; aniqlik: 720p | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: image_to_video; aniqlik: 720p | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: text_to_video; aniqlik: 1080p | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: image_to_video; aniqlik: 1080p | To‘lov Chiqish · Video narxi $0.224 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
So‘rov namunalari
Ailoot Ultra · Video
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
Natijalarni olish va saqlash
Ailoot Ultra · Video
egalik qilinadigan mazmunning imzolangan URL lari
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Vazifa holatini tekshirish
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
Boshqa kontentni o‘qish
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
Barcha tayyor natijalarni saqlash
Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.
Egalik qilinadigan har bir haqiqiy chiqish natijasini va u bilan qaytarilgan o‘lchangan metama’lumotlarni saqlang.
Asl javobni tekshirish kerak bo‘lsa
503 result_pending_check + dastlabki id + X-Should-Retry:false; dastlabki so‘rovni hech qachon qayta yubormang
Javob maydonlari
| Maydon | Tur | Ma’nosi |
|---|---|---|
Maydonindex | Turinteger | Ma’nosiUshbu videoning chiqishlar ro‘yxatidagi noldan boshlanuvchi o‘rni. |
Maydoncontent_url | Turstring | Ma’nosiUshbu yakunlangan video uchun imzolangan HTTPS yuklab olish URL i. |
Maydonsha256 | Turstring | null | Ma’nosiDastlabki video baytlarining SHA-256 xeshi; mavjud bo‘lmasa null. |
Maydonsize_bytes | Turinteger | null | Ma’nosiDastlabki video faylining baytlardagi hajmi; mavjud bo‘lmasa null. |
Maydonduration_ms | Turinteger | null | Ma’nosiVideoning millisoniyalarda o‘lchangan davomiyligi; mavjud bo‘lmasa null. |
Maydonwidth | Turinteger | null | Ma’nosiVideoning piksellardagi eni; mavjud bo‘lmasa null. |
Maydonheight | Turinteger | null | Ma’nosiVideoning piksellardagi bo‘yi; mavjud bo‘lmasa null. |
Maydonvideo_codec | Turstring | null | Ma’nosiVideo kodeki identifikatori; qayd etilmagan bo‘lsa null. |
Maydonhas_audio | Turboolean | null | Ma’nosiVideoda audio yo‘lak bor-yo‘qligi; o‘lchanmagan bo‘lsa null. |
Maydonaudio_codec | Turstring | null | Ma’nosiAudio kodeki identifikatori; identifikator qayd etilmagan bo‘lsa null. |
Xatolar va keyingi qadamlar
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob404 · not_found_error | ShartVideoga kirish mavjud emas yoki ushbu video ID si topilmadi. | Keyingi qadamVideoga kirishni tekshiring. Mavjud video uchun uning dastlabki ochiq ID si va ayni API kalitidan foydalaning. |
Javob401 · authentication_error | ShartAPI kaliti autentifikatsiyadan o‘tgan hisobga mos kelmaydi. | Keyingi qadamYuborishdan oldin API kalitingiz va hisobga kirishingizni tekshiring. |
Javob400 · invalid_request_error | ShartSo‘rovni o‘qib bo‘lmadi yoki yuklab olish indeksi yaroqsiz. | Keyingi qadamSo‘rov tanasini tuzating. Yuklab olish uchun dastlabki vazifa qaytargan chiqish indeksini tanlang. |
Javob422 · price_unavailable | ShartTanlangan video sozlamasining narxini hisoblab bo‘lmaydi. | Keyingi qadamTuzatilgan so‘rovni yuborishdan oldin qo‘llab-quvvatlanadigan video sozlamasini tanlang va uning majburiy parametrlarini to‘ldiring. |
Javob422 · invalid_request_error | ShartVideo kirishi yoki dastlabki davom ettirish vazifasi yaroqsiz. | Keyingi qadamYaroqli HTTPS kirishlaridan foydalaning. Davom ettirish uchun yakunlangan dastlabki videongizning ochiq ID si va ayni API kalitidan foydalaning. |
Javob402 · billing_error | ShartMavjud balans yoki limitlar mablag‘ni band qilishga imkon bermaydi. | Keyingi qadamYangi so‘rov yuborishdan oldin mavjud balans va limitlaringizni tekshiring. |
Javob503 · server_error | ShartVideoni tekshirish, saqlash yoki xizmatga kirish vaqtincha mavjud emas. | Keyingi qadamXizmat mavjud bo‘lishini kuting. Video ID si allaqachon bo‘lsa, boshqa yaratishni boshlash o‘rniga shu dastlabki vazifani tekshiring. |
Javob503 · result_pending_check | ShartDastlabki video natijasi va to‘lovni tekshirish kerak. | Keyingi qadamQaytarilgan video ID sini saqlang va shu vazifani tekshiring. U tekshirilayotgan paytda o‘rniga boshqa yaratish so‘rovini yubormang. |
Javob503 · owned_result_unavailable | ShartMavjud videoni yuklab olish vaqtincha ishlamayapti. | Keyingi qadamKeyinroq ayni video vazifasini tekshiring va uning mavjud chiqishini yuklab oling. Yangi yaratish alohida operatsiya hosil qiladi. |
Javob409 · video_not_ready | ShartVideo mazmuni e’lon qilinmagan. | Keyingi qadamDastlabki vazifa holatini tekshiring. completed bildirgach yuklab oling; failed bildirsa, uning to‘lovni tekshirish bildirishnomasiga rioya qiling. |
Taxalluslar
Model taxalluslari
Ailoot Ultra kwaivgi/kling-v3.0-pro
Usul yo‘llari taxalluslari
Yuqorida ko‘rsatilgan usul yo‘llaridan foydalaning.
Chaqirish uchun tegishli ID lar
FAQ · Kling: Video v3.0 Pro
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- So‘rov qaysi maydonlardan foydalanadi?
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- Qanday cheklovlar amal qiladi?
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1