Kling v2.1
Kling v2.1 generuoja vaizdo įrašus pagal atskaitos vaizdą ir rašytinį judesio aprašą. Dokumentuotame vaizdo įrašo kūrimo pagal vaizdą įraše pateikti penkių ir dešimties sekundžių trukmės pasirinkimai bei std ir pro režimai sekai planuoti.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Kling v2.1 yra Kling vaizdo įrašų modelis, kuriam dokumentuotame kataloge nurodyta vaizdo įrašo kūrimo pagal vaizdą galimybė. Pradėkite nuo nejudančio atskaitos vaizdo, kuris apibrėžia sceną, tada aprašykite judėjimą, paverčiantį jį tinkamu planu. Produkto vaizdas, iliustruota aplinka ar kadras su personažu gali suteikti kompoziciją, nuo kurios vystoma seka.
Pasirinkite atskaitos vaizdą, iš kurio būtų galima suprasti numatytą veiksmą. Subjektas, esantis prie durų, suteikia aiškų pradinį tašką įėjimui į kambarį; objektą padėjus ant neapkrauto paviršiaus, lengviau apžiūrėti jo kontūrą. Išsaugokite originalios kokybės atskaitos vaizdą ir susiekite jį su sugeneruotu klipu.
Aprašykite vieną nuoseklų veiksmą. Nurodykite subjektą, judėjimo kryptį ir numatytą galutinę būseną. Vaizduodami sąveiką, paaiškinkite dalyvių tarpusavio ryšį: kas tiesia ranką, kas paliečiama ir kur veiksmas baigiasi. Naudokite matomas detales, kurias galima patikrinti gautoje sekoje.
Planą komponuokite pagal jo paskirtį. Dokumentuotame vaizdo įrašo kūrimo pagal vaizdą įraše pateikiami horizontaliam, vertikaliam ir kvadratiniam kadrui skirti kraštinių santykiai bei penkių ir dešimties sekundžių trukmės pasirinkimai. Nustatykite, kur subjektas turi išlikti pasirinktame kadre. Vertikali kompozicija ir platus vietą pristatantis planas tam pačiam judesiui kelia skirtingus reikalavimus.
Dokumentuotuose vaizdo įrašo kūrimo pagal vaizdą valdikliuose yra std ir pro generavimo režimai. Lygindami variantus, pasirinktą režimą išsaugokite kartu su rezultatu. Išvestį vertinkite pagal aprašą: pageidaujamą veiksmą, kompoziciją, subjekto išvaizdą ir laiko eigą. Vien režimo pavadinimas neparodo, kaip gerai konkretus planas atitinka šiuos poreikius.
Kameros judėjimo nurodymais padėkite perteikti įvykį. Nejudanti kamera gali parodyti kintančią pozą, šoninis judėjimas gali atskleisti aplinką, o judėjimas pirmyn gali išryškinti detalę. Nurodykite numatytą subjekto ir žiūros taško santykį, kad kameros judesys nekonkuruotų su veiksmu, kurį turi sekti žiūrovas.
Peržiūrėkite visą klipą ir patikrinkite vaizdo tęstinumą. Jei vaizduojamas produktas, keičiantis žiūros taškui tikrinkite formą, žymėjimus ir medžiagos išvaizdą. Jei vaizduojamas žmogus, tikrinkite veido bruožus, rankas, aprangą ir sąlytį su šalia esančiais objektais. Galutinę kompoziciją patikrinkite kito montažo plano ar grafinio elemento kontekste.
Baigtą vaizdo įrašą, atskaitos vaizdą, užklausą ir pasirinktus nustatymus išsaugokite kaip vieną plano įrašą. Taisydami įvardykite konkretų vaizdinį neatitikimą ir išlaikykite dalis, kurios jau tinka scenai. Variantus lyginkite rodydami vienodo dydžio vaizdą tuo pačiu atkūrimo greičiu, kad pasirinkimas atspindėtų judesį ir kompoziciją, kuriuos iš tikrųjų matys auditorija.
Ailoot Ultra · Video POST /v1/videos kling-v2-1
kling-v2-1Pradžia
Kling v2.1 generuoja vaizdo įrašus pagal atskaitos vaizdą ir rašytinį judesio aprašą. Dokumentuotame vaizdo įrašo kūrimo pagal vaizdą įraše pateikti penkių ir dešimties sekundžių trukmės pasirinkimai bei std ir pro režimai sekai planuoti.
- Leidžiamos įvestys
- Tekstas · Vaizdai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Video POST /v1/videos
- Įvestis
text,image- Išvestis
video
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos kling-v2-1 Sąlygos: Naudokite būtent šį Ailoot maršrutizavimo parinkiklį. | Numatyta— |
Laukasmode | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos std, pro Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatytastd |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 9:16, 1:1 Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos 5, 10 Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatyta— |
Laukasend_image | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatyta— |
Laukasimage | Tipasstring or array<string> | ReikalavimasPrivaloma | Reikšmės ir ribos Sąlygos: Pateikite tikrąjį pasiekiamą paveikslėlio URL adresą. Sąrašas priimamas tik tada, kai parametro schemoje nurodytas masyvas. | Numatyta— |
Laukasnegative_prompt | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Sąlygos: Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, image |
Parametrasoptional | Specifikacijamode, aspect_ratio, duration, end_image, negative_prompt |
Parametrasmaterial_types | Specifikacijatext, image |
Parametrasconditions | SpecifikacijaNaudokite būtent šį Ailoot maršrutizavimo parinkiklį., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės., Pateikite tikrąjį pasiekiamą paveikslėlio URL adresą. Sąrašas priimamas tik tada, kai parametro schemoje nurodytas masyvas., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės., Naudokite dokumentuotą pasirinkto modelio lauką ir nurodytus pasirinkimus; neįtraukite neapibrėžtos pasirenkamos reikšmės. |
Metodo pseudonimai: /v1/videos/generations
Gyvavimo ciklas: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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 | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | 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ūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $6 į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 →
Užklausų pavyzdžiai
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-1", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
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 visą atsakymą ir antraštes, pradinius identifikatorius, kiekvieną tikrą rezultatą ir visus naudojimo bei apskaitos laukus. Išsaugokite kiekvieną unikalų jums priklausantį išteklių ir visas į jį nukreiptas paskirtis.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite grąžintą viešą užduoties ar operacijos id ir visas antraštes. Skaitykite tik pradinės užduoties duomenis; unknown arba result_pending_check nesuteikia leidimo kurti dar kartą.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukaspolling_url | Tipasstring |
Laukasprovider_task_id | Tipasstring |
Laukastask_id | Tipasstring |
Laukasstatus | Tipasstring |
Laukasvideo_url | Tipasstring |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaPrivalomas laukas, modelio parinkiklis, tipas arba įvesties pateikimo forma yra netinkami. | Kitas žingsnisPrieš rengdami atskirą užklausą, peržiūrėkite grąžintą išsamią patikros informaciją. |
Atsakymas | SąlygaPradinė užklausa arba rezultatas nežinomi arba juos reikia patikrinti. | Kitas žingsnisIšsaugokite pradinius identifikatorius ir antraštes; skaitykite tik palaikomus būsenos ar bibliotekos įrašus. Nesiųskite kūrimo užklausos dar kartą. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra kling-v2-1
Metodų kelių pseudonimai
/v1/videos/generations
Susiję ID iškvietimui
FAQ · Kling v2.1
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·kling-v2-1:text,image→video- Kokius laukus naudoja užklausa?
POST /v1/videos·kling-v2-1:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt