mcpField
K
kie-ai

kie-ai

github.com/thepexcel创意与媒体39 次安装
代码仓库

关于 kie-ai

通过 Kie.ai REST API 生成图像和视频的技能，涵盖 Grok Imagine 与 Veo3 模型。它说明任务创建、状态轮询、文件上传下载及批量生成注意事项，面向创意制作流程。

主要功能

  1. 01Grok Imagine 图像生成
  2. 02Veo3 视频生成
  3. 03任务状态轮询
  4. 04图像上传与结果下载
  5. 05批量生成指引

适用场景

  1. 01根据文本提示生成图像
  2. 02调整参考图像的风格或内容
  3. 03根据文本或上传图像生成视频
  4. 04并行提交多个生成请求

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/thepexcel/agent-skills --skill kie-ai

安装后在 Claude Code 中输入/kie-ai确认已加载。

详细介绍

kie-ai — 通过 Kie.ai API 使用 Grok Imagine

通过 Kie.ai REST API 生成图像/视频 — Grok Imagine 模型代理

路径快捷方式

OUT    = D:/ClaudeMediaGen/output-fal   # ใช้ร่วมกับ fal output
BASE   = https://api.kie.ai/api/v1/jobs

环境变量

变量位置读取方式
KIE_API_KEYWindows 用户环境变量os.environ["KIE_API_KEY"]（通过 setx 或 [Environment]::SetEnvironmentVariable 设置）

模型选择

模型 ID类型最适合输出
grok-imagine/text-to-imagetext2img美观/电影感图像，能很好地处理泰语提示词每个请求 3 张图
grok-imagine/image-to-imageimg2img编辑/调整参考图的风格TBD
grok-imagine/image-to-videoimg2vid根据静态图像生成视频TBD
grok-imagine/upscaleupscale提高视频分辨率TBD
veo3_fastvideo快速视频，支持 i2v（REFERENCE_2_VIDEO）视频 + 音频
veo3_qualityvideo最高质量视频视频 + 音频
veo3_litevideo最经济的视频视频 + 音频

注意： 已测试 text-to-image + veo3_fast，可正常使用；其他模型虽然在文档中列出，但尚未测试。 Veo3 使用不同的 endpoint — 请查看下方的“Veo3 Video Generation”和“API Endpoints Summary”部分。

宽高比

值用途
2:3纵向（人物图像的默认值）
3:2横向
1:1正方形
16:9宽屏电影画幅
9:16Story/Reels 格式

API 流程 — 3 个步骤

1. 创建任务
POST {BASE}/createTask
Authorization: Bearer <KIE_API_KEY>
Content-Type: application/json

Body:
{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "...",
    "aspect_ratio": "2:3"
  }
}

Response: { "code": 200, "data": { "taskId": "..." } }
  • 先检查 code == 200，否则表示出错
  • 保存 taskId 用于轮询
2. 轮询任务状态
GET {BASE}/recordInfo?taskId=<taskId>
Authorization: Bearer <KIE_API_KEY>

任务状态：

状态含义操作
waiting正在排队继续等待
queuing正在排队继续等待
generating正在生成继续等待
success已完成获取 URL
fail失败读取 failMsg + failCode

轮询策略： 每 5 秒一次，超时 5 分钟（60 轮）

成功时：

  • data.resultJson 是 JSON 字符串 → 需要再次解析
  • 其中包含 resultUrls: [url1, url2, url3] — 每个请求可获得 3 张图
3. 下载图像

重要： URL 请求必须添加特殊 headers，否则会被拦截

Headers สำหรับ download:
  User-Agent: Mozilla/5.0
  Referer: https://kie.ai/

命名约定：

kie_grok_{taskId_last8}_{index}.jpg

输出目录： D:/ClaudeMediaGen/output-fal/

提示词规则

Grok 提示词语法规则已移至共享的 model-card。 请参阅 grok-image.md，了解：

  • 混合提示词策略（英语 + 泰语）
  • 禁用词
  • 主体简短 / 场景较长规则
  • 禁止描述身材

实现指南

使用 Python 创建生成脚本
  1. 读取 API key，使用 os.environ["KIE_API_KEY"]（Windows 用户环境变量 — 全机只需设置一次）
  2. 创建任务 → POST /createTask → 保存 taskId
  3. 轮询 → GET /recordInfo?taskId= → 每隔 5 秒循环一次，直到状态为 success 或 fail
  4. 解析结果 → data.resultJson 是字符串 → json.loads() → resultUrls
  5. 下载 → 添加 User-Agent + Referer headers → 保存为 .jpg
  6. 创建对应的 .txt 文件 → 每次都将提示词文本与图像保存在一起（以便追溯）
批量生成
  • 可以同时发送多个请求（测试中未遇到 rate limit）
  • 每个请求可获得 3 张图 → 10 个请求 = 30 张图
  • 在 Claude Code 中并行生成时使用 run_in_background: true
错误处理
  • createTask 返回 code != 200 → 显示完整 response
  • state == "fail" → 读取 data.failMsg + data.failCode
  • 轮询期间发生 Network error → 直接重试，无需重新创建任务
  • 下载失败 → 添加 headers 后重试

费用

  • 暂无 Kie.ai 每个请求的费用数据 — 批量生成前务必先预览

规则

  • 批量生成前先预览 — 先生成 1 个请求（获得 3 张图），查看质量后再继续生成
  • 禁止 Read 已生成的图像 — 会占用大量 context，只需告知文件路径
  • 始终创建对应的 .txt 文件 — 每次都将提示词文本与图像一起保存
  • 禁止 Read 后台任务的输出文件 — 发出生成指令后立即结束

文件上传 API（已测试）

在提交 gen 之前上传文件（例如，用于 image-to-video 的图片）

POST https://kieai.redpandaai.co/api/file-stream-upload
Authorization: Bearer <KIE_API_KEY>
Content-Type: multipart/form-data

Parameters:
  file: (binary)
  uploadPath: (string)
  fileName: (string)

Response:
{
  "success": true,
  "data": {
    "downloadUrl": "https://tempfile.redpandaai.co/..."
  }
}

注意：

  • 只能使用 curl multipart（base64 上传会返回 403）
  • 文件会在 3 天后自动删除
  • 使用 image-to-video（Veo3 REFERENCE_2_VIDEO）前必须先上传

Veo3 视频生成（已测试）

Veo3 使用与 Market API（Grok Imagine）不同的 endpoint——生成和轮询都不同

创建任务
POST https://api.kie.ai/api/v1/veo/generate
Authorization: Bearer <KIE_API_KEY>
Content-Type: application/json

Body:
{
  "prompt": "...",
  "imageUrls": ["https://uploaded-url"],
  "model": "veo3_fast",
  "generationType": "REFERENCE_2_VIDEO",
  "aspect_ratio": "9:16"
}
Parameter值备注
modelveo3_fast、veo3_quality、veo3_litefast 支持 i2v
generationTypeTEXT_2_VIDEO、REFERENCE_2_VIDEOREFERENCE_2_VIDEO 仅适用于 veo3_fast
aspect_ratio16:9、9:16、Auto—
imageUrlsURL 数组必须先通过 file-stream-upload 上传

可选项：enableTranslation、enableFallback、watermark、callBackUrl、seeds

轮询状态
GET https://api.kie.ai/api/v1/veo/record-info?taskId=<taskId>
Authorization: Bearer <KIE_API_KEY>
字段值含义
successFlag0正在生成
successFlag1成功
successFlag2失败
successFlag3失败
  • 视频 URL 位于 data.response.resultUrls[]
  • 包含音频（hasAudioList: [true]）
  • 大约需要 60-120 秒
Veo3 流程：上传 → 生成 → 轮询
1. Upload image  → POST file-stream-upload → ได้ downloadUrl
2. Generate      → POST /veo/generate (ใส่ downloadUrl ใน imageUrls) → ได้ taskId
3. Poll          → GET /veo/record-info?taskId= → วน loop จน successFlag != 0
4. Download      → ดึง video จาก resultUrls[]

API Endpoint 汇总

功能Market API（Grok Imagine）Veo3 API
创建任务POST /api/v1/jobs/createTaskPOST /api/v1/veo/generate
轮询状态GET /api/v1/jobs/recordInfoGET /api/v1/veo/record-info
文件上传POST kieai.redpandaai.co/api/file-stream-upload（相同）
Base URLhttps://api.kie.aihttps://api.kie.ai

相关技能

  • /art-engine - 上游：模型选择和提示词语法转换
  • /fal-ai - Grok 的替代执行路径（相同模型，不同 API - fal.ai 直连 vs Kie.ai 代理）
  • /art-director - 上游：创意简报撰写
  • /sira-image-prefer - 用于提示词偏好的品味 DNA

评论

支持 Markdown