Source: https://ailoot.ai/models/fi/kling-v2-1/ Canonical: https://ailoot.ai/models/fi/kling-v2-1/ Language: fi # Kling v2.1 [Markdown](https://ailoot.ai/models/fi/kling-v2-1/index.md) · [JSON](https://ailoot.ai/models/fi/kling-v2-1/facts.json) ## [Kling v2.1](https://ailoot.ai/models/fi/kling-v2-1/) Kling v2.1 luo videoita viitekuvasta ja kirjallisesta liikeohjeistuksesta. Sen dokumentoitu kuvasta videoksi -mallikuvaus luettelee viiden ja kymmenen sekunnin kestovaihtoehdot sekä std- ja pro-tilat jakson suunnitteluun. - [**Ailoot Ultra · Video** `POST /v1/videos` `kling-v2-1`](https://ailoot.ai/models/fi/kling-v2-1/#method-0) Tietoa mallista Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle. Kling v2.1 on Kling-videomalli, joka tukee dokumentoidun luettelon mukaan videon luomista kuvasta. Aloita kohtauksen määrittelevästä still-viitekuvasta ja kuvaile sitten liike, joka tekee siitä käyttökelpoisen otoksen. Tuotekuva, kuvitettu ympäristö tai hahmokuva voi antaa sommittelun, josta jakso kehittyy. Valitse viitekuva, jonka avulla suunniteltu toiminta on ymmärrettävissä. Oven viereen sijoitettu hahmo antaa selkeän lähtökohdan huoneeseen astumiselle. Kun esine asetetaan pinnalle, jolla ei ole ylimääräisiä esineitä, sen ääriviivoja on helpompi tarkastella. Säilytä viitekuva alkuperäislaatuisena ja pidä se yhdistettynä luotuun leikkeeseen. Kuvaile yksi yhtenäinen toimintakokonaisuus. Määrittele pääkohde, liikkumissuunta ja tavoiteltu lopputila. Selitä vuorovaikutuksessa osallistujien suhde: kuka kurottaa, mihin kosketaan ja mihin toiminta päättyy. Käytä näkyviä yksityiskohtia, jotka voi tarkistaa syntyvästä jaksosta. Rajaa otos sen käyttötarkoitusta varten. Dokumentoitu kuvasta videoksi -mallikuvaus luettelee vaaka-, pysty- ja neliökuvasuhteet sekä viiden ja kymmenen sekunnin kestovaihtoehdot. Määrittele, missä pääkohteen pitäisi pysyä valitussa kuva-alassa. Pystysommittelu ja laaja ympäristön esittelyotos asettavat samalle liikkeelle erilaiset vaatimukset. Dokumentoidut kuvasta videoksi -säätimet sisältävät std- ja pro-generointitilat. Säilytä valittu tila tuloksen yhteydessä, kun vertailet vaihtoehtoja. Arvioi, miten tulos vastaa ohjeistuksessa pyydettyä toimintaa, sommittelua, pääkohteen ulkonäköä ja ajoitusta. Pelkkä tilan nimi ei kerro, kuinka hyvin yksittäinen otos vastaa näihin tarpeisiin. Tue tapahtumaa kameran ohjeistuksella. Paikallaan oleva kamera voi näyttää muuttuvan asennon, sivuttaisliike voi paljastaa ympäristön ja eteenpäin suuntautuva liike korostaa yksityiskohtaa. Ilmaise pääkohteen ja kuvakulman tavoiteltu suhde, jotta kameran liike ei kilpaile katsojan seurattavan toiminnan kanssa. Tarkista jatkuvuus koko leikkeestä. Tarkastele tuotteessa muotoa, merkintöjä ja materiaalin ulkonäköä kuvakulman muuttuessa. Tarkastele ihmisessä kasvonpiirteitä, käsiä, vaatetusta ja kosketusta lähellä oleviin esineisiin. Tarkista lopun sommittelu suhteessa leikkauksen seuraavaan otokseen tai grafiikkaan. Tallenna valmis video, viitekuva, kehote ja valitut asetukset yhdeksi otostietueeksi. Määrittele korjauksessa täsmällinen visuaalinen poikkeama ja säilytä kohtauksen tarkoitusta jo palvelevat osat. Vertaile vaihtoehtoja samalla toistokoolla ja -nopeudella, jotta valinta perustuu siihen liikkeeseen ja sommitteluun, jonka yleisö todella näkee. **Ailoot Ultra · Video** `POST /v1/videos` `kling-v2-1` [`kling-v2-1`](https://ailoot.ai/models/fi/#m=kling-v2-1&route=Ultra&caller=kling-v2-1&fmt=videos) Kling /`kling-v2-1` ### Aloitus Kling v2.1 luo videoita viitekuvasta ja kirjallisesta liikeohjeistuksesta. Sen dokumentoitu kuvasta videoksi -mallikuvaus luettelee viiden ja kymmenen sekunnin kestovaihtoehdot sekä std- ja pro-tilat jakson suunnitteluun. Hyväksytyt syötteet Teksti · Kuvat Tulokset Video ### Saatavilla Ailootissa · syötteet & menetelmät **Ailoot Ultra · Video** `POST /v1/videos` Syötetyypit `text`, `image` Tulostyypit `video` | Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus | | --- | --- | --- | --- | --- | | Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat kling-v2-1 Ehdot: Käytä täsmälleen tätä Ailoot-reititysvalitsinta. | Oletus— | | Kenttä`mode` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat std, pro Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletusstd | | Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 16:9, 9:16, 1:1 Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— | | Kenttä`duration` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat 5, 10 Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— | | Kenttä`end_image` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— | | Kenttä`image` | Tyyppi`string or array` | VaatimusPakollinen | Arvot & rajat Ehdot: Anna kuvan todellinen, saavutettava URL-osoite. Luettelo hyväksytään vain, jos parametrin skeema määrittelee taulukon. | Oletus— | | Kenttä`negative_prompt` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— | | Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— | Menetelmän parametrit ja elinkaari | Parametri | Sopimus | | --- | --- | | Parametri`content_type` | Sopimusapplication/json | | Parametri`required` | Sopimusmodel, prompt, image | | Parametri`optional` | Sopimusmode, aspect\_ratio, duration, end\_image, negative\_prompt | | Parametri`material_types` | Sopimustext, image | | Parametri`conditions` | SopimusKäytä täsmälleen tätä Ailoot-reititysvalitsinta., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Anna kuvan todellinen, saavutettava URL-osoite. Luettelo hyväksytään vain, jos parametrin skeema määrittelee taulukon., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Menetelmien aliakset: `/v1/videos/generations` Elinkaari: `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Hinnoittelu ##### Lopullisen veloituksen laskenta Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä. Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle. Nopea tila Ei määritetty Kun nopea tila on valittu Flex-tila Ei määritetty Kun flex-tila on valittu Päättelyn enimmäisteho Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä #### Arvioidut vertailuhinnat #### Hinnat asetusten mukaan Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden. | Asetukset | Hinnasto | Ennustettu määrä | Veloitus | | --- | --- | --- | --- | | AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | 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 | | AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$6** 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · Video curl · luo vain kerran ja säilytä koko tulosLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY : "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}" export AILOOT_IMAGE_URL python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "kling-v2-1", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}') p['image']=os.environ['AILOOT_IMAGE_URL'] Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json # Submit once. Retain the complete result, original identifiers and every response header. ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_STATUS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("result.json").read_text()) u=urljoin("https://api.ailoot.ai",r["polling_url"]) p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password: raise SystemExit("Unexpected returned polling URL; preserve the response") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True) # Read this same original polling_url again while pending. # Preserve unknown/result_pending_check; do not repeat creation. PY_STATUS ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_ASSETS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("status.json").read_text()) roles={} def visit(v,path=""): if isinstance(v,dict): for k,x in v.items(): visit(x,path+"/"+k) elif isinstance(v,list): for i,x in enumerate(v): visit(x,path+"/"+str(i)) elif isinstance(v,str): u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u) if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"): roles.setdefault(u,[]).append(path) visit(r) if not roles: raise SystemExit("No completed owned assets; retain the original status") manifest=[] for i,(u,paths) in enumerate(roles.items()): target=Path(f"asset-{i}.bin") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True) raw=target.read_bytes() if not raw: raise SystemExit("Empty asset; retain original status and metadata") ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin" name=f"asset-{i}.{ext}" if target.name!=name: target.rename(name) manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)}) Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2)) print("Saved",len(manifest),"unique owned assets; every response role retained") PY_ASSETS ``` ### Vastaanota ja tallenna tulokset #### Ailoot Ultra · Video - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Säilytä kaikki valmistuneet tulokset Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL. Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit. ##### Jos alkuperäinen vastaus on tarkistettava Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result\_pending\_check ei oikeuta uuteen luontipyyntöön. Vastauksen kentät | Kenttä | Tyyppi | | --- | --- | | Kenttä`id` | Tyyppistring | | Kenttä`polling_url` | Tyyppistring | | Kenttä`provider_task_id` | Tyyppistring | | Kenttä`task_id` | Tyyppistring | | Kenttä`status` | Tyyppistring | | Kenttä`video_url` | Tyyppistring | Virheet ja seuraavat vaiheet | Vastaus | Ehto | Seuraava vaihe | | --- | --- | --- | | Vastaus400 · `invalid_request_error` | EhtoPakollinen kenttä, mallivalitsin, tyyppi tai syötteen esitysmuoto on virheellinen. | Seuraava vaiheTarkista palautetut validointitiedot ennen erillisen pyynnön valmistelua. | | Vastaus`` | EhtoAlkuperäinen pyyntö tai tulos on tuntematon tai vaatii tarkistuksen. | Seuraava vaiheSäilytä alkuperäiset tunnisteet ja otsakkeet; lue vain tuettuja tila- tai kirjastotietueita. Älä lähetä luontipyyntöä uudelleen. | ### Aliakset #### Mallin aliakset **Ailoot Ultra** [`kling-v2-1`](https://ailoot.ai/models/fi/#m=kling-v2-1&route=Ultra&caller=kling-v2-1&fmt=videos) #### Menetelmäpolkujen aliakset `/v1/videos/generations` #### Liittyvät kutsujan ID:t [`kling-v2-1`](https://ailoot.ai/models/fi/#m=kling-v2-1&route=Ultra&caller=kling-v2-1&fmt=videos) FAQ · Kling v2.1 Mitä syötteitä ja tuloksia on saatavilla? `POST /v1/videos` · `kling-v2-1`: `text`, `image` → `video` Mitä kenttiä pyyntö käyttää? `POST /v1/videos` · `kling-v2-1`: `model`, `mode`, `aspect_ratio`, `duration`, `end_image`, `image`, `negative_prompt`, `prompt` Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.