Kling: Video O1
Kling VIDEO O1 je Kuaishouev video model na podlagi referenc za ustvarjanje in urejanje prizorov z besedilom, slikami, elementi motivov in izvornim posnetkom. Njegov profil ustvarjanja v dolžini od treh do desetih sekund uporabite za vizualno neprekinjenost, vodene prehode med sličicami in ciljne spremembe obstoječih posnetkov.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Kling VIDEO O1 je Kuaishouev enoten video model na podlagi referenc. Besedilni opis združi s slikami, pripravljenimi elementi motivov ali izvornim videom, da usmerja nove prizore in ciljne spremembe obstoječih posnetkov. Njegov osrednji vmesnik je vizualni opis: označite referenčno gradivo, opišite njegovo vlogo in navedite videz, dogajanje ali preobrazbo, ki jo želite v končnem videu.
Nov kader se lahko začne z besedilom, začetno sliko ali nizom vizualnih referenc. S sliko določite lik ali predmet, okolje, dogajanje in zorni kot pa opišite z besedami. Kadar več referenc prispeva različne značilnosti, njihove vloge izrecno dodelite. Izviren opis izdelka lahko vzame predmet iz ene slike in okolje iz druge, nato pa opiše gibanje predmeta znotraj tega okolja.
Poziv O1 lahko slike, elemente in videe poimenuje s posebnimi referenčnimi oznakami, kot sta <<<image_1>>> ali <<<video_1>>>. Te oznake povežite z dejansko priloženim gradivom in pojasnite, kaj naj se iz njega prevzame. Proizvajalčeva omejitev poziva je 2.500 znakov. Jedrnato navodilo, ki označi motiv in spremembo, je uporabnejše kot zbirka nepovezanih slogovnih izrazov.
Za slikovne reference brez video vhoda je dokumentirana skupna omejitev do sedem referenčnih slik in elementov z več slikami. Pri referenčnem videu je ta omejitev slik in elementov štiri. Te omejitve veljajo za elemente na podlagi slik; druge vrste elementov imajo ločena pravila združljivosti. Izberite gradivo, ki prinaša bistvene podatke o videzu ali prizoru, namesto da bi omejitev zapolnili s podvojenimi pogledi.
Slikovni vhodi uporabljajo JPG, JPEG ali PNG, podane kot dostopen URL ali slikovni podatki, z datotekami do 10 MB, merami vsaj 300 pikslov in razmerjem stranic med 1:2.5 in 2.5:1. Pripravite jasne motive in v izrezu ohranite pomembne podrobnosti. Če mora lik ali izdelek ostati prepoznaven, navedite značilnosti, ki naj se ohranijo, in jih preverite skozi celoten končni posnetek.
Začetne in končne sličice pogojujejo prehod med vizualnima mejama. Dokumentirani postopek O1 z mejnimi sličicami zahteva začetno sličico, kadar je podana končna, ter ne podpira nadzora začetne in končne sličice z več kot dvema slikama v polju. Ko sta uporabljeni obe mejni sličici, dodatni elementi motivov niso del te konfiguracije O1. Nalogo z nadzorom sličic ločite od urejanja priloženega osnovnega videa.
Izvorni video ima lahko dve različni vlogi. Kot osnovni posnetek je gradivo, ki ga urejate: usmerite določen dodatek, odstranitev, slogovno obdelavo ali spremembo kompozicije in navedite, kaj naj ostane. Urejanje sledi dolžini vhodnega posnetka in te naloge z osnovnim videom ne združuje z nadzorom mejnih sličic ali ustvarjanjem več kadrov. Kot referenca značilnosti video prispeva podatke o vsebini, slogu ali kameri za nov kader.
Poziv z referenčnim videom lahko zahteva tudi predhodni ali naslednji kader. Označite izvorni posnetek in opišite nov vidni dogodek, denimo nadaljevanje dejanja motiva ali razkritje okoliškega okolja. Referenca tu posreduje vizualne podatke; preden novi odsek sestavite z izvirnimi posnetki, preverite stik in neprekinjenost motiva.
Proizvajalčev profil video vhoda sprejme en vir MP4 ali MOV do 200 MB z najmanjšo dolžino treh sekund. Njegov podrobni vhodni profil določa mere od 720 do 2160 pikslov in hitrosti od 24 do 60 sličic na sekundo, z vhodnim razmerjem stranic med 1:2.5 in 2.5:1. Ta dokumentirani postopek z izvornim videom vrne video s 24 sličicami na sekundo. Natančna dovoljena dolžina posnetka je odvisna tudi od izbranega profila modela. Razpon novega ustvarjanja O1 je od treh do desetih sekund, ločeno od razpona dolžin poznejšega 3.0 Omni.
Proizvajalčevi načini O1 ponujajo izhod 720p Standard ali 1080p Pro. Kadriranje novega kadra podpira dokumentirane ležeče, pokončne in kvadratne možnosti, kadar izbrani postopek uporablja ta nadzor; urejanje osnovnega videa sledi kadriranju vira. Zvok izvornega videa lahko ohranite ali zavržete. Referenčni in urejevalni postopek O1 naj ostane ločen od poznejšega profila 3.0 Omni z izvornim zvokom in prilagojenim snemalnim načrtom.
Ustvarjanje odpre opravilo, katerega končni rezultat vsebuje video gradivo in dejansko dolžino. Proizvajalčeva dokumentacija rezultatov navaja, da se ustvarjeni videi izbrišejo po 30 dneh, zato končni posnetek pravočasno shranite. Z rezultatom ohranite izvorna gradiva in opis, nato preverite zahtevano spremembo, uporabo referenc in neprekinjenost. Pri urejanju primerjajte prizadeto območje in dele, ki naj ostanejo. Pri novem kadru na podlagi referenc preverite, ali je vsako gradivo prispevalo predvidene vizualne podatke. Končni posnetek ohranite na voljo za naslednjo montažo ali produkcijsko zaporedje.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Začetek
Kling VIDEO O1 je Kuaishouev video model na podlagi referenc za ustvarjanje in urejanje prizorov z besedilom, slikami, elementi motivov in izvornim posnetkom. Njegov profil ustvarjanja v dolžini od treh do desetih sekund uporabite za vizualno neprekinjenost, vodene prehode med sličicami in ciljne spremembe obstoječih posnetkov.
- Dovoljeni vhodi
- Besedilo · Slike
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Video POST /v1/videos
- Vhod
text,image- Izhod
video- Izhodni format
- izvirni bajti MP4; brez normalizacije ali prekodiranja
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve kwaivgi/kling-video-o1 | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljeduration | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve 5, 10 Najmanj: 1 Največ: 600 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 720p | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 16:9, 9:16, 1:1 | Privzeto— |
Poljegenerate_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve false, true | Privzeto— |
Poljeframe_images | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 2 Vhodna vsebina: Polje objektov sličic. Vsak objekt vsebuje type=image_url, image_url z url in frame_type. Uporabite URL slike HTTPS in nastavite frame_type na first_frame ali last_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Natančni ključi: type, image_url, frame_type Pogoji: Ti ključi opisujejo vsak objekt sličice; image_url vsebuje samo url. Pri zahtevi samo z besedilom izpustite frame_images. | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 1280x720, 720x1280, 720x720 Vzorec: ^[1-9][0-9]*x[1-9][0-9]*$ | Privzeto— |
Poljecallback_url | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Vzorec: ^https:// | Privzeto— |
Poljesession_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetrace | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljeuser | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Kombinacije vhodnih gradiv
Iz besedila v video · Pisni poziv. · Obvezno: model, prompt, duration
Podajte prompt kot besedilo in duration v celih sekundah. Izberite podprto ločljivost; dodajte razmerje stranic ali uporabite navedeno velikost.
model: Vrsta: string · kwaivgi/kling-video-o1
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Iz slike v video · Pisni poziv in slika prve sličice. · Obvezno: model, prompt, duration, frame_images
frame_images je polje. Vsak objekt sličice vsebuje type, image_url in frame_type; image_url vsebuje url. Nastavite type na image_url. Uporabite first_frame z neobveznim last_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Za vsako sličico podajte javni URL slike HTTPS. Izberite podprto ločljivost; dodajte razmerje stranic ali uporabite navedeno velikost.
Natančni ključi: type, image_url, frame_type
model: Vrsta: string · kwaivgi/kling-video-o1
prompt: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt, duration |
Parametermaterial_types | Specifikacijatext, image |
Parameteradditional_properties | Specifikacijafalse |
Parameteroptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Življenjski cikel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Obračunski pogoji | Strošek |
|---|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Obračunski pogoji— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Izhod · Cena videa · Ocena samo za primerjavo $0.224 na sekundo videa |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Obračunski pogoji— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $1.12 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Podrobnosti referenčne tarife
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
Cenovne reference konfiguracij videa
Cene po nastavitvah
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevCena videa | Obračunski pogojiV tem cenovnem ključu ni naveden noben dodaten pogoj. | Strošek Izhod · Cena videa $0.224 na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
Primeri zahtev
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
Prejmi in shrani rezultate
Ailoot Ultra · Video
podpisani URL-ji vsebine v vaši lasti
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Preveri stanje opravila
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
Branje druge vsebine
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
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite vsak dejanski izhod v vaši lasti in njegove vrnjene izmerjene metapodatke.
Če je treba preveriti izvirni odgovor
503 result_pending_check + prvotni id + X-Should-Retry:false; prvotne zahteve nikoli ne ponovite
Polja odgovora
| Polje | Vrsta | Pomen |
|---|---|---|
Poljeindex | Vrstainteger | PomenPoložaj tega videa na seznamu izhodov, štet od nič. |
Poljecontent_url | Vrstastring | PomenPodpisani URL HTTPS za prenos tega dokončanega videa. |
Poljesha256 | Vrstastring | null | PomenIzvleček SHA-256 izvirnih video bajtov; null, če ni na voljo. |
Poljesize_bytes | Vrstainteger | null | PomenVelikost izvirne video datoteke v bajtih; null, če ni na voljo. |
Poljeduration_ms | Vrstainteger | null | PomenIzmerjeno trajanje videa v milisekundah; null, če ni na voljo. |
Poljewidth | Vrstainteger | null | PomenŠirina videa v slikovnih pikah; null, če ni na voljo. |
Poljeheight | Vrstainteger | null | PomenVišina videa v slikovnih pikah; null, če ni na voljo. |
Poljevideo_codec | Vrstastring | null | PomenIdentifikator video kodeka; null, če ni zabeležen. |
Poljehas_audio | Vrstaboolean | null | PomenAli video vsebuje zvočno sled; null, če ni izmerjeno. |
Poljeaudio_codec | Vrstastring | null | PomenIdentifikator zvočnega kodeka; null, kadar identifikator ni zabeležen. |
Napake in naslednji koraki
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor404 · not_found_error | PogojDostop do videa ni na voljo ali ta ID videa ni bil najden. | Naslednji korakPreverite dostop do videa. Za obstoječi video uporabite njegov prvotni javni ID in isti ključ API. |
Odgovor401 · authentication_error | PogojKljuč API se ne ujema z overjenim računom. | Naslednji korakPred oddajo preverite svoj ključ API in dostop do računa. |
Odgovor400 · invalid_request_error | PogojZahteve ni bilo mogoče prebrati ali je indeks prenosa neveljaven. | Naslednji korakPopravite telo zahteve. Pri prenosu izberite indeks izhoda, ki ga je vrnilo prvotno opravilo. |
Odgovor422 · price_unavailable | PogojIzbrane video konfiguracije ni mogoče ovrednotiti. | Naslednji korakIzberite podprto konfiguracijo videa in izpolnite njene obvezne možnosti, preden oddate popravljeno zahtevo. |
Odgovor422 · invalid_request_error | PogojVideo vhod ali prvotno nadaljevalno opravilo ni veljavno. | Naslednji korakUporabite veljavne vhode HTTPS. Za nadaljevanje uporabite javni ID svojega dokončanega prvotnega videa z istim ključem API. |
Odgovor402 · billing_error | PogojRazpoložljivo dobroimetje ali omejitve ne omogočajo rezervacije. | Naslednji korakPreden pošljete novo zahtevo, preverite razpoložljivo dobroimetje in omejitve. |
Odgovor503 · server_error | PogojPreverjanje videa, shramba ali dostop do storitve začasno ni na voljo. | Naslednji korakPočakajte, da bo storitev na voljo. Če že imate ID videa, preverite to prvotno opravilo, namesto da ustvarite novo generacijo. |
Odgovor503 · result_pending_check | PogojPrvotni video rezultat in zaračunani znesek je treba preveriti. | Naslednji korakOhranite vrnjeni ID videa in preverjajte to opravilo. Med preverjanjem ne pošljite nadomestne zahteve za ustvarjanje. |
Odgovor503 · owned_result_unavailable | PogojPrenos obstoječega videa začasno ni na voljo. | Naslednji korakPozneje preverite isto video opravilo in prenesite njegov obstoječi izhod. Novo ustvarjanje ustvari ločeno operacijo. |
Odgovor409 · video_not_ready | PogojVideo vsebina ni objavljena. | Naslednji korakPreverite stanje prvotnega opravila. Prenesite, ko sporoči completed; če sporoči failed, upoštevajte njegovo obvestilo o preverjanju zaračunanega zneska. |
Druga imena
Druga imena modelov
Ailoot Ultra kwaivgi/kling-video-o1
Druga imena poti metod
Uporabite zgoraj navedene poti metod.
Povezani ID-ji za klic
FAQ · Kling: Video O1
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Katera polja uporablja zahteva?
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- Katere omejitve veljajo?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1