Kling: Video O1
Kling VIDEO O1 on Kuaishoun viitevetoinen videomalli kohtausten generointiin ja muokkaukseen tekstillä, kuvilla, kohde-elementeillä ja lähdeleikkeellä. Käytä sen 3–10 sekunnin generointiprofiilia visuaaliseen jatkuvuuteen, ohjattuihin ruutusiirtymiin ja olemassa olevan aineiston kohdennettuihin muutoksiin.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Kling VIDEO O1 on Kuaishoun yhtenäinen viitevetoinen videomalli. Se yhdistää tekstikuvauksen kuviin, valmisteltuihin kohde-elementteihin tai lähdevideoon uusien kohtausten ja olemassa olevan aineiston kohdennettujen muutosten ohjaamiseksi. Sen keskeinen rajapinta on visuaalinen tehtävänanto: tunnista viitattu aineisto, kuvaa sen rooli ja kerro tulosvideoon haluttu ulkoasu, toiminta tai muutos.
Uusi otos voi alkaa tekstistä, avauskuvasta tai visuaalisten viitteiden joukosta. Määritä hahmo tai esine kuvalla ja kuvaa ympäristö, toiminta ja näkökulma sanoilla. Kun useat viitteet tuovat eri piirteitä, määritä niiden roolit selkeästi. Alkuperäinen tuotetehtävänanto voisi ottaa esineen yhdestä kuvasta ja ympäristön toisesta ja kuvata sitten esineen liikkeen tässä ympäristössä.
O1:n kehote voi nimetä kuvia, elementtejä ja videoita tietyillä viitemerkeillä, kuten <<<image_1>>> tai <<<video_1>>>. Pidä merkit yhteydessä varsinaiseen annettuun aineistoon ja selitä, mitä siitä tulee ottaa. Valmistajan kehoteraja on 2 500 merkkiä. Tiivis kohteen ja muutoksen tunnistava ohje on hyödyllisempi kuin toisiinsa liittymättömien tyylitermien kokoelma.
Kuvapohjaisille viitteille ilman videosyötettä dokumentoitu yhteisbudjetti on enintään seitsemän viitekuvaa ja monikuvaelementtiä. Viitevideon kanssa kuva- ja elementtibudjetti on neljä. Rajat koskevat kuvapohjaisia elementtejä; muilla elementtityypeillä on erilliset yhteensopivuussäännöt. Valitse aineisto, joka antaa olennaisen ulkoasu- tai kohtaustiedon sen sijaan, että täyttäisit budjetin tarpeettomilla näkymillä.
Kuvasyötteet käyttävät JPG:tä, JPEG:tä tai PNG:tä saatavilla olevana URL:na tai kuvadatana, enintään 10 MB:n tiedostoina, vähintään 300 pikselin mitoilla ja kuvasuhteella 1:2.5–2.5:1. Valmistele selkeät kohteet ja säilytä tärkeät yksityiskohdat rajauksessa. Jos tehtävä edellyttää hahmon tai tuotteen pysymistä tunnistettavana, kerro säilytettävät piirteet ja tarkista ne koko valmiista leikkeestä.
Alku- ja loppuruudut ehdollistavat siirtymän visuaalisten rajojen välille. Dokumentoitu O1:n rajaruututyönkulku vaatii aloitusruudun, kun loppuruutu annetaan, eikä tue alku- ja loppuruutuohjausta yli kahdella taulukon kuvalla. Kun molempia rajaruutuja käytetään, ylimääräiset kohde-elementit eivät kuulu kyseiseen O1-konfiguraatioon. Pidä ruutuohjattu tehtävä erillään annetun pohjavideon muokkaamisesta.
Lähdevideolla voi olla kaksi erillistä roolia. Pohjaleikkeenä se on muokattava aineisto: ohjaa tietty lisäys, poisto, tyylikäsittely tai sommittelumuutos ja kerro säilytettävät asiat. Muokkaus seuraa syöteleikkeen kestoa eikä yhdistä pohjavideotehtävää rajaruutuohjaukseen tai moniotossarjan generointiin. Piirreviitteenä video antaa uuden otoksen sisältö-, tyyli- tai kameratietoa.
Viitevideokehotteella voi myös pyytää edeltävää tai seuraavaa otosta. Tunnista lähdeleike ja kuvaa uusi näkyvä tapahtuma, kuten kohteen toiminnan jatko tai ympäröivän tilan paljastus. Tässä viite välittää visuaalista tietoa; tarkista liitos ja kohteen jatkuvuus ennen uuden segmentin yhdistämistä alkuperäiseen aineistoon.
Valmistajan videosyöteprofiili hyväksyy yhden MP4- tai MOV-lähteen, enintään 200 MB, vähimmäiskestoltaan kolme sekuntia. Tarkka syöteprofiili määrittää mitat 720–2160 pikseliä ja kuvataajuudet 24–60 fps sekä syötteen kuvasuhteen 1:2.5–2.5:1. Dokumentoitu lähdevideotyönkulku palauttaa 24 fps:n videota. Tarkka sallittu leikepituus riippuu myös valitusta malliprofiilista. O1:n uuden generoinnin alue on 3–10 sekuntia, erillään myöhemmän 3.0 Omnin kestoalueesta.
Valmistajan O1-tilat tarjoavat 720p Standard- tai 1080p Pro -tulosteen. Uuden otoksen rajaus tukee dokumentoituja vaaka-, pysty- ja neliövalintoja, kun valittu työnkulku käyttää tätä säädintä; pohjavideomuokkaus seuraa lähderajaustaan. Lähdevideon ääni voidaan säilyttää tai hylätä. O1:n viite- ja muokkaustyönkulku tulee pitää erillään myöhemmän 3.0 Omnin natiiviääni- ja mukautetun kuvakäsikirjoituksen profiilista.
Generointi tuottaa tehtävän, jonka valmis tulos sisältää videotuotoksen ja todellisen keston. Valmistajan tulosdokumentaatio sanoo generoidut videot poistettavan 30 päivän jälkeen, joten tallenna valmis leike viipymättä. Säilytä lähdeaineistot ja tehtävänanto tuloksen kanssa ja tarkista sitten pyydetty muutos, viitteiden käyttö ja jatkuvuus. Vertaa muokkauksessa muutettua aluetta ja säilytettäviä osia. Tarkista viitevetoisesta uudesta otoksesta, että jokainen aineisto antoi tarkoitetun visuaalisen tiedon. Pidä valmis leike saatavilla seuraavaa editointia tai tuotantosarjaa varten.
Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1
kwaivgi/kling-video-o1Aloitus
Kling VIDEO O1 on Kuaishoun viitevetoinen videomalli kohtausten generointiin ja muokkaukseen tekstillä, kuvilla, kohde-elementeillä ja lähdeleikkeellä. Käytä sen 3–10 sekunnin generointiprofiilia visuaaliseen jatkuvuuteen, ohjattuihin ruutusiirtymiin ja olemassa olevan aineiston kohdennettuihin muutoksiin.
- Hyväksytyt syötteet
- Teksti · Kuvat
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Video POST /v1/videos
- Syötetyypit
text,image- Tulostyypit
video- Tulosteen muoto
- alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat kwaivgi/kling-video-o1 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäduration | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat 5, 10 Vähimmäismäärä: 1 Enimmäismäärä: 600 | Oletus— |
Kenttäresolution | Tyyppistring | VaatimusValinnainen | Arvot & rajat 720p | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 16:9, 9:16, 1:1 | Oletus— |
Kenttägenerate_audio | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat false, true | Oletus— |
Kenttäframe_images | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 1 Kohteiden enimmäismäärä: 2 Syötteen sisältö: Kuvaolioiden taulukko. Jokaisessa oliossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä HTTPS-kuvan URL-osoitetta ja aseta frame_type-kentän arvoksi first_frame tai last_frame. Kukin kuvan rooli esiintyy enintään kerran. Tarkat avaimet: type, image_url, frame_type Ehdot: Nämä avaimet kuvaavat jokaista kuvaoliota; image_url sisältää vain url-kentän. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä. | Oletus— |
Kenttäinput_references | Tyyppiarray | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäsize | Tyyppistring | VaatimusValinnainen | Arvot & rajat 1280x720, 720x1280, 720x720 Merkkijonomalli: ^[1-9][0-9]*x[1-9][0-9]*$ | Oletus— |
Kenttäcallback_url | Tyyppistring | VaatimusValinnainen | Arvot & rajat Merkkijonomalli: ^https:// | Oletus— |
Kenttäsession_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätrace | Tyyppiobject | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäuser | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Syöteaineistojen yhdistelmät
Tekstistä videoksi · Kirjoitettu kehote. · Pakollinen: model, prompt, duration
Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio; lisää kuvasuhde tai käytä lueteltua kokoa.
model: Tyyppi: string · kwaivgi/kling-video-o1
prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä
Kuvasta videoksi · Kirjoitettu kehote ja ensimmäisen ruudun kuva. · Pakollinen: model, prompt, duration, frame_images
frame_images on taulukko. Jokaisessa kuvaoliossa on type, image_url ja frame_type; image_url sisältää url-kentän. Aseta type-kentän arvoksi image_url. Käytä first_frame-arvoa ja halutessasi last_frame-arvoa. Kukin kuvan rooli esiintyy enintään kerran. Anna jokaiselle kuvalle julkinen HTTPS-kuvan URL-osoite. Valitse tuettu resoluutio; lisää kuvasuhde tai käytä lueteltua kokoa.
Tarkat avaimet: type, image_url, frame_type
model: Tyyppi: string · kwaivgi/kling-video-o1
prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt, duration |
Parametrimaterial_types | Sopimustext, image |
Parametriadditional_properties | Sopimusfalse |
Parametrioptional_controls | Sopimusresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Elinkaari: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Laskutusyksikkö | Laskutusehdot | Veloitus |
|---|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusyksikkö— | Laskutusehdot— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | LaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa. | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.224 videosekuntia kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Laskutusehdot— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $1.12 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Viitehinnaston tiedot
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
Videokokoonpanojen hintaviitteet
Hinnat asetusten mukaan
| Asetukset | Laskutusehdot | Veloitus |
|---|---|---|
| AsetuksetVideon hinta | LaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa. | Veloitus Tuloste · Videon hinta $0.224 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
Esimerkkipyynnöt
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · Video
allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tarkista työn tila
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
Muut sisällön lukukerrat
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
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.
Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.
Jos alkuperäinen vastaus on tarkistettava
503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä
Vastauksen kentät
| Kenttä | Tyyppi | Merkitys |
|---|---|---|
Kenttäindex | Tyyppiinteger | MerkitysTämän videon nollasta alkava sijainti tulosluettelossa. |
Kenttäcontent_url | Tyyppistring | MerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle. |
Kenttäsha256 | Tyyppistring | null | MerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla. |
Kenttäsize_bytes | Tyyppiinteger | null | MerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla. |
Kenttäduration_ms | Tyyppiinteger | null | MerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla. |
Kenttäwidth | Tyyppiinteger | null | MerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla. |
Kenttäheight | Tyyppiinteger | null | MerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla. |
Kenttävideo_codec | Tyyppistring | null | MerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu. |
Kenttähas_audio | Tyyppiboolean | null | MerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu. |
Kenttäaudio_codec | Tyyppistring | null | MerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu. |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus404 · not_found_error | EhtoVideoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt. | Seuraava vaiheTarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta. |
Vastaus401 · authentication_error | EhtoAPI-avain ei vastaa todennettua tiliä. | Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä. |
Vastaus400 · invalid_request_error | EhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen. | Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi. |
Vastaus422 · price_unavailable | EhtoValittua videokokoonpanoa ei voida hinnoitella. | Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä. |
Vastaus422 · invalid_request_error | EhtoVideosyöte tai alkuperäinen jatkotehtävä on virheellinen. | Seuraava vaiheKäytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella. |
Vastaus402 · billing_error | EhtoKäytettävissä oleva saldo tai rajoitukset eivät salli katevarausta. | Seuraava vaiheTarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä. |
Vastaus503 · server_error | EhtoVideon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla. | Seuraava vaiheOdota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan. |
Vastaus503 · result_pending_check | EhtoAlkuperäinen videotulos ja veloitus on tarkistettava. | Seuraava vaiheSäilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana. |
Vastaus503 · owned_result_unavailable | EhtoOlemassa olevan videon lataus ei ole tilapäisesti saatavilla. | Seuraava vaiheTarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation. |
Vastaus409 · video_not_ready | EhtoVideosisältöä ei ole julkaistu. | Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta. |
Aliakset
Mallin aliakset
Ailoot Ultra kwaivgi/kling-video-o1
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · Kling: Video O1
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·kwaivgi/kling-video-o1:text,image→video- Mitä kenttiä pyyntö käyttää?
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- Mitä rajoja sovelletaan?
POST /v1/videos·kwaivgi/kling-video-o1:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1