SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场kie-ai

kie-ai

设计与创作

查看项目

更新于 10-16 08:52

技能介绍

kie-ai 是一个通过 Kie.ai API 代理执行 Grok Imagine 图像与视频生成的技能，适用于 Claude Code 工作流。它接收来自上游 /art-tech-engineer 的 prompt，并调用 Kie.ai 的 REST API 完成生成任务。

用途

该技能的核心用途是利用 Kie.ai 作为代理来调用 Grok Imagine 系列模型，实现文生图、图生图、图生视频、视频放大，以及 Veo3 视频生成。它属于上游创意流程的下游执行环节，与 /art-director、/art-engineer 等技能协作。

主要能力

技能支持以下模型：

  • grok-imagine/text-to-image：文生图，适合美学/电影感图像，对泰语 prompt 支持良好，每次请求输出 3 张图。
  • grok-imagine/image-to-image：图生图，用于修改或调整参考图风格（输出规格暂未提供）。
  • grok-imagine/image-to-video：图生视频，从静图生成视频（输出规格暂未提供）。
  • grok-imagine/upscale：视频放大，提升分辨率（输出规格暂未提供）。
  • veo3_fast：视频生成，速度较快，支持 i2v（REFERENCE_2_VIDEO），输出视频与音频。
  • veo3_quality：最高质量视频，输出视频与音频。
  • veo3_lite：最经济的视频方案，输出视频与音频。

据资料，text-to-image 与 veo3_fast 已实测可用，其他模型在文档中存在但未经测试。支持的长宽比包括 2:3（人像默认）、3:2、1:1、16:9、9:16。

使用方式

运行流程分为三步：

  1. 创建任务：向 POST /api/v1/jobs/createTask 发送请求，携带 Bearer 令牌与 JSON body，包含 model 与 input（prompt、aspect_ratio）。响应返回 taskId，需先确认 code == 200。
  2. 轮询状态：通过 GET /api/v1/jobs/recordInfo?taskId=<taskId> 查询，状态包括 waiting、queuing、generating、success、fail。建议每 5 秒轮询一次，超时 5 分钟（60 轮）。成功时 data.resultJson 是 JSON 字符串，需再次解析，其中的 resultUrls 包含 3 个图片 URL。
  3. 下载：下载 URL 需带特殊 headers（User-Agent: Mozilla/5.0，Referer: https://kie.ai/），否则会被拦截。文件命名格式为 kie_grok_{taskId_last8}_{index}.jpg，输出目录为 D:/ClaudeMediaGen/output-fal/。

API 密钥通过环境变量 KIE_API_KEY 读取，使用 os.environ["KIE_API_KEY"]，在 Windows 用户环境变量中通过 setx 或 [Environment]::SetEnvironmentVariable 设置一次即可全局使用。

实现指南要求用 Python 编写生成脚本，依次执行创建、轮询、解析、下载，并每次都生成配套 .txt 文件保存 prompt 文本以便追溯。支持批量生成，可同时发送多个请求（资料显示未遇到 rate limit），每个请求产出 3 张图，10 个请求即 30 张图，在 Claude Code 中可用 run_in_background: true 做并行生成。

文件上传与 Veo3

文件上传使用 POST https://kieai.redpandaai.co/api/file-stream-upload，需 multipart/form-data，参数为 file、uploadPath、fileName，响应返回 downloadUrl。注意必须用 curl multipart，base64 上传会返回 403；文件 3 天后自动删除。使用 image-to-video（Veo3 REFERENCE_2_VIDEO）前必须上传图片。

Veo3 使用独立端点：生成用 POST https://api.kie.ai/api/v1/veo/generate，轮询用 GET https://api.kie.ai/api/v1/veo/record-info?taskId=<taskId>。generate 参数包括 prompt、imageUrls、model、generationType（TEXT_2_VIDEO 或 REFERENCE_2_VIDEO，后者仅 veo3_fast 支持）、aspect_ratio（16:9、9:16、Auto），可选 enableTranslation、enableFallback、watermark、callBackUrl、seeds。轮询字段 successFlag：0 生成中，1 成功，2 失败，3 失败。视频 URL 在 data.response.resultUrls[]，带音频，约需 60-120 秒。Veo3 流程为：上传 → 生成 → 轮询 → 下载。

适用场景

适合需要在 Claude Code 中批量生成图像或视频的创意工作流，尤其是需要泰语 prompt 支持的图像生成场景，以及需要图生视频、视频放大或带音频视频生成的场景。

限制

  • 成本信息暂未提供，资料建议先用 preview 再批量生成。
  • 除 text-to-image 与 veo3_fast 外，其他模型未经测试。
  • 部分规则（如 Grok prompt 语法、禁用词、主体短/场景长规则、禁止描述体型）已移至共享模型卡 grok-image.md，本文档未展开。
  • 规则要求：批量前先预览一次；不要读取已生成的图片以节省 context，只告知文件路径；每次都保存配套 .txt；不要读取后台任务的输出文件。
  • 下载必须带指定 headers，否则被拦截。
  • 文件上传仅限 curl multipart，且文件 3 天后自动删除。