ikunimage AI 生图

ikunimage 是一类把图像生成能力封装进 Claude Code / 本地脚本工作流的技能方案。它的价值不在“再造一个平台”，而在于让你直接在开发工作流里用自然语言生成图片。

适合场景

• 在 Claude Code 里直接文生图
• 批量出设计草图
• 图生图二次修改
• 把海报、封面、插图纳入自动化脚本

前置条件

• 已安装 Claude Code 或可运行 Python 脚本
• 已具备图像权限对应的 Key
• 官网入口：https://rtai.jnrongtu.com

基本安装思路

1. 下载技能目录

通常放在：

~/.claude/skills/ikunimage/

2. 安装依赖

pip install httpx

3. 配置 API Key

常见方式有三种：

• 命令行参数
• 环境变量
• 本地配置文件

例如：

export IKUN_API_KEY="sk-你的key"

常见脚本能力

• 文生图
• 图生图编辑
• 批量任务
• 重试与并发
• 输出目录控制

常用调用思路

文生图

python ~/.claude/skills/ikunimage/scripts/generate_ikun.py   -p "生成一张国风海报，3:4，2K"   -ar 3:4   -s 2K   -o ./output.png

图生图

python ~/.claude/skills/ikunimage/scripts/generate_ikun_edit.py   -i ./input.png   -p "保持主体不变，把背景改成夜景霓虹"   -o ./edited.png

使用建议

先从 2K 开始

2K 通常是最稳的平衡点，速度、质量和消耗都比较合适。

图生图提示词要写清“保留什么、改什么”

例如：

• 保持人物姿态不变
• 只替换背景
• 保留文字排版
• 增加灯光氛围

批量任务别盲目开太高并发

图像生成比普通文本接口更耗时，大并发更容易让失败率升高。

常见问题

提示找不到 API Key

先看环境变量、再看本地配置文件、最后看脚本参数，逐层确认。

4K 经常超时

先降到 2K 验证链路。不是所有场景都需要 4K。

图生图效果不稳定

通常不是模型坏了，而是编辑指令不够明确。