Kling v2 Master
Kling v2 Master vytvára krátke videoscény z textu alebo zo zadania vychádzajúceho z obrázka. Jeho zdokumentovaná položka modelu uvádza výber trvania päť alebo desať sekúnd a niekoľko formátov obrazu na vytvorenie záberu postaveného na jasnej akcii a závere.
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 v2 Master je model Kling na generovanie videa, ktorý má v zdokumentovanom katalógu schopnosť vytvárať video z textu aj z obrázka. Použite písomné zadanie na rozvinutie novej scény alebo začnite obrázkom, ktorý určuje jej vzhľad. Dajte každému záberu konkrétny účel, napríklad predstaviť miesto, ukázať interakciu alebo odhaliť detail objektu.
Pri novej scéne opíšte hlavný subjekt, jeho okolie a pohyb, ktorý má divák sledovať. Zahrňte dôležité fyzické vzťahy: objekt na stole, človek pri dvernom otvore alebo vozidlo približujúce sa k zákrute. Tieto detaily uľahčujú posúdenie zamýšľanej udalosti v hotovom videu.
Pri zábere vychádzajúcom z obrázka pripravte referenciu s požadovaným subjektom a kompozíciou. Ponechajte charakteristické hrany, črty tváre a materiály viditeľné. Opíšte, čo sa má vo východiskovom zábere pohybovať a čo má obsahovať záverečná kompozícia. Pri kontrole, či si subjekt zachováva súdržný vzhľad v celej sekvencii, používajte pôvodný obrázok.
Zdokumentovaná položka modelu uvádza trvanie päť a desať sekúnd. Naplánujte akciu tak, aby sa jej úvod, priebeh a záver zmestili do vybranej dĺžky záberu. Krátke gesto a odhalenie vedené kamerou majú odlišné nároky na tempo. Skontrolujte, či má skutočný klip záver použiteľný v zamýšľanom strihu.
Zdokumentované ovládacie prvky modelu zahŕňajú režimy std a pro spolu s formátom na šírku, na výšku a štvorcovým formátom. Vyberte možnosti ponúkané pre daný postup a uchovajte ich hodnoty spolu s výsledkom. Umiestnite dôležitý subjekt v obraze podľa cieľového formátu tak, aby jeho rozhodujúca akcia zostala počas pohybu viditeľná.
Opíšte pohyb kamery prostredníctvom jej vzťahu k subjektu. Kamera prechádzajúca okolo objektu odhaľuje iné informácie než objekt otáčajúci sa pred pevnou kamerou. Jasne uveďte zamýšľaný pohyb a prepojte ho s vizuálnou vlastnosťou alebo príbehovým momentom, ktorý si má publikum všimnúť.
Skontrolujte kontinuitu, interakcie a načasovanie celej sekvencie. Sledujte tvar subjektu, kontakt s blízkymi povrchmi a polohu v scéne. Pri postave kontrolujte tvár, ruky a oblečenie v priebehu akcie. Pri objekte kontrolujte obrys a vzhľad materiálu pri zmene pohľadu.
Uchovajte hotové video, prompt, referenciu a nastavenia ako jeden záznam záberu. Porovnávajte návrhy pri rovnakých podmienkach sledovania a podľa rovnakého vizuálneho cieľa. Pri úpravách určite pozorovaný nesúlad, zachovajte užitočné časti scény a zmeňte pokyn, ktorý rieši daný konkrétny problém.
Ailoot Ultra · Video POST /v1/videos kling-v2-master
kling-v2-masterÚvod
Kling v2 Master vytvára krátke videoscény z textu alebo zo zadania vychádzajúceho z obrázka. Jeho zdokumentovaná položka modelu uvádza výber trvania päť alebo desať sekúnd a niekoľko formátov obrazu na vytvorenie záberu postaveného na jasnej akcii a závere.
- 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-v2-master 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žiadavkaVoliteľné | Hodnoty a limity Podmienky: Použite zdokumentované pole pre vybraný model a uvedené možnosti; nezadanú voliteľnú hodnotu vynechajte. | 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 |
Parameteroptional | Špecifikáciamode, aspect_ratio, duration, end_image, 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., 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. |
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
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-master", "prompt": "A cat is walking on grass."}')
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-v2-master
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · Kling v2 Master
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kling-v2-master:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·kling-v2-master:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt