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.
", "aboutText": "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.\n\nFor 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.\n\nFor 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.\n\nPlan 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.\n\nThe 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.\n\nDescribe 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.\n\nInspect 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.\n\nKeep 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2cb5e3607c429bbb0879f85668c8712db84247d829b51d4a383c2cef04d50575", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "kling-v2-1-masterKling 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.
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.
POST /v1/videostextvideo| 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— |
| 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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
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.
| 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 |
| 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. |
Ailoot Ultra kling-v2-1-master
/v1/videos/generations