Kling v2.1
Kling v2.1 genereert video's op basis van een referentieafbeelding en een geschreven briefing voor de beweging. De gedocumenteerde beschrijving voor beeld-naar-video vermeldt een duur van vijf of tien seconden en de modi std en pro om de sequentie te plannen.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Kling v2.1 is een Kling-videomodel met beeld-naar-videofunctionaliteit in de gedocumenteerde catalogus. Vertrek van een stilstaande referentieafbeelding die de scène vastlegt en beschrijf vervolgens de beweging die er een bruikbaar shot van maakt. Een productafbeelding, geïllustreerde omgeving of beeld van een personage kan de compositie leveren van waaruit de sequentie zich ontwikkelt.
Kies een referentie die de beoogde handeling begrijpelijk maakt. Een onderwerp naast een deur biedt een duidelijk uitgangspunt voor het binnengaan van een kamer; een object op een oppervlak zonder overbodige voorwerpen maakt de contour gemakkelijker te beoordelen. Bewaar de referentie in de oorspronkelijke kwaliteit en hou die gekoppeld aan de gegenereerde clip.
Beschrijf één samenhangende handeling. Benoem het onderwerp, de bewegingsrichting en de beoogde eindtoestand. Leg bij een interactie de relatie tussen de deelnemers uit: wie reikt, wat wordt aangeraakt en waar eindigt de handeling? Gebruik zichtbare details die in de resulterende sequentie kunnen worden gecontroleerd.
Stem het kader van het shot af op het uiteindelijke gebruik. De gedocumenteerde beschrijving voor beeld-naar-video noemt liggende, staande en vierkante beeldverhoudingen en een duur van vijf of tien seconden. Bepaal waar het onderwerp binnen het gekozen kader moet blijven. Een staande compositie en een breed overzichtsshot stellen verschillende eisen aan dezelfde beweging.
De gedocumenteerde beeld-naar-video-instellingen omvatten de generatiemodi std en pro. Bewaar de gekozen modus bij het resultaat wanneer je kandidaten vergelijkt. Beoordeel de uitvoer op basis van de briefing: de gevraagde handeling, compositie, het uiterlijk van het onderwerp en de timing. Een modusnaam op zichzelf vertelt niet hoe goed een afzonderlijk shot aan die vereisten voldoet.
Gebruik camera-instructies om de gebeurtenis te ondersteunen. Een vaste camera kan een veranderende houding tonen, een zijwaartse beweging kan een omgeving onthullen en een voorwaartse beweging kan een detail benadrukken. Geef de beoogde relatie tussen onderwerp en standpunt aan, zodat de camerabeweging de aandacht niet afleidt van de handeling die de kijker moet volgen.
Controleer de continuïteit gedurende de hele clip. Bekijk bij een product de vorm, markeringen en het uiterlijk van het materiaal terwijl het standpunt verandert. Bekijk bij een persoon de gezichtskenmerken, handen, kleding en het contact met objecten in de buurt. Controleer de eindcompositie in samenhang met het volgende shot of grafische element in de montage.
Bewaar de voltooide video, referentie, prompt en geselecteerde instellingen als één shotdossier. Benoem bij een aanpassing de specifieke visuele afwijking en behoud de onderdelen die de scène al ondersteunen. Vergelijk kandidaten bij dezelfde weergavegrootte en snelheid, zodat de keuze de beweging en compositie weerspiegelt die het publiek werkelijk zal zien.
Ailoot Ultra · Video POST /v1/videos kling-v2-1
kling-v2-1Aan de slag
Kling v2.1 genereert video's op basis van een referentieafbeelding en een geschreven briefing voor de beweging. De gedocumenteerde beschrijving voor beeld-naar-video vermeldt een duur van vijf of tien seconden en de modi std en pro om de sequentie te plannen.
- Toegestane invoer
- Tekst · Afbeeldingen
- Resultaten
- Video
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Video POST /v1/videos
- Invoer
text,image- Uitvoer
video
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten kling-v2-1 Voorwaarden: Gebruik precies deze Ailoot-routeringsselector. | Standaard— |
Veldmode | Typestring | VereisteOptioneel | Waarden en limieten std, pro Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaardstd |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 9:16, 1:1 Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaard— |
Veldduration | Typeinteger | VereisteOptioneel | Waarden en limieten 5, 10 Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaard— |
Veldend_image | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaard— |
Veldimage | Typestring or array<string> | VereisteVereist | Waarden en limieten Voorwaarden: Geef de URL van uw werkelijk bereikbare afbeelding op. Een lijst wordt enkel aanvaard wanneer het parameterschema een array vermeldt. | Standaard— |
Veldnegative_prompt | Typestring | VereisteOptioneel | Waarden en limieten Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Voorwaarden: Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, image |
Parameteroptional | Contractmode, aspect_ratio, duration, end_image, negative_prompt |
Parametermaterial_types | Contracttext, image |
Parameterconditions | ContractGebruik precies deze Ailoot-routeringsselector., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg., Geef de URL van uw werkelijk bereikbare afbeelding op. Een lijst wordt enkel aanvaard wanneer het parameterschema een array vermeldt., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg., Gebruik het gedocumenteerde veld en de vermelde keuzemogelijkheden van het gekozen model; laat een niet-opgegeven optionele waarde weg. |
Methodealiasnamen: /v1/videos/generations
Levenscyclus: 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}
Tarieven
Zo worden de uiteindelijke kosten berekend
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieGeschatte generatiekosten | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $6 schatting vóór generatie Deze raming is geen extra kost of vast tarief voor de voltooide generatie. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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-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.
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
Resultaten ophalen en opslaan
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}
Alle voltooide resultaten bewaren
Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Bewaar het volledige antwoord en de headers, de oorspronkelijke identificatiecodes, alle werkelijke uitvoer en alle velden voor verbruik en boekhouding. Sla elke unieke asset die je toebehoort op en behoud elke rol die ernaar verwijst.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de teruggestuurde openbare taak- of operatie-id en alle headers. Raadpleeg uitsluitend de oorspronkelijke taak; unknown of result_pending_check geeft geen toestemming om opnieuw een taak aan te maken.
Antwoordvelden
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldpolling_url | Typestring |
Veldprovider_task_id | Typestring |
Veldtask_id | Typestring |
Veldstatus | Typestring |
Veldvideo_url | Typestring |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeEen verplicht veld, modelselector, type of invoerrepresentatie is ongeldig. | Volgende stapBekijk de teruggegeven validatiedetails voor u een afzonderlijk verzoek voorbereidt. |
Antwoord | VoorwaardeHet oorspronkelijke verzoek of resultaat is onbekend of moet nagekeken worden. | Volgende stapBewaar de oorspronkelijke identificatoren en headers; raadpleeg enkel ondersteunde statusgegevens of bibliotheekrecords. Dien het aanmaakverzoek niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra kling-v2-1
Aliasnamen voor methodepaden
/v1/videos/generations
Gerelateerde aanroeper-ID’s
FAQ · Kling v2.1
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/videos·kling-v2-1:text,image→video- Welke velden gebruikt het verzoek?
POST /v1/videos·kling-v2-1:model,mode,aspect_ratio,duration,end_image,image,negative_prompt,prompt