{ "aboutHtml": "

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.

", "aboutText": "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.\n\nUusi 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ä.\n\nO1:n kehote voi nimetä kuvia, elementtejä ja videoita tietyillä viitemerkeillä, kuten <<>> tai <<>>. 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.\n\nKuvapohjaisille 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ä.\n\nKuvasyö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ä.\n\nAlku- 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.\n\nLä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.\n\nViitevideokehotteella 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.\n\nValmistajan 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.\n\nValmistajan 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.\n\nGenerointi 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "47dbb8eabbb56af567e42724d981ebbb06ae28d1e459e05946470f39d079eaac", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "
•

Kling: Video O1

Kuaishou /kwaivgi/kling-video-o1

Aloitus

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
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.

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äTyyppiVaatimusArvot & rajatOletus
KenttämodelTyyppistringVaatimusPakollinenArvot & rajat
kwaivgi/kling-video-o1
Oletus—
KenttäpromptTyyppistringVaatimusPakollinenArvot & rajatOletus—
KenttädurationTyyppiintegerVaatimusPakollinenArvot & rajat
5, 10
Vähimmäismäärä: 1
Enimmäismäärä: 600
Oletus—
KenttäresolutionTyyppistringVaatimusValinnainenArvot & rajat
720p
Oletus—
Kenttäaspect_ratioTyyppistringVaatimusValinnainenArvot & rajat
16:9, 9:16, 1:1
Oletus—
Kenttägenerate_audioTyyppibooleanVaatimusValinnainenArvot & rajat
false, true
Oletus—
Kenttäframe_imagesTyyppiarrayVaatimusValinnainenArvot & 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_referencesTyyppiarrayVaatimusValinnainenArvot & rajatOletus—
KenttäsizeTyyppistringVaatimusValinnainenArvot & rajat
1280x720, 720x1280, 720x720
Merkkijonomalli: ^[1-9][0-9]*x[1-9][0-9]*$
Oletus—
Kenttäcallback_urlTyyppistringVaatimusValinnainenArvot & rajat
Merkkijonomalli: ^https://
Oletus—
Kenttäsession_idTyyppistringVaatimusValinnainenArvot & rajatOletus—
KenttätraceTyyppiobjectVaatimusValinnainenArvot & rajatOletus—
KenttäuserTyyppistringVaatimusValinnainenArvot & rajatOletus—
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
ParametriSopimus
Parametricontent_typeSopimusapplication/json
ParametrirequiredSopimusmodel, prompt, duration
Parametrimaterial_typesSopimustext, image
Parametriadditional_propertiesSopimusfalse
Parametrioptional_controlsSopimusresolution, 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.

AsetuksetHinnastoEnnustettu määräLaskutusyksikköLaskutusehdotVeloitus
AsetuksetTokenien perushinnatHinnastoPerushintaEnnustettu 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 hintaHinnasto—Ennustettu määrä—Laskutusyksikkövideosekuntia kohdenLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Tuloste · Videon hinta · Arvio vain vertailua varten $0.224 videosekuntia kohden
AsetuksetArvioitu luontikustannusHinnasto—Ennustettu määräyhden generoinnin arvioLaskutusyksikkö—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

AsetuksetLaskutusehdotVeloitus
AsetuksetVideon hintaLaskutusehdotTä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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

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\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Muut sisällön lukukerrat
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
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äTyyppiMerkitys
KenttäindexTyyppiintegerMerkitysTämän videon nollasta alkava sijainti tulosluettelossa.
Kenttäcontent_urlTyyppistringMerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.
Kenttäsha256Tyyppistring | nullMerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.
Kenttäsize_bytesTyyppiinteger | nullMerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.
Kenttäduration_msTyyppiinteger | nullMerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.
KenttäwidthTyyppiinteger | nullMerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla.
KenttäheightTyyppiinteger | nullMerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.
Kenttävideo_codecTyyppistring | nullMerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu.
Kenttähas_audioTyyppiboolean | nullMerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.
Kenttäaudio_codecTyyppistring | nullMerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.
Virheet ja seuraavat vaiheet
VastausEhtoSeuraava vaihe
Vastaus404 · not_found_errorEhtoVideoon 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_errorEhtoAPI-avain ei vastaa todennettua tiliä.Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.
Vastaus400 · invalid_request_errorEhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen.Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.
Vastaus422 · price_unavailableEhtoValittua videokokoonpanoa ei voida hinnoitella.Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.
Vastaus422 · invalid_request_errorEhtoVideosyö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_errorEhtoKä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_errorEhtoVideon 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_checkEhtoAlkuperä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_unavailableEhtoOlemassa 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_readyEhtoVideosisä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

kwaivgi/kling-video-o1

", "method_identity": { "effective_request_model_id": "kwaivgi/kling-video-o1", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|kwaivgi%2Fkling-video-o1", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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ä.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio; lisää kuvasuhde tai käytä lueteltua kokoa.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "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ä.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "kwaivgi/kling-video-o1", "nativeProvenance": { "input_facts_canonical_sha256": "91ea51370cd865667fbcd0d442a7b4677820846c9a99068e781451accc78d211", "input_html_sha256": "8d9378795cb3be3d94396af614a0db30342dd0db57c3a700eb0b31ac28acae64", "private_audit_sha256": "6986abf0b355c8e88795f929b7c1eaf96b306f61d8756bd42680704e1e16ce76", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fi/kwaivgi-kling-video-o1/", "description": "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.", "locale": "fi", "md_url": "https://ailoot.ai/models/fi/kwaivgi-kling-video-o1/index.md", "title": "Kling: Video O1 — Ailoot", "url": "https://ailoot.ai/models/fi/kwaivgi-kling-video-o1/" }, "rawModel": { "about": "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.\n\nUusi 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ä.\n\nO1:n kehote voi nimetä kuvia, elementtejä ja videoita tietyillä viitemerkeillä, kuten <<>> tai <<>>. 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.\n\nKuvapohjaisille 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ä.\n\nKuvasyö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ä.\n\nAlku- 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.\n\nLä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.\n\nViitevideokehotteella 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.\n\nValmistajan 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.\n\nValmistajan 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.\n\nGenerointi 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.", "alias_of": null, "aliases": [], "author": "Kuaishou", "available": null, "canonical_model": "kwaivgi/kling-video-o1", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Konfiguraation täydet hintatiedot lisätiedoissa." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "5674106f0bbce742cc7b0c00", "label": "Videokokoonpanojen hintaviitteet", "profiles": [ { "basis": "Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan.", "dimensions": { "conditions": "Tässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa." }, "label": "Videon hinta", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "kwaivgi/kling-video-o1", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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ä.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio; lisää kuvasuhde tai käytä lueteltua kokoa.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "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.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ensimmäisen ruudun kuva." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "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ä.", "content": "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.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "kwaivgi/kling-video-o1", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" } ], "name": "Kling: Video O1", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.12, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.12, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "hosted_reference" }, "dimensions": { "published_labels": [], "variant": "duration_seconds" }, "label": "Ultra", "units": [ { "amount": "0.2240", "amount_unit": "usd_per_second", "conditions": { "published_labels": [], "variant": "duration_seconds" }, "key": "duration_seconds", "label": "duration seconds", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.224", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.2240", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "kwaivgi/kling-video-o1", "short": "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." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "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.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "0c386722d57059072f735bde984739fe774b0c2207975814314ee4c656141738", "renderer_sha256": "303a59603e2bc29ba8fda690e95fd32cec68de223d92e26054a88babff801dd7" }, "sourceRevision": "716cefd5a9c2c26448c2f53355e1b50f916fa99d5240373ab3e592db390e1c28" }