希望在 Claude Code、Codex 等 Agent 工具中通过自然语言生图、编辑图片或融合多张参考图,可以使用 NoneLinear 生图 Skill。

快速开始

所有生图模型都使用同一个接口:
  • 鉴权:请求头 Authorization: Bearer <你的 API Key>,在 API Key 页面 获取。
  • 同步返回:服务端等待图片生成完成后才返回,耗时可能达到数分钟,请把客户端超时设为 300 秒以上。
  • 切换模型:只需修改 model,并按模型参数调整尺寸参数。
本页示例从环境变量 NONELINEAR_API_KEY 读取 API Key,运行前先在终端设置:
Windows PowerShell 的环境变量写法见快速开始。Python 示例使用 OpenAI SDK(pip install openai)。
HTTP 状态码为 200 并不代表一定出图。请以 data 中是否存在 url 或 b64_json 判断是否成功;data 为空或只有 text 时,按未出图处理。详见 Gemini 未出图说明。

请求参数

扩展参数如 image、aspect_ratio 在 Python SDK 中放入 extra_body;cURL 中放在 JSON 顶层。quality、watermark 等系列独有参数见对应模型页。

模型参数

查看全部 15 个系列 →

调用示例

常见问题

本地图片怎么传

image 只接受公网可直接访问的 HTTPS 图片地址,不能传本地文件路径。本地图片可以:
  • 先上传到自己的对象存储(OSS / S3 / CDN),再传入图片地址;
  • 使用平台提供的文件上传 API 上传后获取地址;
  • 在 Claude Code、Codex 等工具中使用 NoneLinear 生图 Skill,它会自动处理本地图片上传。
参考图地址需要免登录可访问、没有防盗链,且在生成期间保持有效。返回 404 或 Image unreachable 时,见参考图无法访问的排查。

请求超时怎么办

生图耗时通常在 1~3 分钟,部分模型更久。请把 SDK、反向代理和后端 Worker 的超时都设为 300 秒以上;网页应用建议采用异步任务方式,避免前端等待超时,见耗时较长的处理建议。
超时不代表生成失败,服务端可能仍在继续生成。请勿在超时后立即自动重试,以免重复生成、重复扣费。本页 Python 示例已通过 max_retries=0 关闭 SDK 自动重试。

返回的图片地址能保存多久

返回的图片 URL 是临时地址,请在收到响应后尽快下载并转存到自己的存储中,见结果保存。 更多错误码说明见错误处理。