Kling v2.1 Master
Kling v2.1 Master generuoja vaizdo įrašus pagal tekstą arba vaizdu grindžiamą aprašą. Naudokite jį aiškiai apibrėžtam vaizdiniam įvykiui kurti, subjektą, veiksmą, kameros darbą ir pabaigą suplanuodami kaip vieną nuoseklų trumpą planą.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Kling v2.1 Master yra Kling vaizdo įrašų versija, kuriai dokumentuotame modelių kataloge nurodytos vaizdo įrašo kūrimo pagal tekstą ir pagal vaizdą galimybės. Vaizdinę idėją plėtodami iš teksto rinkitės rašytinį scenos aprašą, o kai subjektas ir kompozicija jau nustatyti – vaizdu grindžiamą aprašą. Abiem atvejais apibrėžkite įvykį, kurį turi parodyti baigtas planas.
Kurdami pagal tekstą, aiškia tvarka aprašykite subjektą, aplinką ir veiksmą. Šokėjas, judantis per studiją, transporto priemonė, važiuojanti po medžiais, ar stiklinis objektas, atspindintis kintančią šviesą, suteikia sekai konkrečią paskirtį. Įtraukite scenos išvaizdą lemiančias detales ir visame apraše išlaikykite jų nuoseklumą.
Kurdami pagal vaizdą, paruoškite atskaitos vaizdą, kuriame matytųsi savybės, kurias planas turi išsaugoti. Veidai, objektų kraštai ir išskirtinės medžiagos turi likti matomi. Aprašykite, kas keičiasi nuo pradinio vaizdo: subjekto gestas, aplinkos judėjimas ar kameros padėtis. Peržiūrėdami rezultatą turėkite pradinį vaizdą.
Veiksmą planuokite atsižvelgdami į jo pabaigą. Žmogui padėjus objektą, šis turi likti atpažįstamoje vietoje; ką nors atskleidžiant, planas turi baigtis taip, kad svarbi savybė būtų matoma. Taip lengviau pasirinkti montavimo tašką ir įvertinti, ar judėjimas atliko savo paskirtį.
Dokumentuotame modelio įraše pateiktos penkių ir dešimties sekundžių trukmės, std ir pro režimai bei horizontalus, vertikalus ir kvadratinis kadro formatas. Pasirinkite valdiklius, prieinamus pasirinktoje kūrimo eigoje, ir išsaugokite jų faktines reikšmes. Gautą klipą vertinkite pagal numatytą veiksmą ir kadravimą, o ne pagal modelio versijos pavadinimą.
Subjekto ir kameros judėjimą aprašykite atskirai. Sekamajam planui nurodykite, kurį subjektą seka kamera ir kurios aplinkos dalys turi slinkti per kadrą. Nejudančiam planui nurodykite judėjimą, vykstantį jo viduje. Kameros judėjimą siekite su tuo, ką turi pastebėti žiūrovas.
Patikrinkite visos sekos tęstinumą. Įsitikinkite, kad svarbus subjektas išlieka atpažįstamas, sąveikos yra nuoseklios erdvėje, o laiko eiga palieka vietos numatytam montažo perėjimui. Stebėkite rankų, veidų, paviršiaus detalių ir vienas kitą užstojančių objektų pokyčius. Vertinkite judesį ir įtaigiausią atskirą kadrą.
Kiekvieną baigtą vaizdo įrašą laikykite kartu su jo užklausa, atskaitos vaizdu ir nustatymais. Lygindami sceną skirtingose versijose, naudokite tą patį aprašą ir užfiksuokite tikruosius vaizdinius skirtumus. Taisydami variantą aprašykite pastebėtą problemą ir pakeiskite su ja susijusį nurodymą, kartu išlaikydami naudingus scenos elementus.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterPradžia
Kling v2.1 Master generuoja vaizdo įrašus pagal tekstą arba vaizdu grindžiamą aprašą. Naudokite jį aiškiai apibrėžtam vaizdiniam įvykiui kurti, subjektą, veiksmą, kameros darbą ir pabaigą suplanuodami kaip vieną nuoseklų trumpą planą.
- Leidžiamos įvestys
- Tekstas
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Video POST /v1/videos
- Įvestis
text- Išvestis
video
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos kling-v2-1-master Sąlygos: Naudokite būtent šį Ailoot maršrutizavimo parinkiklį. | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Didžiausias ilgis: 500 Sąlygos: | Numatyta— |
Laukasmode | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos std, pro Sąlygos: | Numatyta— |
Laukasmodel_name | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Pasirenkamas savosios nuostatos perrašymas. Jo nenurodžius, pasirinktas modelis naudojamas automatiškai; aiškiai nurodyta reikšmė išsaugoma. | Numatyta— |
Laukascfg_scale | Tipasnumber | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 0 Didžiausia reikšmė: 1 Sąlygos: | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: | Numatyta— |
Laukasnegative_prompt | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Didžiausias ilgis: 200 Sąlygos: | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos 5, 10 Sąlygos: | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, mode |
Parametrasoptional | Specifikacijamodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametrasmaterial_types | Specifikacijatext |
Parametrasconditions | SpecifikacijaNaudokite būtent šį Ailoot maršrutizavimo parinkiklį., Pasirenkamas savosios nuostatos perrašymas. Jo nenurodžius, pasirinktas modelis naudojamas automatiškai; aiškiai nurodyta reikšmė išsaugoma. |
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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
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 |
Laukasdata.task_id | Tipasstring |
Laukasdata.task_status | Tipasstring |
Laukasdata.task_result.videos[].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-master
Metodų kelių pseudonimai
/v1/videos/generations
Susiję ID iškvietimui
FAQ · Kling v2.1 Master
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·kling-v2-1-master:text→video- Kokius laukus naudoja užklausa?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Kokie apribojimai taikomi?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200