kling-3-0
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseKling 3.0 - Pro Pack on RunComfy
Kling 3.0 - RunComfy专业套餐
Kling 3.0 is Kuaishou Technology's third-generation cinematic video model. This skill covers all six Kling 3.0 rendering endpoints on RunComfy: three quality tiers (Standard, Pro, 4K) across two modes (text-to-video and image-to-video).
Kling 3.0是快手科技推出的第三代影视级视频模型。该技能涵盖RunComfy平台上Kling 3.0的全部6个渲染端点:包含三种质量等级(Standard、Pro、4K),每种等级支持文本转视频(text-to-video)和图像转视频(image-to-video)两种模式。
What Kling 3.0 is
Kling 3.0是什么
Kling 3.0 is the V3 generation of the Kling video model. It produces multi-shot cinematic video with synchronized native audio, consistent character identity across shots, and physics-aware motion. Compared to Kling 2.x, Kling 3.0 supports longer clips (up to 15 seconds), native 4K output on the 4K tier, and a unified multi-prompt segment system that lets one Kling 3.0 generation contain several distinct scenes with controlled transitions.
Kling 3.0 ships in three rendering tiers on RunComfy, each available as text-to-video or image-to-video:
- Standard - cheapest tier, up to 1080p output. Use Kling 3.0 Standard for fast iteration, previews, A/B variants, social shorts.
- Pro - highest fidelity at 1080p. Use Kling V3.0 Pro for hero-quality 1080p clips where motion realism and identity preservation matter most.
- 4K - native 3840x2160 output. Use Kling V3.0 4K for high-resolution brand films, big-screen cinematic sequences, and finished masters at native resolution.
All three tiers share the same Kling 3.0 multi-shot architecture. Tiers differ in resolution ceiling, motion-fidelity budget, and pricing.
Kling 3.0是Kling视频模型的第三代版本。它可生成具备原生同步音频、镜头间角色身份一致且物理感知运动效果的多镜头影视级视频。与Kling 2.x版本相比,Kling 3.0支持更长的视频片段(最长15秒),4K等级可输出原生4K分辨率视频,还采用了统一的多提示段系统,让单次Kling 3.0生成任务即可包含多个场景,并支持可控转场。
RunComfy平台上的Kling 3.0提供三种渲染等级,每种等级均支持文本转视频和图像转视频模式:
- Standard - 成本最低的等级,最高输出1080p分辨率。适用于快速迭代、预览、A/B测试版本、社交短视频等场景。
- Pro - 1080p分辨率下的最高画质等级。当需要运动真实感强、角色身份保持精准的核心1080p视频片段时,推荐使用Kling V3.0 Pro。
- 4K - 原生3840x2160分辨率输出。适用于高分辨率品牌影片、大银幕影视片段、原生分辨率的最终成品等场景。
三个等级均采用相同的Kling 3.0多镜头架构,差异主要体现在分辨率上限、运动画质预算和定价上。
The 6 Kling 3.0 endpoints
6个Kling 3.0端点
Each endpoint corresponds to one (tier, mode) pair. All six endpoints share the same Kling 3.0 base model.
| Endpoint | Anchor | Resolution | Rate (no audio) | Rate (with audio) |
|---|---|---|---|---|
| Kling 3.0 Standard t2v | up to 1080p | $0.084/s | $0.126/s |
| Kling 3.0 Standard Image to Video | up to 1080p | $0.084/s | $0.126/s |
| Kling V3.0 Pro Text-to-Video | 1080p | $0.112/s | $0.168/s |
| Kling V3.0 Pro Image-to-Video | 1080p | $0.112/s | $0.168/s |
| Kling V3.0 4K Text-to-Video | 3840x2160 | $0.42/s flat | $0.42/s flat |
| Kling V3.0 4K Image-to-Video | 3840x2160 | $0.42/s flat | $0.42/s flat |
The 4K tier prices the same regardless of audio. Standard and Pro tiers charge ~50% more per second when audio is enabled.
每个端点对应一组(等级,模式)组合,所有6个端点均基于同一Kling 3.0基础模型。
| 端点 | 说明 | 分辨率 | 费率(无音频) | 费率(含音频) |
|---|---|---|---|---|
| Kling 3.0 Standard文本转视频 | 最高1080p | $0.084/秒 | $0.126/秒 |
| Kling 3.0 Standard图像转视频 | 最高1080p | $0.084/秒 | $0.126/秒 |
| Kling V3.0 Pro文本转视频 | 1080p | $0.112/秒 | $0.168/秒 |
| Kling V3.0 Pro图像转视频 | 1080p | $0.112/秒 | $0.168/秒 |
| Kling V3.0 4K文本转视频 | 3840x2160 | 固定$0.42/秒 | 固定$0.42/秒 |
| Kling V3.0 4K图像转视频 | 3840x2160 | 固定$0.42/秒 | 固定$0.42/秒 |
4K等级无论是否启用音频,定价均相同。Standard和Pro等级启用音频后,每秒费率约上涨50%。
When to pick which Kling 3.0 tier
如何选择Kling 3.0等级
Pick a Kling 3.0 tier based on the output's role in the pipeline.
- Drafts, previews, social shorts, A/B variants: Kling 3.0 Standard. Cheapest. Quality is fine for everything except hero shots.
- Hero 1080p clips, ad creative, talking heads with high motion fidelity: Kling V3.0 Pro. About 33% more expensive than Standard for noticeably tighter motion and identity hold at the same resolution.
- 4K brand films, big-screen cinematic, finished masters: Kling V3.0 4K. Native 3840x2160 (no upscale step). Flat $0.42/s makes budgeting predictable. Use only when the output truly needs 4K - it is roughly 5x the cost of Standard.
Pick the mode based on whether you have a source image:
- Text-to-Video (t2v): prompt only, Kling 3.0 generates the look from scratch. Use Kling 3.0 t2v for novel scenes, brand new compositions, environments without an existing reference.
- Image-to-Video (i2v): prompt + source image, Kling 3.0 animates the image. Use Kling 3.0 i2v when you have an exact reference (face, product, scene) that must survive into the output.
If the user explicitly asked for Kling 3.0, Kling V3.0, Kling Pro, or Kling 4K, route to this skill regardless.
根据输出视频在工作流中的作用选择对应的Kling 3.0等级:
- 草稿、预览、社交短视频、A/B测试版本:选择Kling 3.0 Standard。成本最低,除核心镜头外的场景画质均可满足需求。
- 核心1080p片段、广告创意、高运动真实感的对话镜头:选择Kling V3.0 Pro。比Standard贵约33%,但在相同分辨率下,运动效果更流畅,角色身份保持更精准。
- 4K品牌影片、大银幕影视内容、最终成品:选择Kling V3.0 4K。原生3840x2160分辨率(无需 upscale 步骤),固定$0.42/秒的费率让预算更可控。仅当确实需要4K分辨率时使用,其成本约为Standard的5倍。
根据是否有参考图像选择模式:
- 文本转视频(t2v):仅需提示词,Kling 3.0从零生成画面。适用于全新场景、原创构图、无现有参考的环境等场景。
- 图像转视频(i2v):需提示词+参考图像,Kling 3.0将图像动起来。当有必须保留在输出中的精确参考(人脸、产品、场景)时,选择Kling 3.0 i2v。
若用户明确要求使用Kling 3.0、Kling V3.0、Kling Pro或Kling 4K,无论场景如何,均调用该技能。
Prerequisites
前置条件
- RunComfy CLI:
npm i -g @runcomfy/cli - RunComfy account: opens a browser device-code flow.
runcomfy login - CI / containers: set instead of
RUNCOMFY_TOKEN=<token>.runcomfy login - For i2v endpoints: a publicly fetchable source image URL (HTTPS, JPEG/PNG/WebP).
- RunComfy CLI:执行安装
npm i -g @runcomfy/cli - RunComfy账号:执行将打开浏览器设备码登录流程
runcomfy login - CI/容器环境:设置环境变量替代
RUNCOMFY_TOKEN=<token>runcomfy login - 使用i2v端点:需提供可公开访问的HTTPS格式参考图像URL(支持JPEG/PNG/WebP格式)
Input schema (shared across all 6 Kling 3.0 endpoints)
输入 schema(所有6个Kling 3.0端点通用)
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| string | yes | - | Text description of scene, motion, camera, atmosphere. Multi-segment prompts supported via |
| string | yes (i2v only) | - | Source image for Kling 3.0 i2v. HTTPS URL. JPEG/PNG/WebP. |
| string | no (i2v only) | - | Optional ending image for controlled start-to-end frame transition on Kling 3.0 i2v. |
| string | no | - | Elements to exclude from the Kling 3.0 output. |
| int | no | 5 | 3-15 seconds per Kling 3.0 generation. |
| enum | no | | |
| float | no | 0.5 | Prompt guidance strength. Higher = stricter adherence to prompt. |
| bool | no | false | Enable Kling 3.0 in-pass synchronized audio. Adds cost on Standard and Pro tiers; flat-rate on 4K. |
| int | no | - | Reproducibility for Kling 3.0 variant testing. |
| 字段 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| string | 是 | - | 场景、运动、镜头、氛围的文本描述。支持通过 |
| string | 是(仅i2v模式) | - | Kling 3.0 i2v的参考图像,需为HTTPS URL,支持JPEG/PNG/WebP格式。 |
| string | 否(仅i2v模式) | - | 可选的结束图像,用于在Kling 3.0 i2v中实现从起始到结束帧的可控转场。 |
| string | 否 | - | 需要从Kling 3.0输出中排除的元素。 |
| int | 否 | 5 | 单次Kling 3.0生成任务的时长范围为3-15秒。 |
| enum | 否 | | 支持的比例: |
| float | 否 | 0.5 | 提示词引导强度,值越高,输出越严格遵循提示词。 |
| bool | 否 | false | 启用Kling 3.0原生同步音频功能。Standard和Pro等级启用后会增加成本;4K等级为固定费率。 |
| int | 否 | - | 用于Kling 3.0变体测试的可复现参数。 |
How to invoke each Kling 3.0 endpoint
如何调用各Kling 3.0端点
Kling 3.0 Standard text-to-video (cheapest 1080p draft):
bash
runcomfy run kling/kling-3.0/standard/text-to-video \
--input '{
"prompt": "<Kling 3.0 prompt>",
"duration": 5,
"aspect_ratio": "16:9"
}' \
--output-dir <absolute/path>Kling 3.0 Standard image-to-video (animate a still):
bash
runcomfy run kling/kling-3.0/standard/image-to-video \
--input '{
"prompt": "<motion description for Kling 3.0 i2v>",
"image_url": "https://.../source.jpg",
"duration": 5
}' \
--output-dir <absolute/path>Kling V3.0 Pro text-to-video (highest 1080p fidelity):
bash
runcomfy run kling/kling-3.0/pro/text-to-video \
--input '{
"prompt": "<Kling 3.0 Pro prompt>",
"duration": 8,
"aspect_ratio": "16:9",
"generate_audio": true
}' \
--output-dir <absolute/path>Kling V3.0 Pro image-to-video (hero animation from source image):
bash
runcomfy run kling/kling-3.0/pro/image-to-video \
--input '{
"prompt": "<motion description for Kling V3.0 Pro i2v>",
"image_url": "https://.../subject.jpg",
"duration": 8,
"generate_audio": true
}' \
--output-dir <absolute/path>Kling V3.0 4K text-to-video (native 4K cinematic):
bash
runcomfy run kling/kling-3.0/4k/text-to-video \
--input '{
"prompt": "<Kling V3.0 4K prompt>",
"duration": 10,
"aspect_ratio": "16:9",
"generate_audio": true
}' \
--output-dir <absolute/path>Kling V3.0 4K image-to-video (4K animation of a reference image):
bash
runcomfy run kling/kling-3.0/4k/image-to-video \
--input '{
"prompt": "<motion description for Kling V3.0 4K i2v>",
"image_url": "https://.../source-4k.jpg",
"duration": 10,
"generate_audio": true
}' \
--output-dir <absolute/path>The CLI submits the Kling 3.0 request, polls every 2s, fetches the result, and downloads any / URL into .
*.runcomfy.net*.runcomfy.com--output-dirKling 3.0 Standard文本转视频(成本最低的1080p草稿):
bash
runcomfy run kling/kling-3.0/standard/text-to-video \
--input '{
"prompt": "<Kling 3.0提示词>",
"duration": 5,
"aspect_ratio": "16:9"
}' \
--output-dir <绝对路径>Kling 3.0 Standard图像转视频(将静态图动起来):
bash
runcomfy run kling/kling-3.0/standard/image-to-video \
--input '{
"prompt": "<Kling 3.0 i2v的运动描述>",
"image_url": "https://.../source.jpg",
"duration": 5
}' \
--output-dir <绝对路径>Kling V3.0 Pro文本转视频(最高画质的1080p输出):
bash
runcomfy run kling/kling-3.0/pro/text-to-video \
--input '{
"prompt": "<Kling 3.0 Pro提示词>",
"duration": 8,
"aspect_ratio": "16:9",
"generate_audio": true
}' \
--output-dir <绝对路径>Kling V3.0 Pro图像转视频(基于参考图像的核心动画):
bash
runcomfy run kling/kling-3.0/pro/image-to-video \
--input '{
"prompt": "<Kling V3.0 Pro i2v的运动描述>",
"image_url": "https://.../subject.jpg",
"duration": 8,
"generate_audio": true
}' \
--output-dir <绝对路径>Kling V3.0 4K文本转视频(原生4K影视级输出):
bash
runcomfy run kling/kling-3.0/4k/text-to-video \
--input '{
"prompt": "<Kling V3.0 4K提示词>",
"duration": 10,
"aspect_ratio": "16:9",
"generate_audio": true
}' \
--output-dir <绝对路径>Kling V3.0 4K图像转视频(参考图像的4K动画):
bash
runcomfy run kling/kling-3.0/4k/image-to-video \
--input '{
"prompt": "<Kling V3.0 4K i2v的运动描述>",
"image_url": "https://.../source-4k.jpg",
"duration": 10,
"generate_audio": true
}' \
--output-dir <绝对路径>CLI会提交Kling 3.0请求,每2秒轮询一次状态,任务完成后获取结果,并将所有 / 链接的内容下载到指定的目录中。
*.runcomfy.net*.runcomfy.com--output-dirPrompting Kling 3.0 - what works
Kling 3.0提示词技巧
Kling 3.0 responds to specific prompting patterns better than naive prose.
Lead with motion and camera language. Kling 3.0 reads "wide shot, slow push-in", "tracking shot, low angle", "handheld follow" as real directives. Front-load these.
Multi-shot in one Kling 3.0 generation. A single Kling 3.0 prompt can describe a sequence of shots. Number them: "Shot 1: wide of the cafe at dusk. Shot 2: medium close-up of the barista. Shot 3: tight on the espresso pour." Kling 3.0 will preserve identity (face, wardrobe, props) across the shots.
Identity anchors for i2v. When using Kling 3.0 i2v, restate what should remain stable: "preserve the subject's face, pose, and clothing; only the camera moves and the background changes."
tail_image_urlgenerate_audio: truecfg_scaleAnti-patterns:
- Conflicting style cues in one Kling 3.0 prompt -> simplify, pick one or two style anchors.
- Asking for greater than 15 seconds in one Kling 3.0 call -> 422 error; segment the script and stitch.
- Aspect ratios outside the supported set -> rejected.
- For Kling V3.0 4K, demanding aggressive multi-shot story plus 15s plus dialogue plus 6 cuts -> Kling 3.0 will deliver, but cost climbs to about $6.30 per generation. Validate with Standard first.
Kling 3.0对特定提示词模式的响应优于普通描述性文本。
以运动和镜头语言开头:Kling 3.0会将“广角镜头,缓慢推近”、“跟拍镜头,低角度”、“手持跟随”等指令视为明确要求,建议将这类内容放在提示词开头。
单次生成多镜头内容:单个Kling 3.0提示词可描述一系列镜头,只需给镜头编号:“镜头1:黄昏时分咖啡馆的广角画面。镜头2:情侣碰杯的中景双人镜头。镜头3:浓缩咖啡流出的特写镜头。”Kling 3.0会在各镜头间保持角色身份(人脸、服装、道具)一致。
i2v模式的身份锚点:使用Kling 3.0 i2v时,明确说明需要保留的稳定元素:“保留主体的面部、姿势和服装;仅镜头移动,背景变化。”
使用实现可控结尾:在Kling 3.0 i2v模式下,提供结尾图像可锁定最终帧,Kling 3.0会生成从起始图像到结尾图像的过渡动画。
tail_image_url启用实现一站式音频生成:在提示词中描述需要的音频内容:“温暖友好的语气,英文旁白”或“城市环境音,远处车流声,无对话”。Standard/Pro等级启用音频会增加成本;4K等级为固定费率。
generate_audio: true调整参数:默认值0.5适用于大多数Kling 3.0提示词。若需要风格化输出严格遵循提示词,可将值提高到0.7-0.9;若提示词较宽泛,需要自然运动效果,可将值降低到0.3-0.4。
cfg_scale避坑指南:
- 单个Kling 3.0提示词中包含冲突的风格线索 -> 简化提示词,选择1-2个风格锚点。
- 单次Kling 3.0调用请求时长超过15秒 -> 会返回422错误;需将脚本分段后再拼接。
- 使用不支持的宽高比 -> 请求会被拒绝。
- Kling V3.0 4K模式下,同时要求复杂多镜头故事、15秒时长、对话和6次转场 -> Kling 3.0可完成,但单次生成成本约为$6.30;建议先用Standard等级验证效果。
Where Kling 3.0 shines
Kling 3.0优势场景
| Use case | Best Kling 3.0 endpoint |
|---|---|
| Cinematic 1080p brand stories with consistent characters | Kling V3.0 Pro (t2v or i2v) |
| Native 4K hero films and big-screen cinematic | Kling V3.0 4K (t2v or i2v) |
| Cheap iteration, social-first shorts, A/B variants | Kling 3.0 Standard t2v |
| Animating brand assets, product photos, character art | Kling 3.0 Standard i2v or Kling V3.0 Pro i2v |
| Multi-shot ads with synchronized dialogue in one pass | Kling V3.0 Pro with |
| Premium 4K finished masters with native audio | Kling V3.0 4K with |
| 使用场景 | 推荐Kling 3.0端点 |
|---|---|
| 角色身份一致的1080p影视级品牌故事 | Kling V3.0 Pro(文本转视频或图像转视频) |
| 原生4K核心影片和大银幕影视内容 | Kling V3.0 4K(文本转视频或图像转视频) |
| 低成本迭代、社交优先短视频、A/B测试版本 | Kling 3.0 Standard文本转视频 |
| 品牌资产、产品照片、角色插画的动画制作 | Kling 3.0 Standard图像转视频或Kling V3.0 Pro图像转视频 |
| 一站式生成带同步对话的多镜头广告 | 启用 |
| 带原生音频的4K最终成品 | 启用 |
Sample Kling 3.0 prompts
Kling 3.0提示词示例
Kling 3.0 cinematic multi-shot (Pro tier recommended):
Cinematic multi-shot of a young American couple celebrating their
anniversary at a candlelit rooftop restaurant. Shot 1: wide of the
city skyline at golden hour. Shot 2: medium two-shot, the couple
toasting. Shot 3: tight on the woman's smile, soft bokeh, warm fill
light. Subtle ambient string music, gentle wind, distant traffic.Kling 3.0 i2v (animate a portrait, 4K tier):
Gentle camera dolly-in on the subject from the source image. Subtle
breathing motion, identity-stable features, soft natural light,
shallow depth of field. Background: warm golden-hour glow with a
slow drift of dust motes. No dialogue, only ambient room tone.Kling 3.0 vertical short (Standard tier, 9:16):
9:16 vertical. A barista in a black apron pulls a single espresso
shot, steam rising into morning sun, rich crema slowly forming.
Close-up handheld, shallow depth of field, warm cafe ambience and
the hiss of the steam wand.Kling 3.0影视级多镜头(推荐Pro等级):
一对年轻美国情侣在烛光屋顶餐厅庆祝周年纪念日的影视级多镜头内容。镜头1:黄金时段城市天际线的广角画面。镜头2:情侣碰杯的中景双人镜头。镜头3:女士微笑的特写,柔和焦外成像,温暖补光。轻柔的环境弦乐,微风,远处车流声。Kling 3.0图像转视频(肖像动画,4K等级):
镜头从参考图像中的主体缓慢推进。轻微的呼吸动作,身份特征稳定,柔和自然光,浅景深。背景:温暖的黄金时段光晕,尘埃缓慢飘动。无对话,仅环境音。Kling 3.0竖屏短视频(Standard等级,9:16比例):
9:16竖屏画面。穿黑色围裙的咖啡师制作一杯浓缩咖啡,蒸汽在晨光中升起,浓郁的油脂慢慢形成。手持特写,浅景深,温暖的咖啡馆环境音和蒸汽棒的嘶嘶声。Kling 3.0 FAQ
Kling 3.0常见问题
What is the maximum duration of a Kling 3.0 clip? 15 seconds per generation across all three tiers. For longer narratives, segment the script into multiple Kling 3.0 calls and stitch.
How is Kling V3.0 4K priced compared to Standard and Pro? Kling V3.0 4K is a flat $0.42 per second whether or not audio is enabled. Standard is $0.084/s without audio (cheapest). Pro is $0.112/s without audio. The 4K tier costs roughly 5x Standard for the resolution upgrade.
Does Kling 3.0 support multi-shot in a single generation? Yes. All Kling 3.0 endpoints accept multi-segment prompts. Number the shots ("Shot 1:", "Shot 2:", etc.) and Kling 3.0 will preserve character identity across them.
Can Kling 3.0 generate audio? Yes. Set . Kling 3.0 produces synchronized dialogue, ambient sound, and music in the same generation pass. On 4K the price stays flat at $0.42/s; on Standard / Pro the rate jumps about 50% with audio.
generate_audio: trueWhat aspect ratios does Kling 3.0 support? 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. The 4K tier renders 21:9 as wide cinema crops at native 3840x2160.
Does Kling 3.0 i2v support a tail image? Yes. locks the final frame; Kling 3.0 interpolates motion from source to tail.
tail_image_urlHow is Kling 3.0 different from Kling 2.x? Kling 3.0 has stronger multi-shot identity preservation, longer max duration (15s vs 10s on the 2.x flagship), native 4K on the 4K tier, and unified multi-prompt segment input across all tiers.
Kling 3.0单段视频的最长时长是多少? 所有等级单次生成的最长时长均为15秒。若需要更长的叙事内容,需将脚本分段为多个Kling 3.0任务,之后再拼接。
Kling V3.0 4K的定价与Standard、Pro有何区别? Kling V3.0 4K无论是否启用音频,均为固定$0.42/秒。Standard等级无音频时为$0.084/秒(成本最低),Pro等级无音频时为$0.112/秒。4K等级的分辨率升级成本约为Standard的5倍。
Kling 3.0支持单次生成多镜头内容吗? 支持。所有Kling 3.0端点均接受多段提示词。给镜头编号(“镜头1:”、“镜头2:”等),Kling 3.0会在各镜头间保持角色身份一致。
Kling 3.0可以生成音频吗? 可以。设置即可。Kling 3.0可在同一次生成任务中同步生成对话、环境音和音乐。4K等级启用音频后费率保持固定;Standard/Pro等级启用后费率约上涨50%。
generate_audio: trueKling 3.0支持哪些宽高比? 支持16:9、9:16、1:1、4:3、3:4、21:9。4K等级的21:9比例会以原生3840x2160分辨率裁剪为宽屏影视格式。
Kling 3.0图像转视频支持结尾图像吗? 支持。可锁定最终帧,Kling 3.0会生成从起始图像到结尾图像的过渡动画。
tail_image_urlKling 3.0与Kling 2.x有何区别? Kling 3.0的多镜头角色身份保持能力更强,最长时长更长(2.x旗舰版为10秒,3.0为15秒),4K等级支持原生4K输出,且所有等级均采用统一的多提示段输入系统。
Limitations
限制条件
- Per-call duration cap 15 seconds on every Kling 3.0 tier.
- Maximum 6 continuous shots in one Kling 3.0 4K generation.
- i2v requires a publicly fetchable HTTPS image URL. Local files are not supported.
- Aspect ratios are fixed to the documented six. Other ratios get cropped or rejected.
- 4K output files are large. Plan disk and bandwidth before batch Kling V3.0 4K runs.
- 所有Kling 3.0等级单次调用时长上限为15秒。
- 单次Kling 3.0 4K生成任务最多支持6个连续镜头。
- 图像转视频模式需要可公开访问的HTTPS图像URL,不支持本地文件。
- 宽高比固定为文档中列出的6种,其他比例会被裁剪或拒绝。
- 4K输出文件体积较大,批量运行Kling V3.0 4K任务前需规划好磁盘空间和带宽。
Exit codes
退出代码
The CLI uses sysexits-style codes:
runcomfy| code | meaning |
|---|---|
| 0 | Kling 3.0 generation succeeded |
| 64 | bad CLI args |
| 65 | bad input JSON for Kling 3.0 / schema mismatch |
| 69 | upstream 5xx |
| 75 | retryable: timeout / 429 |
| 77 | not signed in or token rejected |
Full reference: docs.runcomfy.com/cli/troubleshooting.
runcomfy| 代码 | 含义 |
|---|---|
| 0 | Kling 3.0生成任务成功 |
| 64 | CLI参数错误 |
| 65 | Kling 3.0输入JSON错误/schema不匹配 |
| 69 | 上游服务5xx错误 |
| 75 | 可重试错误:超时/429限流 |
| 77 | 未登录或令牌被拒绝 |
How it works
工作原理
- The skill picks one of six Kling 3.0 endpoints based on the user's tier (Standard / Pro / 4K) and mode (t2v / i2v) intent.
- It invokes with a JSON body matching the schema.
runcomfy run kling/kling-3.0/<tier>/<mode> - The CLI POSTs to the RunComfy Model API with the user's bearer token.
- The Model API returns a ; the CLI polls every 2 seconds until the Kling 3.0 generation finishes.
request_id - On terminal status, the CLI fetches the Kling 3.0 result and downloads any /
.runcomfy.netURL into.runcomfy.com.--output-dir - cancels the in-flight Kling 3.0 request before billing.
Ctrl-C
- 技能根据用户的等级(Standard/Pro/4K)和模式(文本转视频/图像转视频)意图,选择6个Kling 3.0端点中的一个。
- 调用命令,并传入符合schema的JSON参数。
runcomfy run kling/kling-3.0/<tier>/<mode> - CLI使用用户的Bearer令牌向RunComfy模型API发送POST请求。
- 模型API返回,CLI每2秒轮询一次,直到Kling 3.0生成任务完成。
request_id - 任务完成后,CLI获取Kling 3.0生成结果,并将所有/
.runcomfy.net链接的内容下载到.runcomfy.com指定的目录中。--output-dir - 按下可取消正在进行的Kling 3.0请求,避免产生费用。
Ctrl-C
Security & Privacy
安全与隐私
- Token storage: writes the API token to
runcomfy loginwith mode 0600. Set~/.config/runcomfy/token.jsonenv var in CI / containers.RUNCOMFY_TOKEN - Input boundary: the Kling 3.0 prompt is passed as JSON via . The CLI does not shell-expand. No shell-injection surface.
--input - Third-party content: image URLs you pass are fetched by the RunComfy server, not by the CLI on your machine. Treat external URLs as untrusted; image-based prompt injection is a known risk for any video model that accepts image inputs.
- Outbound endpoints: only (request submission) and
model-api.runcomfy.net/*.runcomfy.net(download whitelist).*.runcomfy.com - Generated-file size cap: the CLI aborts any single download greater than 2 GiB to prevent disk-fill from a runaway Kling 3.0 4K output.
- 令牌存储:会将API令牌写入
runcomfy login,权限为0600。在CI/容器环境中可设置环境变量~/.config/runcomfy/token.json替代登录。RUNCOMFY_TOKEN - 输入边界:Kling 3.0提示词通过以JSON格式传递,CLI不会进行shell展开,不存在shell注入风险。
--input - 第三方内容:你传入的图像URL由RunComfy服务器获取,而非本地CLI。请谨慎处理外部URL,基于图像的提示词注入是所有接受图像输入的视频模型的已知风险。
- 出站端点:仅允许访问(请求提交)和
model-api.runcomfy.net/*.runcomfy.net(下载白名单)。*.runcomfy.com - 生成文件大小限制:若单个下载文件超过2 GiB,CLI会终止下载,避免失控的Kling 3.0 4K输出占满磁盘空间。