Kling v2.1 Master
A Kling v2.1 Master szöveges vagy képre épülő instrukcióból készít videót. Használd egy jól meghatározott vizuális eseményhez: a szereplőt vagy tárgyat, a cselekvést, a kameravezetést és a befejezést egyetlen összefüggő rövid beállítás részeként tervezd meg.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Kling v2.1 Master a Kling egyik videókiadása, amely a dokumentált modellkatalógusban szövegből videót és képből videót készítő képességgel szerepel. Válassz írásos jelenetinstrukciót, ha szövegből bontasz ki egy vizuális ötletet, vagy képre épülő instrukciót, ha a szereplő vagy tárgy és a kompozíció már adott. Mindkét esetben határozd meg azt az eseményt, amelyet a kész beállításnak mutatnia kell.
Szövegre épülő alkotásnál egyértelmű sorrendben írd le a szereplőt vagy tárgyat, a környezetet és a cselekvést. Egy stúdión áthaladó táncos, a fák alatt haladó jármű vagy a változó fényt megcsillantó üvegtárgy mind konkrét célt ad a képsornak. Add meg a jelenet megjelenését meghatározó részleteket, és az instrukció egészében használd őket következetesen.
Képre épülő alkotásnál olyan referenciát készíts elő, amely megmutatja a beállításban megőrzendő jellemzőket. Az arcok, tárgyszélek és jellegzetes anyagok maradjanak láthatók. Írd le, mi változik a kiinduló nézethez képest: a szereplő gesztusa, a környezet mozgása vagy a kamera helyzete. Az eredmény ellenőrzésekor legyen elérhető a forráskép.
A cselekvést a befejezése köré tervezd. Egy tárgyat letevő ember mozdulata úgy fejeződjön be, hogy a tárgy azonosítható helyen legyen; egy feltárás azzal záruljon, hogy a fontos jellemző láthatóvá válik. Így könnyebb vágási pontot választani, és megítélni, hogy a mozgás betöltötte-e a célját.
A dokumentált modellbejegyzés öt- és tízmásodperces időtartamokat, std és pro módokat, valamint fekvő, álló és négyzetes képformátumokat tartalmaz. Válaszd ki a kijelölt munkafolyamatban elérhető vezérlőket, és őrizd meg a tényleges értékeiket. Az elkészült klipet a tervezett cselekvéshez és képkivágáshoz mérd, ne a modell kiadásának nevéhez.
A szereplő vagy tárgy mozgását és a kameramozgást külön írd le. Követő beállításnál nevezd meg, melyik szereplőt vagy tárgyat követi a kamera, és a környezet mely részei haladjanak át a képmezőn. Rögzített beállításnál add meg a képmezőn belül zajló mozgást. A kamera irányítását ahhoz kösd, amit a nézőnek észre kell vennie.
A teljes képsor folytonosságát ellenőrizd. Vizsgáld meg, hogy a fontos szereplő vagy tárgy felismerhető marad-e, az interakciók térben következetesek-e, és az időzítés hagy-e helyet a tervezett vágásnak. Figyeld a kezek, arcok, felületi részletek és egymást takaró tárgyak változásait. A mozgást is értékeld, a legerősebb önálló képkocka mellett.
Minden kész videót a promptjával, referenciájával és beállításaival együtt őrizz meg. Ha egy jelenetet különböző kiadásokkal hasonlítasz össze, használd ugyanazt az instrukciót, és rögzítsd a tényleges vizuális különbségeket. Egy változat javításakor írd le a megfigyelt problémát, és a hozzá kapcsolódó instrukciót módosítsd, miközben megtartod a jelenet hasznos elemeit.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterKezdő lépések
A Kling v2.1 Master szöveges vagy képre épülő instrukcióból készít videót. Használd egy jól meghatározott vizuális eseményhez: a szereplőt vagy tárgyat, a cselekvést, a kameravezetést és a befejezést egyetlen összefüggő rövid beállítás részeként tervezd meg.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Video POST /v1/videos
- Bemenet
text- Kimenet
video
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok kling-v2-1-master Feltételek: Pontosan ezt az Ailoot-útválasztási azonosítót használja. | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Maximális hossz: 500 Feltételek: | Alapértelmezett— |
Mezőmode | Típusstring | KövetelményKötelező | Értékek és korlátok std, pro Feltételek: | Alapértelmezett— |
Mezőmodel_name | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: Választható natív felülírás. Hagyja ki a kiválasztott modell automatikus használatához; a kifejezetten megadott érték megmarad. | Alapértelmezett— |
Mezőcfg_scale | Típusnumber | KövetelményOpcionális | Értékek és korlátok Minimum: 0 Maximum: 1 Feltételek: | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok Feltételek: | Alapértelmezett— |
Mezőnegative_prompt | Típusstring | KövetelményOpcionális | Értékek és korlátok Maximális hossz: 200 Feltételek: | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok 5, 10 Feltételek: | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, mode |
Paraméteroptional | Szerződésmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésPontosan ezt az Ailoot-útválasztási azonosítót használja., Választható natív felülírás. Hagyja ki a kiválasztott modell automatikus használatához; a kifejezetten megadott érték megmarad. |
Metódus álnevei: /v1/videos/generations
Életciklus: 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}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $6 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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
Eredmények fogadása és mentése
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}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a visszaadott nyilvános feladat- vagy műveletazonosítót és az összes fejlécet. Csak az eredeti feladatot kérdezze le; az unknown vagy result_pending_check nem jogosít fel újabb létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőpolling_url | Típusstring |
Mezőprovider_task_id | Típusstring |
Meződata.task_id | Típusstring |
Meződata.task_status | Típusstring |
Meződata.task_result.videos[].url | Típusstring |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételEgy kötelező mező, modellválasztó, típus vagy bemeneti ábrázolási forma érvénytelen. | Következő lépésKülön kérés előkészítése előtt vizsgálja meg a visszaadott érvényesítési részleteket. |
Válasz | FeltételAz eredeti kérés vagy eredmény ismeretlen, vagy ellenőrzést igényel. | Következő lépésŐrizze meg az eredeti azonosítókat és fejléceket; csak a támogatott állapot- és médiatárbejegyzéseket olvassa le. Ne küldje el újra a létrehozási kérelmet. |
Álnevek
Modell álnevei
Ailoot Ultra kling-v2-1-master
Metódusútvonalak álnevei
/v1/videos/generations
Kapcsolódó modellazonosítók
FAQ · Kling v2.1 Master
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·kling-v2-1-master:text→video- Mely mezőket használja a kérés?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Milyen korlátok érvényesek?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200