Kling v2.1 Master
Kling v2.1 Master generates video from text or an image-led brief. Use it for a defined visual event, with the subject, action, camera direction and ending planned as one coherent short shot.
About the model
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
Kling v2.1 Master is a Kling video edition with text-to-video and image-to-video capability in the documented model catalogue. Choose a written scene brief when developing a visual idea from text, or an image-led brief when the subject and composition are already established. In both cases, define the event the finished shot should show.
For text-led creation, describe the subject, setting and action in a clear order. A dancer crossing a studio, a vehicle moving beneath trees or a glass object catching changing light each gives the sequence a specific purpose. Include the details that determine the scene’s appearance and keep them consistent throughout the brief.
For image-led creation, prepare a reference that shows the features the shot needs to preserve. Keep faces, object edges and distinctive materials visible. Describe what changes from that starting view: the subject’s gesture, an environmental movement or the camera’s position. Keep the source image available when reviewing the result.
Plan the action around its ending. A person setting down an object should finish with that object in an identifiable place; a reveal should end with the important feature visible. This makes it easier to select an edit point and to assess whether the movement has fulfilled its purpose.
The documented model entry includes five- and ten-second durations, std and pro modes, and landscape, portrait and square frame shapes. Choose the controls available in the selected workflow and retain their actual values. Evaluate the resulting clip against the intended action and framing rather than against the model’s edition name.
Describe subject and camera motion separately. For a tracking shot, state which subject the camera follows and which parts of the environment should pass through the frame. For a fixed shot, state the movement that takes place within it. Keep the camera direction tied to what the viewer needs to notice.
Inspect the whole sequence for continuity. Check that the important subject remains recognizable, that interactions are spatially coherent and that the timing leaves room for the intended cut. Watch changes in hands, faces, surface details and overlapping objects. Judge the motion as well as the strongest individual frame.
Keep each completed video with its prompt, reference and settings. Use the same brief when comparing a scene across editions, and record the actual visual differences. When correcting a candidate, describe the observed problem and revise the instruction connected to it while retaining the useful scene elements.
Ailoot Ultra · Video POST /v1/videos kling-v2-1-master
kling-v2-1-masterOverview
Kling v2.1 Master generates video from text or an image-led brief. Use it for a defined visual event, with the subject, action, camera direction and ending planned as one coherent short shot.
- Accepted inputs
- Text
- Results
- Video
Available in Ailoot · inputs & methods
Ailoot Ultra · Video POST /v1/videos
- Input types
text- Output types
video
| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits kling-v2-1-master Conditions: Use this exact Ailoot routing selector. | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits Maximum length: 500 Conditions: | Default— |
Fieldmode | Typestring | RequirementRequired | Values & limits std, pro Conditions: | Default— |
Fieldmodel_name | Typestring | RequirementOptional | Values & limits Conditions: Optional native override. Omit it to use the selected model automatically; an explicit value is preserved. | Default— |
Fieldcfg_scale | Typenumber | RequirementOptional | Values & limits Minimum: 0 Maximum: 1 Conditions: | Default— |
Fieldaspect_ratio | Typestring | RequirementOptional | Values & limits Conditions: | Default— |
Fieldnegative_prompt | Typestring | RequirementOptional | Values & limits Maximum length: 200 Conditions: | Default— |
Fieldduration | Typeinteger | RequirementOptional | Values & limits 5, 10 Conditions: | Default— |
Method parameters and lifecycle
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, mode |
Parameteroptional | Contractmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractUse this exact Ailoot routing selector., Optional native override. Omit it to use the selected model automatically; an explicit value is preserved. |
Method aliases: /v1/videos/generations
Lifecycle: 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}
Pricing
How the final charge is calculated
The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.
Tariff references do not add request options. Supported parameters are listed for the selected method.
- Fast mode
- Not specified When fast mode is selected
- Flex mode
- Not specified When flex mode is selected
- Maximum reasoning effort
- Not specified When maximum reasoning effort uses the default adjustment
Estimated rates for comparison
Prices by configuration
Match each charge to the conditions shown. Use one rate for each set of alternative configurations.
| Configuration | Rate schedule | Forecast quantity | Charge |
|---|---|---|---|
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only — / 1K tokens Output · Output tokens · Estimate for comparison only — / 1K tokens Input · Cache read · Estimate for comparison only — / 1K tokens Input · Cache write · Estimate for comparison only — / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only — / 1K tokens |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Output · Estimated generation cost · Estimate for comparison only $6 estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
Example requests
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
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
Receive and save results
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}
Keep all completed results
Save every completed video or returned file; retrieve every actual returned asset URL.
Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.
If the original response needs checking
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Response fields
| Field | Type |
|---|---|
Fieldid | Typestring |
Fieldpolling_url | Typestring |
Fieldprovider_task_id | Typestring |
Fielddata.task_id | Typestring |
Fielddata.task_status | Typestring |
Fielddata.task_result.videos[].url | Typestring |
Errors and next steps
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionA required field, model selector, type or input representation is invalid. | Next stepInspect the returned validation detail before preparing a separate request. |
Response | ConditionThe original request or result is unknown or requires a check. | Next stepKeep original identifiers and headers; read only supported status/library records. Do not submit creation again. |
Aliases
Model aliases
Ailoot Ultra kling-v2-1-master
Method path aliases
/v1/videos/generations
Related caller IDs
FAQ · Kling v2.1 Master
- What inputs and results are available?
POST /v1/videos·kling-v2-1-master:text→video- Which fields does the request use?
POST /v1/videos·kling-v2-1-master:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- What limits apply?
POST /v1/videos·kling-v2-1-master:prompt.maximum_length:500;cfg_scale.minimum:0;cfg_scale.maximum:1;negative_prompt.maximum_length:200