概览 - docs.kie.ai

在你的编程 Agent 里使用 KIE

KIE 提供两个 Agent skill。skill 是一小组指令，你的编程 Agent 会自己加载它。加载 skill 之后，你只需用大白话说想要什么结果，API 调用由 Agent 来完成，不用再把文档一段段贴进对话里。

一条安装命令会同时装好两个 skill，Agent 会根据你的请求自动选用合适的那个。

先设置 API Key： export KIE_API_KEY=your_key。没有的话到 kie.ai/api-key 创建一个。

WARNING

⚠️ 使用 Agent 功能请选择最新版模型

Agent 功能请使用各系列的最新版模型。部分较早的模型目前仅支持对话调用，接入 Agent 可能会出现请求报错或结果异常，这类模型在 Market 的模型页上标有「仅支持对话调用」。具体可用的模型以各 Agent 的模型列表为准。

两个 skill

kie-models：用 KIE 模型开发

让 Agent 直接使用 KIE 上 200+ 图片、视频、音乐和语音模型。Agent 会自己挑选模型、读取参数、上传输入文件，并轮询到结果就绪。

适合：在自己的应用里接入生成能力，或者直接产出图片、视频、音频文件。

类型：图片 · 视频 · 音乐 · 语音

从这里开始：「安装 kie-models」→「Agent 能做什么」

kie-chat-agents：在 KIE 上运行编程 Agent

用 KIE 积分，在 KIE 的 chat 模型上运行 Codex CLI、Claude Code 或 Grok Build。每个 Agent 都有对应的 base URL、Key 和模型名配置说明。

适合：想让自己的编程 Agent 走 KIE 的模型和计费。

目前覆盖：Codex CLI · Claude Code · Grok Build

从这里开始：「安装 kie-chat-agents」→ 对应 Agent 的页面

我需要哪个 skill？

你想要	Skill	示例请求
在自己的应用里生成图片、视频、音乐或语音	`kie-models`	“给我的 API 加一个 Veo 3.1 视频接口”
直接生成一个文件	`kie-models`	“用 GPT Image 2 生成一张白色陶瓷杯的 1:1 产品图，保存到 ./public”
用 KIE 积分运行 Claude Code、Codex 或 Grok Build	`kie-chat-agents`	“把 Codex 配置成使用 KIE”
查看某个 Agent 能用哪些模型	`kie-chat-agents`	“列出 Claude Code 在 KIE 上能用的模型”

快速开始

安装 skill（每台机器一次，需要 Node.js）：

创建 API Key。 到 kie.ai/api-key 创建。

导出为环境变量 KIE_API_KEY。 两个 skill 都从这个变量读取密钥，不需要写进项目文件。

macOS / Linux：

Windows（PowerShell）：

$env:KIE_API_KEY = "your_key"
setx KIE_API_KEY "your_key"

setx 只对之后新开的窗口生效，想立刻用上要同时设 $env:。

从设置了这个变量的 shell 里启动 Agent，然后按你的目标选一条路：

生成图片、视频、音乐或语音 → 「安装 kie-models」

让编程 Agent 跑在 KIE 上 → 「安装 kie-chat-agents」

你提出请求后会发生什么（kie-models）

步骤	Agent 做了什么
FIND 查找	搜索实时模型列表
READ 读取	加载该模型的参数
UPLOAD 上传	如有需要，托管你的输入文件
RUN 运行	提交任务并等待完成
SAVE 保存	下载生成结果

例如你说：“用 GPT Image 2 生成一张白色陶瓷杯的 1:1 产品图，保存到 ./public”，Agent 会依次搜索模型、读取 gpt-image-2-text-to-image 的参数、提交任务、等待生成完成，最后把图片保存到 ./public。

生成的文件保留 14 天。Agent 会替你下载到本地，链接过期也不会丢。

编程 Agent 怎么接到 KIE（kie-chat-agents）

KIE 的 chat 模型按各家厂商自己的 wire 协议对外提供。Agent 的协议和模型的协议一致时，直接把 Agent 指到 api.kie.ai 即可，不需要适配层。

Agent	协议	列出可用模型
Claude Code	Anthropic Messages	`GET https://api.kie.ai/anthropic/v1/models`
Codex CLI	OpenAI Responses	`GET https://api.kie.ai/openai/v1/models`
Grok Build	Responses	`GET https://api.kie.ai/xai/v1/models`

协议不一致时（例如想让 Claude Code 跑 Responses 协议的模型），需要一个本地翻译代理，见「安装 kie-chat-agents」页的「协议不一致时」一节。

需要知道的事

模型名以实时列表为准。 两个 skill 都要求 Agent 每次从 KIE 读取模型列表，不凭记忆写模型名，所以新上的模型可以直接用。

认证统一用 Authorization: Bearer。 KIE 的所有接口都靠这一个请求头携带 API Key，名字叫 apikey 的请求头会被 401 拒掉。

按 KIE 积分计费。 和你自己调用 API 一样，每次调用都能在 kie.ai/logs 看到。

保护好密钥。 放在环境变量里，不要贴进聊天、截图，也不要写进会提交到仓库的文件。泄露后到 kie.ai/api-key 重置。

本栏目的页面

页面	内容
安装 kie-models	安装 skill、设置 API Key，跑通第一个生成任务
Agent 能做什么	支持的模型类型、Agent 替你完成的步骤、怎么把需求说清楚
安装 kie-chat-agents	安装、先决条件、三个 Agent 一览、协议不一致时怎么办
Claude Code	列模型、环境变量与 settings 配置、确认生效、常见坑
Codex CLI	列模型、`config.toml` provider 配置、推理强度、常见坑
Grok Build	列模型、`[model.*]` 配置、确认生效、常见坑
常见问题排查	401、路径重复、`model not found`、变量不生效等问题的解决办法
更新日志	版本更新记录

概览

两个 skill#

kie-models：用 KIE 模型开发#

kie-chat-agents：在 KIE 上运行编程 Agent#

我需要哪个 skill？#

快速开始#

你提出请求后会发生什么（kie-models）#

编程 Agent 怎么接到 KIE（kie-chat-agents）#

需要知道的事#

本栏目的页面#