NoneLinear 生图 Skill

NoneLinear 生图 Skill 可以让 Claude Code、Codex 等 Agent 工具通过自然语言生成图片、编辑本地图片或融合多张参考图，无需手动编写 API 请求。当前版本：0.3.0

支持能力

文生图
单图编辑
多图融合
本地图片安全上传
自动处理不同模型的参数差异
返回可直接访问的图片 URL
阻止 base64 图片进入 Agent 上下文

下载

推荐下载 Universal ZIP：

环境要求

Node.js 18 或更高版本
Agent 可以执行本地 Node.js 命令
拥有可用的 NoneLinear API Key

Skill 自带无第三方依赖的脚本，不需要安装 NoneLinear CLI，也不需要运行 npm install。

API Key 自动复用

如果 Claude Code、Codex 或 cc-switch 已经配置并正在使用 NoneLinear API，生图 Skill 通常可以直接复用当前 Agent 进程中的 API Key，不需要重复配置。

Skill 按以下顺序读取凭据：

优先级	环境变量	使用条件
1	`NONELINEAR_API_KEY`	直接作为 NoneLinear API Key 使用
2	`OPENAI_API_KEY`	`OPENAI_BASE_URL` 必须指向 `api.nonelinear.com`
3	`ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`	`ANTHROPIC_BASE_URL` 必须指向 `api.nonelinear.com`

因此：

Codex 已通过 OPENAI_API_KEY 和 NoneLinear Base URL 接入时，Skill 可以复用该凭据。
Claude Code 已通过 Anthropic 环境变量和 NoneLinear Base URL 接入时，Skill 可以复用该凭据。
cc-switch 将当前配置注入 Agent 子进程时，Skill 也可以直接复用。

出于安全考虑，只有 Base URL 的 HTTPS 主机名严格等于 api.nonelinear.com 时，Skill 才会复用 OpenAI 或 Anthropic 凭据，避免把其他平台的 API Key 用于生图请求。 Skill 不会读取 Claude Code、Codex 或 cc-switch 的配置文件和数据库。如果宿主没有把凭据传入 Skill 子进程，会返回：

missing_api_key

只有出现该错误时，才需要单独配置 NONELINEAR_API_KEY。

手动配置备用凭据

macOS / Linux：

export NONELINEAR_API_KEY="nl-xxx"

Windows PowerShell：

$env:NONELINEAR_API_KEY="nl-xxx"

Windows CMD：

set "NONELINEAR_API_KEY=nl-xxx"

配置后需要重新启动 Agent 或新建会话。不要把真实 API Key 写入 Skill 文件、项目文件或聊天消息。

安装到 Claude Code

macOS / Linux：

mkdir -p ~/.claude/skills
unzip nonelinear-image-0.3.0.zip -d ~/.claude/skills

Windows PowerShell：

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills" | Out-Null
Expand-Archive .\nonelinear-image-0.3.0.zip -DestinationPath "$HOME\.claude\skills" -Force

安装后新建 Claude Code 会话：

/nonelinear-image 生成一张 1:1 产品图：白色陶瓷马克杯放在胡桃木桌面上，清晨自然光，真实摄影风格。

安装到 Codex

macOS / Linux：

mkdir -p ~/.agents/skills
unzip nonelinear-image-0.3.0.zip -d ~/.agents/skills

Windows PowerShell：

New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills" | Out-Null
Expand-Archive .\nonelinear-image-0.3.0.zip -DestinationPath "$HOME\.agents\skills" -Force

安装后新建 Codex 会话：

使用 $nonelinear-image 生成一张 16:9 图片：雨后的上海街道，霓虹灯倒映在路面，电影摄影风格。

其他工具

TRAE 可以将 Skill 放到项目目录：

<project>/.trae/skills/nonelinear-image/SKILL.md

Cherry Studio、WorkBuddy 等支持 Skills 管理的工具，可以直接导入 nonelinear-image-0.3.0.zip。 TRAE、Cherry Studio、WorkBuddy 的不同版本可能存在导入入口、环境变量继承和本地命令权限差异。

图片编辑

编辑公开图片：

使用 nonelinear-image 编辑 https://example.com/product.png，把背景替换成浅灰色摄影棚，保留产品外观。

编辑本地图片：

使用 nonelinear-image 编辑本地图片 /home/user/images/product.png，把背景替换成浅灰色摄影棚。不要读取或附加图片，直接把路径交给 Skill。

Windows 示例：

使用 nonelinear-image 编辑本地图片 C:\Users\user\Pictures\product.png，把背景替换成浅灰色摄影棚。不要读取或附加图片，直接把路径交给 Skill。

多图融合

使用 nonelinear-image 融合 /home/user/product.png 和 /home/user/scene.png，把第一张图的产品自然放入第二张图的场景，保持产品外观和比例。

本地路径和公开 HTTPS URL 可以混合使用，参考图顺序会被保留。

安全与计费

图片生成请求发送到 https://api.nonelinear.com/v1/images/generations。
本地图片只会上传到固定的 https://nonelinear.com/api/upload-file。
API Key、Authorization Header、base64 和完整请求体不会出现在 Agent 回复中。
每次生成请求都可能产生费用。
Skill 不会在失败后自动重新生成，避免重复计费。
用户指定模型时，Skill 不会静默切换到其他模型。

常见问题

Skill 没有被识别

确认解压后的目录结构为：

nonelinear-image/
├── SKILL.md
├── agents/
├── references/
└── scripts/

安装后需要新建 Claude Code 或 Codex 会话。

返回 `missing_api_key`

说明宿主没有把现有 NoneLinear 凭据传给 Skill 子进程。此时可以单独设置 NONELINEAR_API_KEY，然后重新打开 Agent。

返回 Node.js 版本错误

执行：

node --version

需要 Node.js 18 或更高版本。

请求成功但没有图片

部分模型可能返回文本结果、空图片数组或内容策略错误。Skill 会将其视为失败，不会自动重试。可以修改 Prompt 后再次主动发起请求。

官方 Skills

聊天助手

办公工具

开发工具

支持能力

下载

环境要求

API Key 自动复用

手动配置备用凭据

安装到 Claude Code

安装到 Codex

其他工具

图片编辑

多图融合

安全与计费

常见问题

Skill 没有被识别

返回 `missing_api_key`

返回 Node.js 版本错误

请求成功但没有图片

​支持能力

​下载

​环境要求

​API Key 自动复用

​手动配置备用凭据

​安装到 Claude Code

​安装到 Codex

​其他工具

​图片编辑

​多图融合

​安全与计费

​常见问题

​Skill 没有被识别

​返回 missing_api_key

​返回 Node.js 版本错误

​请求成功但没有图片

支持能力

下载

环境要求

API Key 自动复用

手动配置备用凭据

安装到 Claude Code

安装到 Codex

其他工具

图片编辑

多图融合

安全与计费

常见问题

Skill 没有被识别

返回 `missing_api_key`

返回 Node.js 版本错误

请求成功但没有图片