网页端的卡咔是「你点，它做」。但很多团队想要的不是又一个网页，而是把做图能力嵌进自己的系统：内容工厂要把「选题→写稿→出图→发布」串成无人值守的流水线；AI Agent 用户希望 Claude 的一句话里就带出成图；开发者想给自己的社群机器人加一个「/做图」指令。
这些场景的共同点是：生成必须可编程。卡咔开放平台为此提供了三层接入方式——OpenAPI、MCP Server、Agent Skills。
一、OpenAPI v1：网页端能力的完整映射
开放接口部署在 /openapi/v1 下，使用 kc- 前缀的 API Key 鉴权（在用户端「API 接入」页生成，明文只显示一次）。能力与网页端完全对齐：
| 能力域 | 接口能力 |
|---|---|
| 爆款图文 | 大纲生成（同步）/ 大纲编辑 / 整篇出图（异步）/ 单页重生成 |
| 多平台封面 | 多规格一次生成 / 单张重生成，平台规格可查询 |
| 知识卡片 | 一步到位生成 / 单张重生成 |
| 通用 | 任务状态轮询（跨业务通用）、能量余额自查、风格列表 |
几个对集成方重要的设计：
- 计费同价同源：API 消耗的能量与网页端同一套账，生成前预扣、失败自动退款，不会出现「接口跑失败还扣钱」；
- Webhook 终态回调：异步任务完成后主动回调你的服务，HMAC-SHA256 签名验证，0s/5s/15s 三次重试——不用傻轮询；
- 多 Key 管理：每个账号最多 5 把 Key，可命名（如「内容工厂」「测试」），独立生成、独立吊销，每把 Key 的用量都有报表可查。
二、MCP Server：给 AI 客户端的 11 个工具
如果你的客户端支持 MCP（Claude Code、Cursor 等），可以直接挂载卡咔的 MCP Server，获得 11 个工具：能量自查、风格列表、爆款图文大纲/出图/单页重生成、封面多规格生成与重生成、知识卡片生成与重生成、通用任务轮询。
Claude Code 接入示例：
claude mcp add kaka-openapi \
-e KAKA_API_KEY=kc-你的Key \
-e KAKA_BASE_URL=https://api.cardcrafter.cn \
-- node /path/to/mcp-server/index.js
配置完成后，你可以直接对 AI 说：「用小红书爆款风格，把这篇文档做成 9 图轮播，风格参考日系极简」——AI 会自己调工具查风格、生成大纲、出图、轮询结果，把成品链接递回来。生成消耗的是你卡咔账号的能量，所有记录在网页端「我的创作」里同样可见、可管理。
三、Agent Skills：零依赖的更简接法
MCP 需要客户端支持协议，而 Agent Skills 方式什么环境都能跑：把托管在 https://api.cardcrafter.cn/openapi/skill.md 的技能文档下载给你的 AI（一句话安装指令即可），它会自动读懂全部接口约定，之后你用自然语言下需求，它直接以 HTTP 调用完成生成。
两种接法能力等价，选择标准很简单：客户端支持 MCP 就用 MCP，不支持或有沙箱限制就用 Skills。
四、典型的三个落地场景
- 内容工厂流水线：选题系统产出主题 → 脚本调用大纲接口生成结构 → 审稿人改大纲（编辑不扣能量）→ 出图 → webhook 通知 → 推入发布队列。人只在审稿一个环节出现。
- Agent 工作流的出图插件：你的 Agent 已经能写文案、做数据分析，接入后它也「会做图」了——周报自动配封面、数据报告自动出信息卡片。
- 社群/IM 机器人：在群里发「/封面 今晚 8 点直播：AI 绘画避坑」，机器人调接口生成对应规格封面回传群里。
五、接入前的三个检查项
- 能量与配额：API 与网页端共用能量池，接口另有日配额控制，高频调用前先在「API 接入」页确认配额与余额（
get_me可程序化自查）； - Key 安全：Key 明文只显示一次，妥善保存；不同业务用不同 Key，便于用量隔离与独立吊销；
- 异步心智：除大纲生成外，出图类接口都是异步的——优先用 webhook 接收终态，轮询只作为兜底。
结语
生成能力的开放，意味着「做图」从一个产品变成了一项可编排的服务。无论你是想搭建内容流水线的运营团队，还是想让 Agent 长出设计能力的开发者，接入成本都已经压到了「一条命令」的量级。
打开 卡咔 CardCrafter AI 的「API 接入」页生成你的第一把 Key，或者直接把 https://api.cardcrafter.cn/openapi/skill.md 丢给你的 AI——让它在下一次对话里证明自己会做图。