Kling: Video O1
Kling VIDEO O1 je model videa od Kuaishou vedený referenciami na generovanie a úpravu scén pomocou textu, obrázkov, prvkov subjektov a zdrojového klipu. Jeho profil generovania tri až desať sekúnd použite pre vizuálnu kontinuitu, riadené prechody medzi snímkami a cielené zmeny existujúcich záberov.
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 VIDEO O1 je zjednotený model videa od Kuaishou vedený referenciami. Kombinuje textový opis s obrázkami, pripravenými prvkami subjektov alebo zdrojovým videom na usmernenie nových scén a cielených zmien existujúcich záberov. Jeho základným rozhraním je vizuálne zadanie: identifikujte referenčný materiál, opíšte jeho úlohu a uveďte vzhľad, akciu alebo premenu požadovanú vo výslednom videu.
Nový záber môže začať textom, úvodným obrázkom alebo súborom vizuálnych referencií. Obrázkom stanovte postavu alebo predmet a slovami opíšte prostredie, akciu a pohľad. Keď viaceré referencie prispievajú odlišnými vlastnosťami, ich úlohy priraďte výslovne. Pôvodné produktové zadanie môže prevziať predmet z jedného obrázka a prostredie z iného a potom opísať pohyb predmetu v danom prostredí.
Prompt O1 môže pomenovať obrázky, prvky a videá konkrétnymi referenčnými značkami ako <<<image_1>>> alebo <<<video_1>>>. Tieto značky držte spojené so skutočne dodaným materiálom a vysvetlite, čo sa z neho má prevziať. Povolená dĺžka promptu výrobcu je 2 500 znakov. Stručný pokyn identifikujúci subjekt a zmenu je užitočnejší než zbierka nesúvisiacich štýlových výrazov.
Pri obrazových referenciách bez video vstupu je dokumentovaný kombinovaný rozpočet až sedem referenčných obrázkov a viacobrazových prvkov. Pri referenčnom videu je tento rozpočet obrázkov/prvkov štyri. Limity sa týkajú prvkov založených na obrázkoch; iné typy prvkov majú samostatné pravidlá kompatibility. Vyberte materiál dodávajúci podstatný vzhľad alebo scénické informácie namiesto zaplnenia rozpočtu nadbytočnými pohľadmi.
Obrazové vstupy používajú JPG, JPEG alebo PNG dodané dostupnou URL alebo obrazovými dátami so súbormi do 10 MB, rozmermi aspoň 300 pixelov a pomerom strán medzi 1:2.5 a 2.5:1. Pripravte jasné subjekty a vo výreze zachovajte dôležité detaily. Ak úloha potrebuje rozpoznateľnú postavu alebo produkt, uveďte zachované vlastnosti a kontrolujte ich v celom dokončenom klipe.
Prvá a posledná snímka podmieňujú prechod medzi vizuálnymi hranicami. Dokumentovaný postup hraničných snímok O1 vyžaduje prvú snímku, ak je dodaná posledná, a nepodporuje ovládanie prvej/poslednej snímky s viac než dvoma obrázkami v poli. Pri použití oboch hraničných snímok nie sú ďalšie prvky subjektov súčasťou tejto konfigurácie O1. Úlohu s ovládanými snímkami držte oddelene od úpravy dodaného základného videa.
Zdrojové video môže mať dve odlišné úlohy. Ako základný klip predstavuje upravované zábery: usmernite konkrétne pridanie, odstránenie, štýlové spracovanie alebo kompozičnú zmenu a uveďte, čo má zostať. Úprava sleduje dĺžku vstupného klipu a nekombinuje túto úlohu základného videa s ovládaním hraničných snímok ani viaczáberovým generovaním. Ako referencia vlastností video dodáva obsah, štýl alebo kamerové informácie pre nový záber.
Zadanie podľa referenčného videa môže tiež žiadať predchádzajúci alebo nasledujúci záber. Identifikujte zdrojový klip a opíšte novú viditeľnú udalosť, napríklad pokračovanie akcie subjektu alebo odhalenie okolitého prostredia. Referencia tak komunikuje vizuálne informácie; pred zostavením nového segmentu s pôvodnými zábermi skontrolujte spoj a kontinuitu subjektu.
Profil video vstupu výrobcu prijíma jeden zdroj MP4 alebo MOV do 200 MB s minimálnou dĺžkou tri sekundy. Podrobný vstupný profil určuje rozmery 720 až 2160 pixelov a snímkové frekvencie 24 až 60 fps s pomerom strán vstupu medzi 1:2.5 a 2.5:1. Tento dokumentovaný postup zdrojového videa vracia video pri 24 fps. Presná povolená dĺžka klipu závisí aj od zvoleného profilu modelu. Rozsah nového generovania O1 je tri až desať sekúnd, odlišný od neskoršieho rozsahu dĺžky 3.0 Omni.
Režimy O1 výrobcu poskytujú výstup 720p Standard alebo 1080p Pro. Záber nového videa podporuje dokumentované široké, zvislé a štvorcové voľby tam, kde zvolený postup používa toto ovládanie; úprava základného videa sleduje jeho zdrojový záber. Zvuk zdrojového videa možno zachovať alebo zahodiť. Referenčný a editačný postup O1 má zostať oddelený od neskoršieho profilu natívneho zvuku a vlastného storyboardu 3.0 Omni.
Generovanie vytvára úlohu, ktorej dokončený výsledok obsahuje video a skutočnú dĺžku. Dokumentácia výsledkov výrobcu uvádza odstránenie generovaných videí po 30 dňoch, preto dokončený klip ihneď uložte. S výsledkom zachovajte zdrojové materiály a zadanie a potom skontrolujte požadovanú zmenu, použitie referencií a kontinuitu. Pri úprave porovnajte dotknutú oblasť aj časti na zachovanie. Pri novom zábere vedenom referenciami overte, že každý materiál dodal zamýšľané vizuálne informácie. Dokončený klip majte k dispozícii pre nasledujúci zostrih alebo produkčnú postupnosť.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Úvod
Kling VIDEO O1 je model videa od Kuaishou vedený referenciami na generovanie a úpravu scén pomocou textu, obrázkov, prvkov subjektov a zdrojového klipu. Jeho profil generovania tri až desať sekúnd použite pre vizuálnu kontinuitu, riadené prechody medzi snímkami a cielené zmeny existujúcich záberov.
- 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- Výstupný formát
- pôvodné bajty MP4; bez normalizácie a prekódovania
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity kwaivgi/kling-video-o1 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 5, 10 Minimum: 1 Maximum: 600 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 720p | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 16:9, 9:16, 1:1 | Predvolené— |
Polegenerate_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false, true | Predvolené— |
Poleframe_images | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 2 Vstupný obsah: Pole objektov snímok. Každý objekt má type=image_url, image_url obsahujúce url a frame_type. Použite HTTPS URL obrázka a nastavte frame_type na first_frame alebo last_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Presné kľúče: type, image_url, frame_type Podmienky: Tieto kľúče opisujú každý objekt snímky; image_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame_images. | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1280x720, 720x1280, 720x720 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Predvolené— |
Polecallback_url | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Vzor: ^https:// | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletrace | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Kombinácie vstupných podkladov
Z textu na video · Textové zadanie. · Povinné: model, prompt, duration
Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie; pridajte pomer strán alebo použite uvedenú veľkosť.
model: Typ: string · kwaivgi/kling-video-o1
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Z obrázka na video · Textové zadanie a obrázok prvej snímky. · Povinné: model, prompt, duration, frame_images
frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame s voliteľným last_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie; pridajte pomer strán alebo použite uvedenú veľkosť.
Presné kľúče: type, image_url, frame_type
model: Typ: string · kwaivgi/kling-video-o1
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration |
Parametermaterial_types | Špecifikáciatext, image |
Parameteradditional_properties | Špecifikáciafalse |
Parameteroptional_controls | Špecifikáciaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Životný cyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Účtovacia jednotka | Podmienky účtovania | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Podmienky účtovania— | 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áciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.224 za sekundu videa |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1.12 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 →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
Cenové referencie konfigurácií videa
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaCena videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena videa $0.224 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
Príklady požiadaviek
Ailoot Ultra · Video
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
Prijať a uložiť výsledky
Ailoot Ultra · Video
podpísané URL obsahu vo vašom vlastníctve
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Skontrolovať stav úlohy
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
Čítanie ďalšieho obsahu
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
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 každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.
Ak treba overiť pôvodnú odpoveď
503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte
Polia odpovede
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozícia tohto videa v zozname výstupov, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodpísaná HTTPS URL na stiahnutie tohto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOdtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný. |
Polesize_bytes | Typinteger | null | VýznamVeľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná. |
Poleduration_ms | Typinteger | null | VýznamNameraná dĺžka videa v milisekundách; null, ak nie je dostupná. |
Polewidth | Typinteger | null | VýznamŠírka videa v pixeloch; null, ak nie je dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixeloch; null, ak nie je dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, ak nie je zaznamenaný. |
Polehas_audio | Typboolean | null | VýznamČi video obsahuje zvukovú stopu; null, ak sa to nemeralo. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor. |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď404 · not_found_error | PodmienkaPrístup k videu nie je dostupný alebo sa toto ID videa nenašlo. | Ďalší krokSkontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API. |
Odpoveď401 · authentication_error | PodmienkaKľúč API nezodpovedá overenému účtu. | Ďalší krokPred odoslaním skontrolujte svoj kľúč API a prístup účtu. |
Odpoveď400 · invalid_request_error | PodmienkaPožiadavku sa nepodarilo načítať alebo je index sťahovania neplatný. | Ďalší krokOpravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou. |
Odpoveď422 · price_unavailable | PodmienkaCenu vybranej konfigurácie videa nemožno určiť. | Ďalší krokVyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti. |
Odpoveď422 · invalid_request_error | PodmienkaVstup videa alebo pôvodná úloha pokračovania sú neplatné. | Ďalší krokPoužite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API. |
Odpoveď402 · billing_error | PodmienkaDostupný zostatok alebo limity neumožňujú rezerváciu. | Ďalší krokPred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity. |
Odpoveď503 · server_error | PodmienkaOverovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné. | Ďalší krokPočkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania. |
Odpoveď503 · result_pending_check | PodmienkaPôvodný výsledok videa a poplatok treba skontrolovať. | Ďalší krokZachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie. |
Odpoveď503 · owned_result_unavailable | PodmienkaStiahnutie existujúceho videa je dočasne nedostupné. | Ďalší krokNeskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu. |
Odpoveď409 · video_not_ready | PodmienkaObsah videa nebol zverejnený. | Ďalší krokSkontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku. |
Aliasy
Aliasy modelov
Ailoot Ultra kwaivgi/kling-video-o1
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Kling: Video O1
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Aké polia používa požiadavka?
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- Aké limity platia?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1