Kling v1.5
Kling v1.5 on videomalli, jolla on dokumentoitu työnkulku videon luomiseen kuvasta. Aloita valmistellusta stillkuvasta ja kuvaile liike, kuvakulma ja lopun sommittelu lyhyttä hahmo-, esine- tai ympäristöotosta varten.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Kling v1.5 on Kling-videomallin versio, joka tukee dokumentoidun malliluettelon mukaan videon luomista kuvasta. Annettu stillkuva toimii visuaalisena lähtökohtana, ja kirjallinen ohjeistus kuvaa, miten kohtauksen pitäisi liikkua. Kehitä sen avulla hahmon elettä, liikkuvaa esinettä tai muuttuvaa ympäristöä kuvasta, jonka sommittelu sopii jo otokseen.
Valmistele kuva pääkohteen tärkeiden yksityiskohtien ympärille. Hahmon kasvot, asento ja vaatetus on voitava hahmottaa selvästi. Esine tarvitsee selkeät ääriviivat ja näkyvät materiaalipiirteet. Jätä sommitteluun tilaa suunnitellulle liikkeelle. Säilytä alkuperäinen stillkuva valmiin jakson kanssa, jotta ulkonäön muutoksia voi arvioida suoraan.
Kirjoita toiminta havaittavana tapahtumana. Kuvaile esimerkiksi, miten istuva ihminen kääntyy kohti ikkunaa tai kangasnauha liikkuu kevyessä tuulessa. Kerro suunta ja tavoiteltu loppu. Kun kuvassa on useita esineitä, määrittele, mikä niistä liikkuu ja mitkä pysyvät paikoillaan.
Selitä kameran tehtävä. Kiinteä kuvakulma voi helpottaa pienen eleen tarkastelua, kun taas liikkuva kuvakulma voi tuoda kohtauksesta esiin uuden puolen. Kuvaile tätä liikettä suhteessa pääkohteeseen. Pyyntö lähestyä pääkohdetta ja pyyntö saada pääkohde lähestymään kameraa tarkoittavat visuaalisesti eri asioita.
Dokumentoitu kuvasta videoksi -mallikuvaus luettelee viiden ja kymmenen sekunnin kestovaihtoehdot, std- ja pro-tilat sekä vaaka-, pysty- ja neliörajauksen. Valitse valitussa työnkulussa tarjolla olevat asetukset ennen tuloksen arvioimista. Säilytä käytetty tila, kesto ja kuvasuhde lähdekuvan ja kehotteen kanssa, kun vertailet otosvaihtoehtoja.
Määrittele esineen esittelyssä visuaalinen piirre, jonka liikkeen pitäisi paljastaa. Se voi olla heijastava pinta, materiaalin taitos tai kahvan muoto. Rajaa toiminta niin, että olennainen piirre pysyy näkyvissä. Arvioi esinettä koko liikkeen ajan sekä leikkauksessa käytettävässä loppunäkymässä.
Kuvaile hahmokohtauksessa yksi merkityksellinen ele ja hahmon suhde lähellä oleviin esineisiin. Tarkastele kasvoja, käsiä, vaatetusta ja kehon mittasuhteita ajan kuluessa. Tarkista, saavuttaako ele tavoitellun lopun ja säilyykö etualan ja taustan elementtien järjestys kohtauksessa johdonmukaisena.
Säilytä koko luotu leike ja sen lähdemateriaalit. Tarkastele alkua, keskeistä toimintaa ja loppua yhtenä jaksona ja kohdista korjaukset sitten konkreettiseen poikkeamaan. Esimerkiksi huomio ”hahmo kääntyy poispäin ikkunasta” antaa seuraavalle ohjeistukselle täsmällisen korjauskohteen ja säilyttää muun kohtauksen.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Aloitus
Kling v1.5 on videomalli, jolla on dokumentoitu työnkulku videon luomiseen kuvasta. Aloita valmistellusta stillkuvasta ja kuvaile liike, kuvakulma ja lopun sommittelu lyhyttä hahmo-, esine- tai ympäristöotosta varten.
- 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 | Tyyppistring | VaatimusPakollinen | Arvot & rajat kling-v1-5 Ehdot: Käytä täsmälleen tätä Ailoot-reititysvalitsinta. | Oletus— |
Kenttämode | Tyyppistring | 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 | Tyyppistring | 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 | Tyyppiinteger | 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 | Tyyppistring | 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 | Tyyppistring or array<string> | 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 | Tyyppistring | 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 | Tyyppistring | 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 |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt, image |
Parametrioptional | Sopimusmode, aspect_ratio, duration, end_image, negative_prompt |
Parametrimaterial_types | Sopimustext, image |
Parametriconditions | 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 →
Esimerkkipyynnöt
Ailoot Ultra · Video
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-v1-5", "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.
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
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}/contentGET /v1/media/assetsGET /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-v1-5
Menetelmäpolkujen aliakset
/v1/videos/generations
Liittyvät kutsujan ID:t
FAQ · Kling v1.5
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·kling-v1-5:text,image→video- Mitä kenttiä pyyntö käyttää?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt