跳转至

Kie AI

OpenClaw 包含捆绑的 kie 插件，默认启用，用于 Kie AI 视频生成。

属性 值
提供商 ID kie
认证环境变量 KIE_API_KEY
引导标志 --auth-choice kie-api-key
直接 CLI 标志 --kie-api-key <key>
基础 URL https://api.kie.ai
默认模型 kie/kling-2.6/text-to-video

设置

运行引导或设置环境变量：

openclaw onboard --auth-choice kie-api-key

export KIE_API_KEY="example-kie-key-not-real"

视频生成

Kie 支持文生视频和图生视频，每个请求生成一个视频。 使用完整的 kie/<model> 引用选择模型：

系列 文生视频模型 图生视频模型
Grok Imagine grok-imagine/text-to-video grok-imagine/image-to-video
Hailuo 02 hailuo/02-text-to-video-standard hailuo/02-image-to-video-standard
Hailuo 02 Pro hailuo/02-text-to-video-pro hailuo/02-image-to-video-pro
Hailuo 2.3 - hailuo/2-3-image-to-video-standard
Hailuo 2.3 Pro - hailuo/2-3-image-to-video-pro
Kling 2.6 kling-2.6/text-to-video（默认） kling-2.6/image-to-video
Seedance 1.5 Pro bytedance/seedance-1.5-pro bytedance/seedance-1.5-pro
Wan 2.6 wan/2-6-text-to-video wan/2-6-image-to-video

对于成对模型，添加一张参考图像会自动切换到 匹配的图生视频模型；省略它则选择文生视频 模型。Hailuo 2.3 模型始终需要图像。Seedance 在两种模式下使用相同的 模型 ID。

系列 时长（秒） 分辨率控制 音频开关
Grok Imagine 6–30 480P、720P、1080P 否
Hailuo 02 6 或 10 图像模式：512P、768P 否
Hailuo 02 Pro 由提供商管理 由提供商管理 否
Hailuo 2.3 / Pro 6 或 10 768P、1080P（1080P 需要 6 秒） 否
Kling 2.6 5 或 10 由提供商管理 是
Seedance 1.5 Pro 4–12 480P、720P、1080P 是
Wan 2.6 5、10 或 15 720P、1080P 否

宽高比控制可用于仅文本的 Kling 和 Grok 模型， 以及 Seedance 的两种模式。运行 video_generate action=list 查看该模型 支持的控制项。Kling 和 Seedance 默认不生成音频。

参考图像可以是远程 HTTP(S) URL 或本地文件。OpenClaw 通过 Kie 的 base64 文件上传 API 上传本地图像，并将返回的 URL 传递给生成。此初始插件支持一张最大 10 MB 的图像：Kling 支持 JPEG 或 PNG；其他模型支持 JPEG、PNG 或 WebP。 不支持视频到视频和音频参考输入。

设置默认视频模型：

{
  agents: {
    defaults: {
      mediaModels: {
        video: {
          primary: "kie/kling-2.6/text-to-video",
        },
      },
    },
  },
}

Kie 任务可能需要几分钟。OpenClaw 会轮询直到完成， 默认最多等待 10 分钟。必要时使用 agents.defaults.mediaModels.video.timeoutMs 覆盖此设置。即使 Kie 返回 HTTP 200， 也会显示提供商错误消息。

Veo 尚未包含在内；其专用 API 和市场 API 契约需要在 添加支持之前对齐。

实时测试

共享视频冒烟测试支持 Kie。请为提供商队列预留时间：

OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS=600000 \
  pnpm test:live:media video --video-providers kie

设置 OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 以同时测试本地 图像上传和图生视频生成。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw