Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard yra Kuaishou 720p vaizdo profilis tekstinėms ir vaizdinėms užduotims. Kurkite trijų–penkiolikos sekundžių scenas su kartu generuojamu garsu, objektų orientyrais, pirmojo bei paskutinio kadrų valdymu ir pasakojimu vienu arba keliais planais.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Kling VIDEO 3.0 Standard yra Kuaishou 720p profilis vaizdo scenai generuoti iš teksto arba pateikto vaizdo. Jis naudoja VIDEO 3.0 versijos kartu generuojamą garsą, objektų orientyrus ir kelių planų pasakojimą, o lanksti klipo trukmė yra nuo trijų iki penkiolikos sekundžių. Šis profilis naudingas vaizdinei krypčiai kurti, trumpam pasakojimui peržiūrėti arba glaustai scenai su apibrėžtu veiksmu ir garsu sukurti.
Tekstu valdomai scenai nustatykite objektą, aplinką, veiksmą, apšvietimą ir kameros elgseną. Vaizdu valdomai scenai paruoškite pradinį vaizdą, aiškiai rodantį norimą animuoti išvaizdą ir kompoziciją. Originalioje užduotyje galima parodyti personažą prie dirbtuvių stalo, tada aprašyti, kaip jis paima mažą daiktą, kamerai artėjant prie veiksmo. Formuluotėje objekto judėjimą atskirkite nuo kameros judėjimo.
Kelių planų generavimas gali automatiškai suplanuoti scenos rodymą pagal jos aprašymą. Pasirinktinė kelių planų režisūra priskiria turinį ir trukmę atskiriems planams. Gamintojo pasirinktinio plano profilis priima nuo vieno iki šešių planų, iki 512 simbolių kiekvienam ir bent po vieną sekundę. Planų trukmių suma turi atitikti viso klipo trukmę. Kai vienas nenutrūkstamas vaizdas aiškiai perteikia sceną, vieno plano užduotis leidžia išvengti nereikalingo perėjimo.
Trumpa kadruotė gali prasidėti aplinkos vaizdu, pereiti prie veiksmo ir baigtis rezultatą paaiškinančia detale. Nurodykite, kuris objektas lieka kiekviename plane ir kaip kinta kadravimas. Automatinis režimas gali pritaikyti planus scenai, o pasirinktinė seka suteikia aiškius nurodymus atskiroms dalims. Įprasta viena užklausa gamintojo žinyne priima iki 2 500 simbolių.
Objektų orientyrų valdikliai padeda įtvirtinti personažus, daiktus ir aplinką. Naudokite aiškią orientyrinę medžiagą ir kiekvienam objektui suteikite pastovų aprašymą. Dokumentuotas vaizdu valdomas profilis leidžia iki trijų paruoštų elementų. Iliustruoto produkto scenoje vienas orientyras gali nustatyti daiktą, o pradinė kompozicija – jo vietą; judesio užduotis tuomet aprašo aplink jį vykstantį įvykį. Užbaigtą išvaizdą tikrinkite visame plane, užuot manę, kad orientyras apsaugo nuo kiekvieno pokyčio.
Pirmasis ir paskutinis kadrai gali nukreipti vaizdu sąlygotą perėjimą į norimą galutinę kompoziciją. Naudokite įtikinamą ryšį perteikiančius kadrus ir aprašykite veiksmą tarp jų. Gamintojo vaizdo profilis priima JPG, JPEG ir PNG iki 10 MB, bent 300 pikselių matmenų; pradinio vaizdo kraštinių santykis turi būti nuo 1:2.5 iki 2.5:1. Paruoškite tos užduoties kadrų medžiagą, užuot laikę kadruotės aprašymą lygiaverčiu įvesties rinkiniu.
Standard profilis gali generuoti kartu kuriamą garsą, kai šis režimas įjungtas; gamintojo žinyne garsas pagal numatytuosius nustatymus išjungtas. Replikas, atmosferą ir svarbius garsus aprašykite kaip scenos dalį. VIDEO 3.0 palaiko kinų, anglų, japonų, korėjiečių ir ispanų kalbos atlikimą, įskaitant kalbų kaitą ir palaikomus akcentus ar tarmes. Gamintojo vadovas sako, kad kita kalba įvestas dialogas išverčiamas į anglų. Scenoje su keliais personažais aiškiai nurodykite kalbantį objektą, o žodžių kiekį derinkite prie numatyto atlikimo trukmės.
Originali dialogo užduotis gali priskirti repliką Kalbėtojui A, matomą reakciją Kalbėtojui B ir pokalbį sekantį žiūros taško pakeitimą. Aplinkos garsą aprašykite atskirai nuo dialogo, kad foninis efektas netaptų dviprasmišku kalbos nurodymu. Orientyrine medžiaga nustatykite objektų išvaizdą, o tekstu – jų veiksmus ir žodžius.
Matomi užrašai yra dar viena 3.0 eigos dalis. Pradiniame vaizde gali būti iškaba, antraštė arba produkto etiketė, kurios išvaizda svarbi animacijoje. Įvardykite tekstą ir jo vaidmenį scenoje, tada rezultate patikrinkite rašybą, įskaitomumą bei stabilumą. Trumpame kampanijos vaizde svarbią žinutę iškelkite į ryškią kompozicijos vietą, užuot pasikliovę labai maža fonine etikete.
Standard išvestis yra 720p. Pro yra atskirai pasirenkamas 1080p profilis, o pradinės 4K raiškos režimas yra kitas gamintojo režimas, ne automatinis Standard nustatymas. Tekstu valdomo kraštinių santykio variantai apima 16:9, 9:16 ir 1:1. Formatą bei kadravimą rinkitės pagal numatytą paskirties vietą, tada išlaikykite tą vaizdinę kryptį lygindami veiksmo, šviesos arba planų tvarkos pakeitimus.
Užbaigtas generavimas pateikia vaizdo failą ir tikrąją jo trukmę. Gamintojo rezultatų dokumentacija sako, kad sugeneruoti vaizdo įrašai ištrinami po 30 dienų, todėl užbaigtą klipą išsaugokite nedelsdami. Kartu su juo laikykite scenos užduotį, orientyrinius vaizdus ir pasirinktą profilį, kad vėlesni pakeitimai turėtų nuoseklų pradžios tašką. Vaizdinį veiksmą, objekto vientisumą, kameros planus, dialogą ir užrašus peržiūrėkite tame kontekste, kur klipas bus naudojamas. Kryptinga netikusios detalės pataisa naudingesnė už visos scenos užduoties pakeitimą nesusijusiais nurodymais.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdPradžia
Kling VIDEO 3.0 Standard yra Kuaishou 720p vaizdo profilis tekstinėms ir vaizdinėms užduotims. Kurkite trijų–penkiolikos sekundžių scenas su kartu generuojamu garsu, objektų orientyrais, pirmojo bei paskutinio kadrų valdymu ir pasakojimu vienu arba keliais planais.
- 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-std | 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-std
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-std
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.168 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.252 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.168 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.168 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.168 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.168 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.168 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.504 į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.168 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.252 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.168 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.168 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.168 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.168 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.168 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-std","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
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-std
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · Kling: Video v3.0 Standard
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- Kokius laukus naudoja užklausa?
POST /v1/videos·kwaivgi/kling-v3.0-std:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Kokie apribojimai taikomi?
POST /v1/videos·kwaivgi/kling-v3.0-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1