Kling v1.5
Kling v1.5 är en videomodell med ett dokumenterat arbetsflöde för bild-till-video. Utgå från en förberedd stillbild och beskriv rörelsen, perspektivet och slutkompositionen för en kort tagning med en karaktär, ett föremål eller en miljö.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
Kling v1.5 är en version av Klings videogenerering med bild-till-video-funktion i den dokumenterade modellkatalogen. En tillhandahållen stillbild ger den visuella utgångspunkten, medan den skrivna beskrivningen anger hur scenen ska röra sig. Använd modellen för att utveckla en karaktärs gest, ett föremåls rörelse eller en föränderlig miljö utifrån en bild vars komposition redan passar tagningen.
Förbered bilden med motivets viktiga detaljer i åtanke. En karaktär behöver ett tydligt ansikte, en tydlig pose och tydliga kläder; ett föremål behöver en tydlig kontur och synliga materialegenskaper. Lämna utrymme i kompositionen för den avsedda rörelsen. Spara den ursprungliga stillbilden tillsammans med den färdiga sekvensen så att utseendeförändringar kan bedömas direkt.
Beskriv handlingen som en iakttagbar händelse. Beskriv till exempel en sittande person som vänder sig mot ett fönster eller ett tygband som rör sig i en lätt bris. Ange riktningen och det avsedda slutläget. När flera föremål finns i bild ska du identifiera vilket som agerar och vilka som stannar på plats.
Förklara kamerans roll. Ett fast perspektiv kan göra en liten gest lätt att granska, medan ett rörligt perspektiv kan visa en ny sida av scenen. Beskriv den rörelsen i förhållande till motivet. En instruktion om att närma sig motivet och en instruktion om att motivet ska närma sig kameran uttrycker olika visuella avsikter.
Den dokumenterade bild-till-video-posten anger valbara längder på fem och tio sekunder, lägena std och pro samt liggande, stående och kvadratiskt bildformat. Välj de inställningar som erbjuds i det valda arbetsflödet innan du bedömer resultatet. Spara det faktiska läget, längden och bildformatet tillsammans med källbilden och prompten när du jämför tagningsförslag.
För en föremålspresentation ska du ange vilken visuell egenskap rörelsen ska visa. Det kan vara en reflekterande yta, ett veck i ett material eller formen på ett handtag. Håll handlingen tillräckligt fokuserad för att den viktiga egenskapen ska förbli synlig. Bedöm föremålet under hela rörelsen och i den slutbild som används i klippningen.
För en karaktärsscen ska du beskriva en betydelsefull gest och karaktärens förhållande till föremål i närheten. Granska ansikte, händer, kläder och kroppsproportioner över tid. Kontrollera om gesten når sitt avsedda slutläge och om scenen behåller ett sammanhängande arrangemang av element i förgrund och bakgrund.
Behåll hela det genererade klippet och dess källmaterial. Granska början, den centrala handlingen och avslutningen som en sammanhängande sekvens och gör sedan ändringar utifrån en konkret avvikelse. En anteckning som ”karaktären vänder sig bort från fönstret” ger nästa beskrivning en specifik korrigering samtidigt som resten av scenen bevaras.
Ailoot Ultra · Video POST /v1/videos kling-v1-5
kling-v1-5Start
Kling v1.5 är en videomodell med ett dokumenterat arbetsflöde för bild-till-video. Utgå från en förberedd stillbild och beskriv rörelsen, perspektivet och slutkompositionen för en kort tagning med en karaktär, ett föremål eller en miljö.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Video POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser kling-v1-5 Villkor: Använd exakt denna routningsväljare för Ailoot. | Standard— |
Fältmode | Typstring | KravValfritt | Värden & gränser std, pro Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standardstd |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 16:9, 9:16, 1:1 Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser 5, 10 Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standard— |
Fältend_image | Typstring | KravValfritt | Värden & gränser Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standard— |
Fältimage | Typstring or array<string> | KravObligatoriskt | Värden & gränser Villkor: Ange bildens verkliga, tillgängliga URL. En lista godtas endast där parameterschemat anger en array. | Standard— |
Fältnegative_prompt | Typstring | KravValfritt | Värden & gränser Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser Villkor: Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt, image |
Parameteroptional | Avtalmode, aspect_ratio, duration, end_image, negative_prompt |
Parametermaterial_types | Avtaltext, image |
Parameterconditions | AvtalAnvänd exakt denna routningsväljare för Ailoot., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts., Ange bildens verkliga, tillgängliga URL. En lista godtas endast där parameterschemat anger en array., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts., Använd det dokumenterade fältet och de angivna alternativen för den valda modellen; utelämna ett valfritt värde som inte har angetts. |
Metodalias: /v1/videos/generations
Livscykel: 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}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $6 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
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
Ta emot och spara resultat
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}
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll hela svaret och svarshuvudena, ursprungliga identifierare, varje faktiskt resultat och alla förbruknings- och redovisningsfält. Spara varje unik tillgång som du äger och behåll varje roll som pekar på den.
Om det ursprungliga svaret behöver kontrolleras
Behåll det returnerade offentliga uppgifts- eller operations-id:t och samtliga svarshuvuden. Läs endast den ursprungliga uppgiften; unknown eller result_pending_check ger inte tillstånd att skapa på nytt.
Svarsfält
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältpolling_url | Typstring |
Fältprovider_task_id | Typstring |
Fälttask_id | Typstring |
Fältstatus | Typstring |
Fältvideo_url | Typstring |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorEtt obligatoriskt fält, en modellväljare, en typ eller en representation av indata är ogiltig. | Nästa stegGranska den returnerade valideringsinformationen innan du förbereder en separat begäran. |
Svar | VillkorDen ursprungliga begäran eller resultatet är okänt eller behöver kontrolleras. | Nästa stegBehåll ursprungliga identifierare och huvuden; läs endast status- eller biblioteksposter som stöds. Skicka inte skapandebegäran igen. |
Alias
Modellalias
Ailoot Ultra kling-v1-5
Alias för metodsökvägar
/v1/videos/generations
Relaterade anropar-ID:n
FAQ · Kling v1.5
- Vilka indata och resultat finns?
POST /v1/videos·kling-v1-5:text,image→video- Vilka fält använder begäran?
POST /v1/videos·kling-v1-5:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt