Kling v1.5
Kling v1.5 je model na generovanie videa so zdokumentovaným postupom tvorby videa z obrázka. Začnite pripraveným statickým obrázkom a opíšte pohyb, uhol pohľadu a záverečnú kompozíciu krátkeho záberu postavy, objektu alebo prostredia.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Kling v1.5 je verzia modelu Kling na generovanie videa, ktorá má v zdokumentovanom katalógu modelov schopnosť vytvárať video z obrázka. Dodaný statický obrázok poskytuje vizuálny východiskový bod a písomné zadanie opisuje, ako sa má scéna pohybovať. Použite ho na vytvorenie gesta postavy, pohybujúceho sa objektu alebo meniaceho sa prostredia z obrázka, ktorého kompozícia už zodpovedá záberu.
Pripravte obrázok s dôrazom na dôležité detaily subjektu. Postava potrebuje zreteľnú tvár, pózu a oblečenie; objekt potrebuje jasný obrys a viditeľné znaky materiálu. Nechajte v kompozícii priestor pre zamýšľaný pohyb. Uchovajte pôvodný statický obrázok s hotovou sekvenciou, aby sa zmeny vzhľadu dali posúdiť priamym porovnaním.
Opíšte akciu ako pozorovateľnú udalosť. Napríklad opíšte sediaceho človeka, ktorý sa otáča k oknu, alebo látkovú stuhu pohybujúcu sa v jemnom vánku. Uveďte smer a zamýšľaný záver. Keď sa v scéne nachádza viac objektov, určite, ktorý z nich koná a ktoré zostávajú na mieste.
Vysvetlite úlohu kamery. Pevný uhol pohľadu môže uľahčiť sledovanie drobného gesta, zatiaľ čo pohybujúca sa kamera môže odkryť novú stranu scény. Opíšte tento pohyb vo vzťahu k subjektu. Požiadavka na priblíženie k subjektu a požiadavka, aby sa subjekt priblížil ku kamere, predstavujú odlišné vizuálne zámery.
Zdokumentovaná položka pre tvorbu videa z obrázka uvádza výber trvania päť alebo desať sekúnd, režimy std a pro a formát na šírku, na výšku a štvorcový formát. Pred vyhodnotením výsledku vyberte nastavenia ponúkané pre zvolený postup. Pri porovnávaní návrhov záberov uchovajte skutočný režim, trvanie a formát obrazu spolu so zdrojovým obrázkom a promptom.
Pri prezentácii objektu určite vizuálnu vlastnosť, ktorú má pohyb odhaliť. Môže to byť odrazivý povrch, záhyb materiálu alebo tvar rukoväti. Zamerajte akciu tak, aby dôležitá vlastnosť zostala viditeľná. Posudzujte objekt počas celého pohybu aj v záverečnom pohľade použitom v strihu.
Pri scéne s postavou opíšte jedno zmysluplné gesto a vzťah postavy k blízkym objektom. Sledujte tvár, ruky, oblečenie a telesné proporcie v priebehu času. Skontrolujte, či gesto dosiahne zamýšľaný koniec a či si scéna zachováva ucelené usporiadanie prvkov v popredí a pozadí.
Uchovajte celý vygenerovaný klip aj jeho zdrojové materiály. Posúďte úvod, hlavnú akciu a záver ako jednu sekvenciu a potom vykonajte úpravy podľa konkrétneho nesúladu. Poznámka ako „postava sa otáča preč od okna“ dáva ďalšiemu zadaniu konkrétnu opravu a zároveň zachováva zvyšok scény.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Úvod
Kling v1.5 je model na generovanie videa so zdokumentovaným postupom tvorby videa z obrázka. Začnite pripraveným statickým obrázkom a opíšte pohyb, uhol pohľadu a záverečnú kompozíciu krátkeho záberu postavy, objektu alebo prostredia.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity kling-v1-5 Podmienky: Použite presne tento smerovací selektor Ailoot. | Predvolené— |
Polemode | Typstring | PožiadavkaVoliteľné | Hodnoty a limity std, pro Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolenéstd |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 16:9, 9:16, 1:1 Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolené— |
Poleduration | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 5, 10 Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolené— |
Poleend_image | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolené— |
Poleimage | Typstring or array<string> | PožiadavkaPovinné | Hodnoty a limity Podmienky: Zadajte skutočnú dostupnú URL obrázka. Zoznam je prípustný iba vtedy, keď schéma parametra uvádza pole. | Predvolené— |
Polenegative_prompt | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, image |
Parameteroptional | Špecifikáciamode, aspect_ratio, duration, end_image, negative_prompt |
Parametermaterial_types | Špecifikáciatext, image |
Parameterconditions | ŠpecifikáciaPoužite presne tento smerovací selektor Ailoot., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte., Zadajte skutočnú dostupnú URL obrázka. Zoznam je prípustný iba vtedy, keď schéma parametra uvádza pole., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte., Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. |
Aliasy metódy: /v1/videos/generations
Životný cyklus: 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}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $6 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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-v1-5", "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
Prijať a uložiť výsledky
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}
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.
Ak treba overiť pôvodnú odpoveď
Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result_pending_check neoprávňujú na ďalšie vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poletask_id | Typstring |
Polestatus | Typstring |
Polevideo_url | Typstring |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaPovinné pole, selektor modelu, typ alebo podoba vstupu sú neplatné. | Ďalší krokPred prípravou samostatnej požiadavky si pozrite vrátené podrobnosti validácie. |
Odpoveď | PodmienkaPôvodná požiadavka alebo výsledok je neznámy alebo vyžaduje kontrolu. | Ďalší krokZachovajte pôvodné identifikátory a hlavičky; čítajte iba podporované záznamy o stave alebo záznamy knižnice. Požiadavku na vytvorenie znova neodosielajte. |
Aliasy
Aliasy modelov
Ailoot Ultra kling-v1-5
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · Kling v1.5
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kling-v1-5:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt