Kling: Video v3.0 Standard
Kling VIDEO 3.0 Standard je profil videa 720p od Kuaishou pre textové a obrazové zadania. Vytvárajte scény tri až pätnásť sekúnd s natívnym zvukom, referenciami subjektov, vedením prvou/poslednou snímkou a rozprávaním jedným alebo viacerými zábermi.
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 Standard je profil 720p od Kuaishou na generovanie video scény z textu alebo dodaného obrázka. Používa natívny zvuk, referencie subjektov a viaczáberové rozprávanie verzie VIDEO 3.0 s flexibilnou dĺžkou klipu tri až pätnásť sekúnd. Tento profil je užitočný pre vývoj vizuálneho smeru, náhľad krátkeho príbehu alebo tvorbu kompaktnej scény s definovanou akciou a zvukom.
Pri scéne vedenej textom stanovte subjekt, prostredie, akciu, osvetlenie a správanie kamery. Pri scéne vedenej obrázkom pripravte úvodný obrázok jasne ukazujúci vzhľad a kompozíciu na animáciu. Pôvodné zadanie môže ukázať postavu pri dielenskom stole a potom opísať jej zdvihnutie malého predmetu, zatiaľ čo kamera prichádza bližšie k akcii. V znení oddeľte pohyb subjektu od pohybu kamery.
Viaczáberové generovanie môže automaticky plánovať pokrytie z opisu scény. Vlastné viaczáberové vedenie namiesto toho priraďuje obsah a dĺžku jednotlivým záberom. Profil vlastných záberov výrobcu prijíma jeden až šesť záberov, najviac 512 znakov na záber a aspoň jednu sekundu pre každý. Dĺžky záberov sa musia sčítať na celkovú dĺžku klipu. Keď scénu jasne komunikuje jeden súvislý pohľad, zadanie jedného záberu sa vyhne zbytočnému prechodu.
Krátky storyboard môže začať pohľadom na prostredie, prejsť k akcii a skončiť detailom vysvetľujúcim výsledok. Určite, ktorý subjekt zostáva v každom zábere a ako sa mení kompozícia. Automatický režim môže prispôsobiť pokrytie scéne, kým vlastná postupnosť dáva explicitné pokyny jej samostatným častiam. Bežný jediný prompt v referencii výrobcu prijíma až 2 500 znakov.
Ovládanie referencií subjektov pomáha ukotviť postavy, predmety a prostredie. Používajte jasný referenčný materiál a každému subjektu dajte stabilný opis. Dokumentovaný profil vedený obrázkom umožňuje až tri pripravené prvky. Pri ilustrovanej produktovej scéne môže jedna referencia stanoviť predmet, kým úvodná kompozícia určuje jeho miesto; pohybové zadanie potom opisuje udalosť okolo neho. Dokončený vzhľad skontrolujte počas celého záberu a nepredpokladajte, že referencia zabráni každej zmene.
Prvá a posledná snímka môžu viesť obrazom podmienený prechod k požadovanej záverečnej kompozícii. Použite snímky znázorňujúce vierohodné spojenie a opíšte akciu medzi nimi. Obrazový profil výrobcu prijíma JPG, JPEG a PNG do 10 MB s rozmermi aspoň 300 pixelov; pomer strán úvodného obrázka musí byť medzi 1:2.5 a 2.5:1. Obrázky hraničných snímok pripravte pre túto úlohu a nepovažujte opis storyboardu za zameniteľný vstupný balík.
Profil Standard môže generovať natívny zvuk, keď je tento režim zapnutý; referencia výrobcu predvolene zvuk vypína. Hovorené repliky, atmosféru a príslušný zvuk opíšte ako súčasť scény. VIDEO 3.0 podporuje spracovanie čínskej, anglickej, japonskej, kórejskej a španielskej reči vrátane prepínania jazykov a podporovaných prízvukov alebo dialektov. Príručka výrobcu uvádza, že dialóg zadaný v inom jazyku sa prekladá do angličtiny. V scéne s viacerými postavami jasne určite hovoriaci subjekt a slová zachovajte dostatočne krátke pre zamýšľaný prednes.
Pôvodné dialógové zadanie môže priradiť repliku Hovoriacemu A, viditeľnú reakciu Hovoriacemu B a zmenu pohľadu sledujúcu výmenu. Zvuk prostredia opíšte oddelene od dialógu, aby sa efekt pozadia nestal nejednoznačným pokynom k reči. Referenčný materiál použite na stanovenie vzhľadu subjektov a text na stanovenie toho, čo robia a hovoria.
Viditeľné písmo je ďalšou časťou postupu 3.0. Zdrojový obrázok môže obsahovať nápis, titulok alebo etiketu produktu, ktorých vzhľad je pri animácii dôležitý. Identifikujte tento text a jeho úlohu v scéne a potom výsledok skontrolujte z hľadiska pravopisu, čitateľnosti a stability. Pri krátkom vizuáli kampane zachovajte dôležitú správu výraznú v kompozícii namiesto spoliehania sa na veľmi malú etiketu v pozadí.
Výstup Standard je 720p. Pro je samostatne zvolený profil 1080p a natívny 4K je ďalší režim výrobcu, nie automatické nastavenie Standard. Voľby pomeru strán pri vedení textom zahŕňajú 16:9, 9:16 a 1:1. Formát a záber vyberte podľa zamýšľaného umiestnenia a potom zachovajte tento vizuálny smer pri porovnávaní zmien akcie, svetla alebo poradia záberov.
Dokončené generovanie poskytuje video so skutočnou dĺžkou. Dokumentácia výsledkov výrobcu uvádza odstránenie generovaných videí po 30 dňoch, preto dokončený klip ihneď uložte. Zadanie scény, referenčné obrázky a zvolený profil uchovajte s klipom, aby neskoršie revízie mali konzistentný východiskový bod. V kontexte použitia klipu skontrolujte vizuálnu akciu, kontinuitu subjektu, kamerové pokrytie, dialóg a písmo. Cielená oprava zlyhaného detailu je užitočnejšia než nahradenie celého zadania scény nesúvisiacimi pokynmi.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-v3.0-std
kwaivgi/kling-v3.0-stdÚvod
Kling VIDEO 3.0 Standard je profil videa 720p od Kuaishou pre textové a obrazové zadania. Vytvárajte scény tri až pätnásť sekúnd s natívnym zvukom, referenciami subjektov, vedením prvou/poslednou snímkou a rozprávaním jedným alebo viacerými zábermi.
- 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-std | 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-std
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-std
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.168 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.252 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.168 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.168 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.168 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.168 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.168 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.504 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.168 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.252 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.168 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.168 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.168 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.168 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.168 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-std","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-std
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Kling: Video v3.0 Standard
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kwaivgi/kling-v3.0-std:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·kwaivgi/kling-v3.0-std: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-std:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1