Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro je profesionálny profil videa 1080p od Kuaishou pre scény vedené textom a obrázkom. Spája klipy tri až pätnásť sekúnd, natívny zvuk, vedené hraničné snímky a režijné pokyny pre jeden alebo viac záberov na filmové koncepty a krátke produkcie.
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 3.0 Pro je profesionálny profil modelu VIDEO 3.0 od Kuaishou. Jeho dokumentovaný režim Pro vytvára video 1080p z textového zadania alebo scény vedenej obrázkom s klipmi tri až pätnásť sekúnd. Verzia 3.0 spája natívny zvuk, ovládanie konzistentnosti subjektov a viaczáberové vedenie a dáva krátkej produkcii jasný spôsob určenia vzhľadu, akcie, kamerového pokrytia a zvuku.
Začnite hlavnou akciou scény. Pri zábere vedenom textom opíšte subjekt, prostredie, svetlo a pohľad, ktorý robí akciu čitateľnou. Pri zábere vedenom obrázkom nechajte úvodný obrázok stanoviť vzhľad a kompozíciu a potom textom určite zmeny v čase. Pri pôvodnom produktovom koncepte môže pripravený obrázok ukazovať predmet na štúdiovom povrchu a prompt opisovať pomalé odhalenie jeho materiálu a tvaru.
Viaczáberové vedenie ponúka automatické pokrytie alebo vlastnú postupnosť. Automatické viaczáberové generovanie plánuje zmeny kompozície a uhla kamery zo zadania; scéna vhodná pre jeden súvislý pohľad môže zostať jedným záberom. Vlastný storyboard umožňuje definovať obsah a dĺžku každého záberu. Profil vlastných záberov výrobcu povoľuje jeden až šesť záberov, najviac 512 znakov na záber a minimálne jednu sekundu každý; ich dĺžky sa musia sčítať na celkovú dĺžku klipu.
Pri krátkom príbehu opíšte úvodný pohľad, hlavnú akciu a záverečný detail ako samostatné zábery. Pri každom uveďte kamerové spracovanie a to, čo si má publikum všimnúť. Vzhľad opakovaného subjektu zachovajte v zadaní konzistentný, zatiaľ čo akciu a pokrytie meňte zámerne. Pole jediného promptu v referencii výrobcu prijíma až 2 500 znakov; vlastná postupnosť používa samostatné opisy jednotlivých záberov.
Referencie subjektov môžu podporiť scénu vedenú obrázkom, keď má postava, produkt alebo prostredie zostať rozpoznateľné. Vyberte jasné pohľady komunikujúce vlastnosti na zachovanie a každý referenčný subjekt pomenúvajte konzistentne. Dokumentovaný profil vedený obrázkom umožňuje až tri pripravené prvky. Úlohy referencií držte sústredené namiesto kombinovania materiálov s protichodnými pokynmi vzhľadu subjektu.
Prvá a posledná snímka poskytujú vizuálne hranice obrazom podmieneného prechodu. Pripravte snímky zhodujúce sa v subjekte a zamýšľanej scéne a potom opíšte ich pohybové prepojenie. Podporovaný vstup hraničných snímok výrobcu používa obrázky JPG, JPEG alebo PNG so súbormi najviac 10 MB, rozmermi aspoň 300 pixelov a pomerom strán úvodného obrázka medzi 1:2.5 a 2.5:1. Úloha s ovládanými snímkami a vlastný storyboard majú vlastné spracovanie vstupu, preto pred písaním plného zadania usporiadajte materiál pre zvolený postup.
Natívny zvuk môže kombinovať hovorené repliky, atmosféru a vizuálny prednes. Zvuk je v referencii výrobcu predvolene vypnutý a zapína sa pre audiovizuálnu scénu. Jazykový profil 3.0 zahŕňa čínštinu, angličtinu, japončinu, kórejčinu a španielčinu spolu s prepínaním jazykov a podporovaným spracovaním dialektov alebo prízvukov. Príručka výrobcu uvádza, že dialóg zadaný v inom jazyku sa prekladá do angličtiny. Každú repliku priraďte zamýšľanému subjektu a dialóg odlíšte od zvuku pozadia, aby zvukové zadanie vysvetľovalo, kto hovorí a čo obklopuje akciu.
Pôvodné zadanie dvoch postáv môže identifikovať Hovoriaceho A a Hovoriaceho B, každému dať krátku repliku a opísať viditeľnú reakciu medzi nimi. Dialóg udržujte úmerný dĺžke klipu a pri zmene pohľadu identifikujte hovoriaceho. Hlasové vedenie a referencia postavy slúžia odlišným účelom; zadanie má uviesť zamýšľaný prednes a nepredpokladať, že referenčný obrázok obsahuje hovorené slová.
VIDEO 3.0 tiež zlepšuje spracovanie viditeľného písma v scéne vedenej obrázkom. Ak záleží na nápise, etikete alebo titulku, identifikujte ho v zadaní a zachovajte jeho referenčný vzhľad. Dokončený klip skontrolujte z hľadiska pravopisu, čitateľnosti a pohybu tohto písma, najmä ak nesie produktovú alebo kampaňovú správu. Schopnosť modelu pracovať s písmom usmerňuje generovanie a nenahrádza konečnú vizuálnu kontrolu.
Profil Pro je 1080p; profil Standard je 720p. Samostatne volený režim 4K výrobcu je ďalším výstupným profilom, preto Pro nemožno považovať za synonymum každého nastavenia vyššieho rozlíšenia. Pri generovaní vedenom textom dokumentované voľby záberu zahŕňajú 16:9, 9:16 a 1:1. Záber vyberte podľa zamýšľaného umiestnenia a kompozíciu v ňom zachovajte čitateľnú.
Generovanie prebieha ako úloha, ktorej úspešný výsledok sprístupňuje dokončené 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. Video zachovajte so zadaním a referenčnými materiálmi a potom skontrolujte kontinuitu subjektov, požadované poradie záberov, pohyb kamery, dialóg a písmo. Vybraný klip použite ako filmový koncept, produktovú scénu alebo krátky príbeh a vykonajte cielenú revíziu časti, ktorá minula zamýšľaný výsledok.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proÚvod
Kling VIDEO 3.0 Pro je profesionálny profil videa 1080p od Kuaishou pre scény vedené textom a obrázkom. Spája klipy tri až pätnásť sekúnd, natívny zvuk, vedené hraničné snímky a režijné pokyny pre jeden alebo viac záberov na filmové koncepty a krátke produkcie.
- 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-v3.0-pro | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 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 Podmienky: Vynechanie tejto možnosti vyberie cenu so zvukom. Nastavte ju na false, ak chcete vybrať cenu bez zvuku. V has_audio vo výsledku overte, či bola vrátená zvuková stopa. | 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-v3.0-pro
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-v3.0-pro
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 | Komponent poplatku | Rozlíšenie referencie | Režim referencie | Referenčné audio | Účtovacia jednotka | Podmienky účtovania | Poplatok |
|---|---|---|---|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Komponent poplatku— | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Úč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áciaVýstup videa · referenčná sadzba | Sadzobník— | Odhadované množstvo— | Komponent poplatkureference_output_rate | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Účtovacia jednotkaza sekundu výstupu | Podmienky účtovania— | Poplatok Výstup · Referenčná sadzba za sekundu výstupného videa · Odhad iba na porovnanie $0.224 za sekundu výstupu |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Komponent poplatku— | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniazvuk: with_audio | Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.336 za sekundu videa |
| KonfiguráciaVideo z obrázka (obrázky snímok) · 1080p · referenčná sadzba | Sadzobník— | Odhadované množstvo— | Komponent poplatkureference_output_rate | Rozlíšenie referencie1080p | Režim referencieZ obrázka na video (obrázky snímok) | Referenčné audioBez audia | Účtovacia jednotkaza sekundu výstupu | Podmienky účtovania— | Poplatok Výstup · Referenčná sadzba za sekundu výstupného videa · Odhad iba na porovnanie $0.224 za sekundu výstupu |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Komponent poplatku— | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniarežim generovania: image_to_video; rozlíšenie: 720p | Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.224 za sekundu videa |
| KonfiguráciaVideo z textu · 1080p · referenčná sadzba | Sadzobník— | Odhadované množstvo— | Komponent poplatkureference_output_rate | Rozlíšenie referencie1080p | Režim referencieZ textu na video | Referenčné audioBez audia | Účtovacia jednotkaza sekundu výstupu | Podmienky účtovania— | Poplatok Výstup · Referenčná sadzba za sekundu výstupného videa · Odhad iba na porovnanie $0.224 za sekundu výstupu |
| KonfiguráciaVideo z textu · 480p · referenčná sadzba | Sadzobník— | Odhadované množstvo— | Komponent poplatkureference_output_rate | Rozlíšenie referencie480p | Režim referencieZ textu na video | Referenčné audioBez audia | Účtovacia jednotkaza sekundu výstupu | Podmienky účtovania— | Poplatok Výstup · Referenčná sadzba za sekundu výstupného videa · Odhad iba na porovnanie $0.224 za sekundu výstupu |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Komponent poplatku— | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniarežim generovania: text_to_video; rozlíšenie: 720p | 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 | Komponent poplatku— | Rozlíšenie referencie— | Režim referencie— | Referenčné audio— | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.672 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
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| 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. |
| KonfiguráciaCena videa | Podmienky účtovaniazvuk: with_audio | Poplatok Výstup · Cena videa $0.336 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: text_to_video; rozlíšenie: 480p | 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. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: text_to_video; rozlíšenie: 720p | 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. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: image_to_video; rozlíšenie: 720p | 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. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: text_to_video; rozlíšenie: 1080p | 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. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: image_to_video; rozlíšenie: 1080p | 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":8,"model":"kwaivgi/kling-v3.0-pro","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-v3.0-pro
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Kling: Video v3.0 Pro
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·kwaivgi/kling-v3.0-pro: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-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1