Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro yra Kuaishou profesionalus 1080p vaizdo profilis tekstu ir vaizdu valdomoms scenoms. Jis derina trijų–penkiolikos sekundžių klipus, kartu generuojamą garsą, valdomus ribinius kadrus bei vieno ar kelių planų režisūrą kinematografinėms koncepcijoms ir trumpiems kūriniams.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Kling VIDEO 3.0 Pro yra profesionalus Kuaishou VIDEO 3.0 modelio profilis. Dokumentuotas Pro režimas kuria 1080p vaizdo įrašus iš tekstinės užduoties arba vaizdu valdomos scenos, o klipų trukmė yra nuo trijų iki penkiolikos sekundžių. 3.0 versija derina kartu generuojamą garsą, objektų nuoseklumo valdiklius ir kelių planų režisūrą, suteikdama trumpam kūriniui aiškų būdą nurodyti išvaizdą, veiksmą, kameros planus bei garsą.
Pradėkite nuo pagrindinio scenos veiksmo. Tekstu valdomame plane aprašykite objektą, aplinką, šviesą ir žiūros tašką, kuriame veiksmas aiškiai suprantamas. Vaizdu valdomame plane leiskite pradiniam vaizdui nustatyti išvaizdą ir kompoziciją, o tekstu aprašykite, kas kinta laikui bėgant. Originaliai produkto koncepcijai paruoštas vaizdas gali rodyti daiktą ant studijinio paviršiaus, o užklausa – lėtą jo medžiagos ir formos atskleidimą.
Kelių planų režisūra siūlo automatinį scenos parodymą arba pasirinktinę seką. Automatinis kelių planų generavimas pagal užduotį suplanuoja kadravimo ir kameros kampo pokyčius; scena, telpanti į vieną nenutrūkstamą vaizdą, vis tiek gali likti vienu planu. Pasirinktinė kadruotė leidžia apibrėžti kiekvieno plano turinį ir trukmę. Gamintojo pasirinktinio plano profilis leidžia nuo vieno iki šešių planų, iki 512 simbolių kiekvienam ir mažiausiai po vieną sekundę; jų trukmių suma turi atitikti bendrą klipo trukmę.
Trumpam pasakojimui atskirais planais aprašykite aplinką pristatantį vaizdą, pagrindinį veiksmą ir baigiamąją detalę. Kiekviename nurodykite kameros darbą ir tai, ką žiūrovas turi pastebėti. Užduotyje išlaikykite pasikartojančio objekto išvaizdos nuoseklumą, o veiksmą ir planus keiskite sąmoningai. Gamintojo žinyno vienos užklausos laukas priima iki 2 500 simbolių; pasirinktinė seka naudoja atskirus kiekvieno plano aprašymus.
Objektų orientyrai gali padėti vaizdu valdomai scenai, kai personažas, produktas ar aplinka turi likti atpažįstami. Parinkite aiškius vaizdus, perteikiančius išsaugotinas savybes, ir kiekvieną orientyrinį objektą vadinkite nuosekliai. Dokumentuotas vaizdu valdomas profilis leidžia iki trijų paruoštų elementų. Orientyrų vaidmenis išlaikykite kryptingus, užuot jungę kelis failus, duodančius prieštaringus objekto išvaizdos nurodymus.
Pirmasis ir paskutinis kadrai suteikia vaizdines ribas vaizdu sąlygotam perėjimui. Paruoškite kadrus, derančius tarpusavyje pagal objektą ir numatytą sceną, tada aprašykite juos jungiantį judėjimą. Gamintojo palaikoma kadrų įvestis naudoja JPG, JPEG arba PNG vaizdus iki 10 MB, bent 300 pikselių matmenų ir pradinio vaizdo kraštinių santykį nuo 1:2.5 iki 2.5:1. Kadrų valdoma užduotis ir pasirinktinė kadruotė turi atskirą įvesties apdorojimą, todėl prieš rašydami visą užduotį sutvarkykite medžiagą pasirinktai eigai.
Kartu generuojamas garsas gali derinti replikas, atmosferą ir vaizdinį atlikimą. Gamintojo žinyne garsas pagal numatytuosius nustatymus išjungtas ir įjungiamas audiovizualinei scenai. 3.0 kalbų profilis apima kinų, anglų, japonų, korėjiečių ir ispanų kalbas, kartu su kalbų kaita ir palaikomomis tarmėmis ar akcentais. Gamintojo vadovas sako, kad kita kalba įvestas dialogas išverčiamas į anglų. Kiekvieną repliką priskirkite numatytam objektui ir atskirkite dialogą nuo foninio garso, kad garso užduotis paaiškintų, kas kalba ir kas supa veiksmą.
Originali dviejų personažų užduotis gali įvardyti Kalbėtoją A ir Kalbėtoją B, kiekvienam duoti trumpą repliką ir aprašyti matomą reakciją tarp jų. Dialogo apimtį derinkite prie klipo trukmės ir įvardykite kalbėtoją, kai vaizdas keičiasi. Balso režisūra ir personažo orientyras turi skirtingą paskirtį; užduotyje reikia nurodyti norimą atlikimą, užuot manius, kad orientyriniame vaizde jau yra pasakytini žodžiai.
VIDEO 3.0 taip pat gerina matomų užrašų tvarkymą vaizdu valdomoje scenoje. Jei iškaba, etiketė ar antraštė svarbi, įvardykite ją užduotyje ir išlaikykite jos orientyrinę išvaizdą. Užbaigtame klipe patikrinkite šio teksto rašybą, įskaitomumą ir judėjimą, ypač kai jis perduoda produkto ar kampanijos žinutę. Modelio užrašų funkcija nukreipia generavimą, bet nepakeičia galutinės vaizdinės patikros.
Pro profilis yra 1080p; Standard – 720p. Atskirai pasirenkamas gamintojo 4K režimas yra kitas išvesties profilis, todėl Pro nereikėtų laikyti visų aukštesnės raiškos nustatymų sinonimu. Kuriant iš teksto, dokumentuoti kadravimo variantai apima 16:9, 9:16 ir 1:1. Kadrą rinkitės pagal numatytą paskirties vietą ir išlaikykite jame aiškiai skaitomą kompoziciją.
Generavimas vyksta kaip užduotis, kurios sėkmingame rezultate pateikiamas užbaigtas vaizdo failas ir tikroji trukmė. Gamintojo rezultatų dokumentacija sako, kad sugeneruoti vaizdo įrašai ištrinami po 30 dienų, todėl užbaigtą klipą išsaugokite nedelsdami. Vaizdo įrašą laikykite kartu su jo užduotimi bei orientyriniais failais, tada peržiūrėkite objekto vientisumą, prašytą planų tvarką, kameros judėjimą, dialogą ir užrašus. Pasirinktą klipą naudokite kaip kinematografinę koncepciją, produkto sceną arba trumpą pasakojimą ir kryptingai pataisykite tą dalį, kuri neatitiko norimo rezultato.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proPradžia
Kling VIDEO 3.0 Pro yra Kuaishou profesionalus 1080p vaizdo profilis tekstu ir vaizdu valdomoms scenoms. Jis derina trijų–penkiolikos sekundžių klipus, kartu generuojamą garsą, valdomus ribinius kadrus bei vieno ar kelių planų režisūrą kinematografinėms koncepcijoms ir trumpiems kūriniams.
- Leidžiamos įvestys
- Tekstas · Vaizdai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image- Išvestis
video- Išvesties formatas
- originalūs MP4 baitai; be normalizavimo ar perkodavimo
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos kwaivgi/kling-v3.0-pro | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 720p | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 9:16, 1:1 | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false, true Sąlygos: Praleidus šią parinktį taikoma kaina su garsu. Nustatykite false, kad pasirinktumėte kainą be garso. Rezultate patikrinkite has_audio, kad sužinotumėte, ar grąžintas garso takelis. | Numatyta— |
Laukasframe_images | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 2 Įvesties turinys: Kadrų objektų masyvas. Kiekviename objekte yra type=image_url, image_url su url ir frame_type. Naudokite HTTPS paveikslėlio URL ir nustatykite frame_type reikšmę first_frame arba last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Tikslūs raktai: type, image_url, frame_type Sąlygos: Šie raktai apibūdina kiekvieną kadro objektą; image_url turi tik url. Jei užklausoje yra tik tekstas, praleiskite frame_images. | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 1280x720, 720x1280, 720x720 Šablonas: ^[1-9][0-9]*x[1-9][0-9]*$ | Numatyta— |
Laukascallback_url | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^https:// | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Įvesties medžiagos deriniai
Iš teksto į vaizdo įrašą · Tekstinė užklausa. · Privaloma: model, prompt, duration
Pateikite prompt kaip tekstą ir duration sveikomis sekundėmis. Pasirinkite palaikomą skiriamąją gebą; pridėkite kraštinių santykį arba naudokite išvardytą dydį.
model: Tipas: string · kwaivgi/kling-v3.0-pro
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Iš vaizdo į vaizdo įrašą · Tekstinė užklausa ir pirmojo kadro paveikslėlis. · Privaloma: model, prompt, duration, frame_images
frame_images yra masyvas. Kiekviename kadro objekte yra type, image_url ir frame_type; image_url turi url lauką. Nustatykite type reikšmę image_url. Naudokite first_frame ir neprivalomą last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Kiekvienam kadrui pateikite viešą HTTPS paveikslėlio URL. Pasirinkite palaikomą skiriamąją gebą; pridėkite kraštinių santykį arba naudokite išvardytą dydį.
Tikslūs raktai: type, image_url, frame_type
model: Tipas: string · kwaivgi/kling-v3.0-pro
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, duration |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasadditional_properties | Specifikacijafalse |
Parametrasoptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Gyvavimo ciklas: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Mokesčio komponentas | Pavyzdžio raiška | Pavyzdžio režimas | Pavyzdinis garsas | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
|---|---|---|---|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaVaizdo įrašo išvestis · orientacinis tarifas | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentasreference_output_rate | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetasuž išvesties sekundę | Apmokestinimo sąlygos— | Mokestis Išvestis · Išvesties vaizdo įrašo sekundės orientacinis tarifas · Įvertis tik palyginimui $0.224 už išvesties sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgarsas: with_audio | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.336 už vaizdo įrašo sekundę |
| KonfigūracijaPaveikslėlis į vaizdo įrašą (kadrų paveikslėliai) · 1080p · orientacinis tarifas | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentasreference_output_rate | Pavyzdžio raiška1080p | Pavyzdžio režimasIš vaizdo į vaizdo įrašą (kadrų vaizdai) | Pavyzdinis garsasBe garso | Apskaitos vienetasuž išvesties sekundę | Apmokestinimo sąlygos— | Mokestis Išvestis · Išvesties vaizdo įrašo sekundės orientacinis tarifas · Įvertis tik palyginimui $0.224 už išvesties sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: image_to_video; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.224 už vaizdo įrašo sekundę |
| KonfigūracijaTekstas į vaizdo įrašą · 1080p · orientacinis tarifas | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentasreference_output_rate | Pavyzdžio raiška1080p | Pavyzdžio režimasIš teksto į vaizdo įrašą | Pavyzdinis garsasBe garso | Apskaitos vienetasuž išvesties sekundę | Apmokestinimo sąlygos— | Mokestis Išvestis · Išvesties vaizdo įrašo sekundės orientacinis tarifas · Įvertis tik palyginimui $0.224 už išvesties sekundę |
| KonfigūracijaTekstas į vaizdo įrašą · 480p · orientacinis tarifas | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentasreference_output_rate | Pavyzdžio raiška480p | Pavyzdžio režimasIš teksto į vaizdo įrašą | Pavyzdinis garsasBe garso | Apskaitos vienetasuž išvesties sekundę | Apmokestinimo sąlygos— | Mokestis Išvestis · Išvesties vaizdo įrašo sekundės orientacinis tarifas · Įvertis tik palyginimui $0.224 už išvesties sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Mokesčio komponentas— | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: text_to_video; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.224 už vaizdo įrašo sekundę |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokesčio komponentas— | Pavyzdžio raiška— | Pavyzdžio režimas— | Pavyzdinis garsas— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.672 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Informacinio tarifo duomenys
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
Vaizdo įrašo konfigūracijų kainų nuorodos
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgarsas: with_audio | Mokestis Išvestis · Vaizdo įrašo kaina $0.336 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: text_to_video; skiriamoji geba: 480p | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: text_to_video; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: image_to_video; skiriamoji geba: 720p | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: text_to_video; skiriamoji geba: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: image_to_video; skiriamoji geba: 1080p | Mokestis Išvestis · Vaizdo įrašo kaina $0.224 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
pasirašyti jums priklausančio turinio URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tikrinti užduoties būseną
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
Kito turinio skaitymas
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
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną tikrą jums priklausantį rezultatą ir grąžintus išmatuotus jo metaduomenis.
Jei reikia patikrinti pradinį atsakymą
503 result_pending_check + pradinis id + X-Should-Retry:false; niekada nekartokite pradinės užklausos
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasindex | Tipasinteger | ReikšmėŠio vaizdo įrašo pozicija rezultatų sąraše, skaičiuojama nuo nulio. |
Laukascontent_url | Tipasstring | ReikšmėPasirašytas HTTPS atsisiuntimo URL šiam užbaigtam vaizdo įrašui. |
Laukassha256 | Tipasstring | null | ReikšmėPradinio vaizdo įrašo baitų SHA-256 santrauka; null, jei nepasiekiama. |
Laukassize_bytes | Tipasinteger | null | ReikšmėPradinio vaizdo įrašo failo dydis baitais; null, jei nepasiekiamas. |
Laukasduration_ms | Tipasinteger | null | ReikšmėIšmatuota vaizdo įrašo trukmė milisekundėmis; null, jei nepasiekiama. |
Laukaswidth | Tipasinteger | null | ReikšmėVaizdo įrašo plotis pikseliais; null, jei nepasiekiamas. |
Laukasheight | Tipasinteger | null | ReikšmėVaizdo įrašo aukštis pikseliais; null, jei nepasiekiamas. |
Laukasvideo_codec | Tipasstring | null | ReikšmėVaizdo kodeko identifikatorius; null, jei neužregistruotas. |
Laukashas_audio | Tipasboolean | null | ReikšmėAr vaizdo įraše yra garso takelis; null, jei nenustatyta. |
Laukasaudio_codec | Tipasstring | null | ReikšmėGarso kodeko identifikatorius; null, kai identifikatorius neužregistruotas. |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas404 · not_found_error | SąlygaPrieiga prie vaizdo įrašo nepasiekiama arba šis vaizdo įrašo ID nerastas. | Kitas žingsnisPatikrinkite prieigą prie vaizdo įrašo. Jei vaizdo įrašas jau yra, naudokite jo pradinį viešą ID ir tą patį API raktą. |
Atsakymas401 · authentication_error | SąlygaAPI raktas neatitinka autentifikuotos paskyros. | Kitas žingsnisPrieš pateikdami patikrinkite savo API raktą ir paskyros prieigą. |
Atsakymas400 · invalid_request_error | SąlygaNepavyko nuskaityti užklausos arba atsisiuntimo indeksas netinkamas. | Kitas žingsnisPataisykite užklausos turinį. Atsisiuntimui pasirinkite išvesties indeksą, kurį grąžino pradinė užduotis. |
Atsakymas422 · price_unavailable | SąlygaPasirinktos vaizdo įrašo konfigūracijos kainos nustatyti negalima. | Kitas žingsnisPasirinkite palaikomą vaizdo įrašo konfigūraciją ir prieš pateikdami pataisytą užklausą užpildykite jos privalomas parinktis. |
Atsakymas422 · invalid_request_error | SąlygaVaizdo įrašo įvestis arba pradinė tęsinio užduotis netinkama. | Kitas žingsnisNaudokite tinkamą HTTPS įvestį. Tęsiniui naudokite užbaigto pradinio vaizdo įrašo viešą ID ir tą patį API raktą. |
Atsakymas402 · billing_error | SąlygaTurimas likutis arba limitai neleidžia rezervuoti lėšų. | Kitas žingsnisPrieš siųsdami naują užklausą patikrinkite turimą likutį ir limitus. |
Atsakymas503 · server_error | SąlygaVaizdo įrašo patikra, saugykla arba prieiga prie paslaugos laikinai nepasiekiama. | Kitas žingsnisPalaukite, kol paslauga taps pasiekiama. Jei jau turite vaizdo įrašo ID, tikrinkite tą pradinę užduotį, užuot pradėję kitą generavimą. |
Atsakymas503 · result_pending_check | SąlygaReikia patikrinti pradinį vaizdo įrašo rezultatą ir mokestį. | Kitas žingsnisIšsaugokite grąžintą vaizdo įrašo ID ir tikrinkite tą užduotį. Kol ji tikrinama, nesiųskite ją pakeičiančios generavimo užklausos. |
Atsakymas503 · owned_result_unavailable | SąlygaEsamo vaizdo įrašo atsisiuntimas laikinai nepasiekiamas. | Kitas žingsnisVėliau patikrinkite tą pačią vaizdo įrašo užduotį ir atsisiųskite jos esamą rezultatą. Naujas generavimas sukuria atskirą operaciją. |
Atsakymas409 · video_not_ready | SąlygaVaizdo įrašo turinys nepaskelbtas. | Kitas žingsnisPatikrinkite pradinės užduoties būseną. Atsisiųskite, kai ji praneša completed; jei praneša failed, vadovaukitės jos pranešimu apie mokesčio patikrą. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra kwaivgi/kling-v3.0-pro
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Kling: Video v3.0 Pro
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Kokius laukus naudoja užklausa?
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- Kokie apribojimai taikomi?
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1