Kling: Video O1
A Kling VIDEO O1 a Kuaishou referenciaalapú videómodellje jelenetek generálásához és szerkesztéséhez szöveggel, képekkel, alanyelemekkel és forrásklippel. Három–tíz másodperces generálási képességét vizuális folytonossághoz, irányított képkocka-átmenetekhez és meglévő felvétel célzott változtatásaihoz használd.
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 VIDEO O1 a Kuaishou egységes referenciaalapú videómodellje. Szöveges leírást kapcsol össze képekkel, előkészített alanyelemekkel vagy forrásvideóval új jelenetek és meglévő felvételek célzott módosításainak irányításához. Alapvető felülete vizuális feladatleírás: azonosítsd a hivatkozott anyagot, írd le szerepét, és add meg az eredményvideóban kívánt megjelenést, műveletet vagy átalakítást.
Új snitt szövegből, nyitóképből vagy vizuális referenciák készletéből indulhat. Képpel rögzíts karaktert vagy tárgyat, és szavakkal írd le a helyszínt, cselekményt és nézőpontot. Ha több referencia eltérő jellemzőket ad, szerepüket kifejezetten rendeld hozzá. Eredeti termékfeladat az egyik képből veheti a tárgyat, másikból a környezetet, majd leírhatja a tárgy mozgását a helyszínen.
Az O1 promptja képeket, elemeket és videókat konkrét referenciajelölőkkel nevezhet meg, például <<<image_1>>> vagy <<<video_1>>>. Ezeket a jelölőket a ténylegesen megadott anyaghoz rendelve tartsd, és magyarázd el, mit kell átvenni belőlük. A gyártó promptkerete 2500 karakter. Az alanyt és változást azonosító tömör utasítás hasznosabb, mint egymáshoz nem kapcsolódó stíluskifejezések gyűjteménye.
Videóbemenet nélküli képalapú referenciáknál a dokumentált közös keret legfeljebb hét referenciakép és többképes elem. Referenciavideóval ez a kép-/elemkeret négy. Ezek a korlátok képalapú elemekre vonatkoznak; más elemtípusoknak külön kompatibilitási szabályaik vannak. A lényeges megjelenési vagy jelenetinformációt adó anyagot válaszd, ne redundáns nézetekkel töltsd ki a keretet.
A képbemenetek JPG, JPEG vagy PNG formátumúak, elérhető URL-lel vagy képadatként megadva, legfeljebb 10 MB-os fájllal, legalább 300 pixeles méretekkel és 1:2.5–2.5:1 képaránnyal. Világos alanyokat készíts elő, és a kivágásban őrizd meg a fontos részleteket. Ha a karakternek vagy terméknek felismerhetőnek kell maradnia, add meg a megtartandó jellemzőket, és a kész klip egészében ellenőrizd őket.
A kezdő- és záróképkocka vizuális határok közötti átmenetet kondicionál. A dokumentált O1 határképkocka-munkafolyamat zárókép megadásakor kezdőképet igényel, és a tömbben kettőnél több képpel nem támogat kezdő-/záróképkocka-vezérlést. Mindkét határkép használatakor további alanyelemek nem részei ennek az O1-konfigurációnak. A képkockavezérelt feladatot tartsd külön a megadott alapvideó szerkesztésétől.
A forrásvideónak két eltérő szerepe lehet. Alapklipként a szerkesztendő felvétel: irányíts konkrét hozzáadást, eltávolítást, stíluskezelést vagy kompozícióváltozást, és add meg, minek kell megmaradnia. A szerkesztés követi a bemeneti klip időtartamát, és ezt az alapvideós feladatot nem kapcsolja határképkocka-vezérléshez vagy többsnittes generáláshoz. Jellemzőreferenciaként a videó tartalmi, stílus- vagy kamerainformációt ad egy új snitthez.
Referenciavideós promptolás megelőző vagy következő snittet is kérhet. Azonosítsd a forrásklipet, és írd le az új látható eseményt, például az alany műveletének folytatását vagy a környező tér feltárását. Ez a referenciával vizuális információt közvetít; az új szegmens és eredeti felvétel összeállítása előtt ellenőrizd a csatlakozást és alanyfolytonosságot.
A gyártó videóbemeneti leírása egy MP4- vagy MOV-forrást fogad, legfeljebb 200 MB mérettel és legalább három másodperces időtartammal. Részletes bemeneti leírása 720–2160 pixeles méreteket és 24–60 fps képkockasebességet ír elő, 1:2.5–2.5:1 bemeneti képaránnyal. Ez a dokumentált forrásvideós munkafolyamat 24 fps-es videót ad vissza. A pontos engedélyezett klipidőtartam a kiválasztott modellprofiltól is függ. Az O1 újgenerálási tartománya három–tíz másodperc, külön a későbbi 3.0 Omni időtartam-tartományától.
A gyártó O1-módjai 720p Standard vagy 1080p Pro kimenetet biztosítanak. Új snitt kivágása dokumentált fekvő, álló és négyzetes lehetőségeket támogat ott, ahol a kiválasztott munkafolyamat használja ezt a vezérlőt; az alapvideó szerkesztése a forrás kivágását követi. A forrásvideó hangja megtartható vagy eldobható. Az O1 referencia- és szerkesztési munkafolyamata maradjon külön a későbbi 3.0 Omni natív hangra és egyéni képes forgatókönyvre vonatkozó leírásától.
A generálás feladatot készít, amelynek kész eredménye a videóanyagot és tényleges időtartamot tartalmazza. A gyártó eredménydokumentációja szerint a generált videók 30 nap után törlődnek, ezért a kész klipet mielőbb mentsd. A forrásanyagokat és feladatleírást őrizd meg az eredménnyel, majd ellenőrizd a kért változást, referenciahasználatot és folytonosságot. Szerkesztésnél az érintett területet és megmaradni kívánt részeket hasonlítsd össze. Referenciaalapú új snittnél ellenőrizd, hogy minden anyag a kívánt vizuális információt adta-e. A kész klip maradjon elérhető a későbbi szerkesztéshez vagy gyártási sorozathoz.
Ailoot Ultra · Videó POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Kezdő lépések
A Kling VIDEO O1 a Kuaishou referenciaalapú videómodellje jelenetek generálásához és szerkesztéséhez szöveggel, képekkel, alanyelemekkel és forrásklippel. Három–tíz másodperces generálási képességét vizuális folytonossághoz, irányított képkocka-átmenetekhez és meglévő felvétel célzott változtatásaihoz használd.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image- Kimenet
video- Kimeneti formátum
- eredeti MP4-bájtok; normalizálás és átkódolás nélkül
| 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 kwaivgi/kling-video-o1 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményKötelező | Értékek és korlátok 5, 10 Minimum: 1 Maximum: 600 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 720p | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1 | Alapértelmezett— |
Mezőgenerate_audio | Típusboolean | KövetelményOpcionális | Értékek és korlátok false, true | Alapértelmezett— |
Mezőframe_images | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 2 Bemeneti tartalom: Képkockaobjektumok tömbje. Minden objektumban type=image_url, url mezőt tartalmazó image_url és frame_type szerepel. Használjon HTTPS kép-URL-címet, és a frame_type értéke first_frame vagy last_frame legyen. Minden képkockaszerep legfeljebb egyszer fordulhat elő. Pontos kulcsok: type, image_url, frame_type Feltételek: Ezek a kulcsok minden képkockaobjektumot leírnak; az image_url kizárólag url mezőt tartalmaz. Kizárólag szöveges kérésnél hagyja el a frame_images mezőt. | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 1280x720, 720x1280, 720x720 Minta: ^[1-9][0-9]*x[1-9][0-9]*$ | Alapértelmezett— |
Mezőcallback_url | Típusstring | KövetelményOpcionális | Értékek és korlátok Minta: ^https:// | Alapértelmezett— |
Mezősession_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtrace | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőuser | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Bemeneti anyagok kombinációi
Szövegből videó · Írott utasítás. · Kötelező: model, prompt, duration
A prompt szöveg, a duration pedig egész másodpercekben megadott időtartam legyen. Válasszon támogatott felbontást; adjon hozzá képarányt, vagy használjon felsorolt méretet.
model: Típus: string · kwaivgi/kling-video-o1
prompt: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen
Képből videó · Írott utasítás és egy első képkockát ábrázoló kép. · Kötelező: model, prompt, duration, frame_images
A frame_images egy tömb. Minden képkockaobjektum type, image_url és frame_type mezőt tartalmaz; az image_url mezőben url található. A type értéke legyen image_url. Használja a first_frame szerepet, opcionálisan last_frame szereppel. Minden képkockaszerep legfeljebb egyszer fordulhat elő. Minden képkockához adjon meg nyilvános HTTPS kép-URL-címet. Válasszon támogatott felbontást; adjon hozzá képarányt, vagy használjon felsorolt méretet.
Pontos kulcsok: type, image_url, frame_type
model: Típus: string · kwaivgi/kling-video-o1
prompt: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration |
Paramétermaterial_types | Szerződéstext, image |
Paraméteradditional_properties | Szerződésfalse |
Paraméteroptional_controls | Szerződésresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Életciklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Elszámolási egység | Elszámolási feltételek | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | 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ásVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.224 videómásodpercenként |
| 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 | Elszámolási egység— | Elszámolási feltételek— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $1.12 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 →
A referencia-díjszabás részletei
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
Videóbeállítások árhivatkozásai
Árak beállításonként
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideó ára | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videó ára $0.224 videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
Példakérések
Ailoot Ultra · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"kwaivgi/kling-video-o1","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Eredmények fogadása és mentése
Ailoot Ultra · Videó
aláírt saját tartalom-URL-címek
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Feladatállapot ellenőrzése
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
További tartalomlekérések
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Ő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 az összes ténylegesen visszaadott, Önhöz tartozó kimenetet és a hozzájuk visszaadott mért metaadatokat.
Ha az eredeti választ ellenőrizni kell
503 result_pending_check + eredeti azonosító + X-Should-Retry:false; az eredeti kérést soha ne ismételje meg
Válaszmezők
| Mező | Típus | Jelentés |
|---|---|---|
Mezőindex | Típusinteger | JelentésE videó nullától induló pozíciója a kimeneti listában. |
Mezőcontent_url | Típusstring | JelentésAláírt HTTPS letöltési URL ehhez az elkészült videóhoz. |
Mezősha256 | Típusstring | null | JelentésAz eredeti videóbájtok SHA-256 lenyomata; null, ha nem érhető el. |
Mezősize_bytes | Típusinteger | null | JelentésAz eredeti videófájl mérete bájtban; null, ha nem érhető el. |
Meződuration_ms | Típusinteger | null | JelentésA videó mért időtartama ezredmásodpercben; null, ha nem érhető el. |
Mezőwidth | Típusinteger | null | JelentésA videó szélessége pixelben; null, ha nem érhető el. |
Mezőheight | Típusinteger | null | JelentésA videó magassága pixelben; null, ha nem érhető el. |
Mezővideo_codec | Típusstring | null | JelentésVideókodek-azonosító; null, ha nincs rögzítve. |
Mezőhas_audio | Típusboolean | null | JelentésJelzi, hogy a videó tartalmaz-e hangsávot; null, ha nem mérték meg. |
Mezőaudio_codec | Típusstring | null | JelentésHangkodek-azonosító; null, ha nincs azonosító rögzítve. |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz404 · not_found_error | FeltételA videóhoz való hozzáférés nem érhető el, vagy ez a videóazonosító nem található. | Következő lépésEllenőrizze a videóhoz való hozzáférést. Meglévő videónál használja annak eredeti nyilvános azonosítóját és ugyanazt az API-kulcsot. |
Válasz401 · authentication_error | FeltételAz API-kulcs nem egyezik a hitelesített fiókkal. | Következő lépésBeküldés előtt ellenőrizze az API-kulcsot és a fiók hozzáférését. |
Válasz400 · invalid_request_error | FeltételA kérés nem olvasható, vagy a letöltési index érvénytelen. | Következő lépésJavítsa a kérés törzsét. Letöltéshez az eredeti feladat által visszaadott kimeneti indexet válasszon. |
Válasz422 · price_unavailable | FeltételA kiválasztott videóbeállítás nem árazható. | Következő lépésVálasszon támogatott videóbeállítást, és adja meg az ahhoz kötelező opciókat a javított kérés beküldése előtt. |
Válasz422 · invalid_request_error | FeltételA videóbemenet vagy az eredeti folytatási feladat érvénytelen. | Következő lépésHasználjon érvényes HTTPS bemeneteket. Folytatáshoz adja meg az elkészült eredeti videó nyilvános azonosítóját ugyanazzal az API-kulccsal. |
Válasz402 · billing_error | FeltételA rendelkezésre álló egyenleg vagy a limitek nem teszik lehetővé az összeg zárolását. | Következő lépésÚj kérés elküldése előtt ellenőrizze a rendelkezésre álló egyenleget és a limiteket. |
Válasz503 · server_error | FeltételA videó ellenőrzése, tárolása vagy a szolgáltatás elérése átmenetileg nem áll rendelkezésre. | Következő lépésVárja meg, amíg a szolgáltatás elérhető lesz. Ha már van videóazonosítója, az eredeti feladatot ellenőrizze újabb generálás létrehozása helyett. |
Válasz503 · result_pending_check | FeltételAz eredeti videóeredményt és a díjat ellenőrizni kell. | Következő lépésŐrizze meg a visszaadott videóazonosítót, és ellenőrizze azt a feladatot. Az ellenőrzés ideje alatt ne küldjön helyettesítő generálási kérést. |
Válasz503 · owned_result_unavailable | FeltételA meglévő videó letöltése átmenetileg nem érhető el. | Következő lépésEllenőrizze később ugyanazt a videófeladatot, és töltse le annak meglévő kimenetét. Egy új generálás külön műveletet hoz létre. |
Válasz409 · video_not_ready | FeltételA videótartalom nincs közzétéve. | Következő lépésEllenőrizze az eredeti feladat állapotát. Akkor töltse le, amikor completed állapotot jelent; ha failed állapotot jelent, kövesse a díjellenőrzési értesítését. |
Álnevek
Modell álnevei
Ailoot Ultra kwaivgi/kling-video-o1
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Kling: Video O1
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·kwaivgi/kling-video-o1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Milyen korlátok érvényesek?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1