跳转至

图像生成

图像生成

内置的 openai 插件通过 image_generate 工具注册图像生成功能。它通过相同的 openai/gpt-image-2 模型引用同时支持 OpenAI API 密钥和 Codex OAuth 图像生成。Sign in with ChatGPT(SIWC)无法授权此工具。此处的 Codex OAuth 指的是 OpenClaw 的模型认证配置文件;仅登录原生 Codex 用户主目录并不会为 image_generate 提供凭据。

能力 OpenAI API 密钥 Codex OAuth
模型引用 openai/gpt-image-2 openai/gpt-image-2
认证 OPENAI_API_KEY OpenAI Codex OAuth 登录
传输方式 OpenAI Images API Codex Responses 后端
每次请求的最大图像数 4 4
编辑模式 已启用(最多 5 张参考图像) 已启用(最多 5 张参考图像)
审核 low 或 auto;生成和编辑 low 或 auto;生成和编辑
尺寸覆盖 支持,包括 2K/4K 尺寸 支持,包括 2K/4K 尺寸
宽高比 / 分辨率 不会转发到 OpenAI Images API 在安全时映射到受支持的尺寸
{
  agents: {
    defaults: {
      mediaModels: { image: { primary: "openai/gpt-image-2" } },
    },
  },
}

Note

有关共享工具参数、提供程序选择及故障转移行为,请参阅 图像生成。

gpt-image-2 是 OpenAI 文生图生成和图像编辑的默认模型。gpt-image-1.5、gpt-image-1 和 gpt-image-1-mini 仍可作为显式模型覆盖使用。如需生成透明背景的 PNG/WebP 输出,请使用 openai/gpt-image-1.5;当前的 gpt-image-2 API 会拒绝 background: "transparent"。

GPT Image 2.5

显式选择 openai/gpt-image-2.5-flare 或 openai/gpt-image-2.5-sunburst。两者都支持通过直接的 Images API 进行生成和编辑。默认模型仍然是 openai/gpt-image-2。

导出 OPENAI_API_KEY 并选择 API 密钥认证:

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://api.openai.com/v1",
        auth: "api-key",
        models: [],
      },
    },
  },
}

当同时存在 OpenAI OAuth 配置文件时,这一显式选择非常重要。仅导出环境变量并不能覆盖该配置文件。此 API 密钥配置不会建立 GPT Image 2.5 订阅访问权限。

两种变体都接受 low、medium、high、xhigh、max 或 auto 质量参数。透明背景请使用 PNG 或 WebP。通过 OpenClaw 进行编辑时,最多可接受 5 张参考图像。

openclaw infer image generate \
  --model openai/gpt-image-2.5-flare \
  --prompt "A simple red circle sticker on a transparent background" \
  --quality low --output-format webp --background transparent --json

openclaw infer image edit \
  --model openai/gpt-image-2.5-sunburst \
  --file /path/to/reference.png \
  --prompt "Keep the shape and change the color to blue" \
  --quality low --size auto --json

size 接受 auto 或 WIDTHxHEIGHT。尺寸必须能被 16 整除,任意边长不得超过 3840 像素,总像素数必须在 655,360 到 8,294,400 之间。宽高比必须在 1:3 到 3:1 之间。

其他图像模型

如需透明背景请求,请使用 model: "openai/gpt-image-1.5"、outputFormat: "png" 或 "webp" 以及 background: "transparent" 调用 image_generate;较旧的 openai.background 提供程序选项仍然受支持。OpenClaw 还会将默认的 openai/gpt-image-2 透明背景请求重写为 gpt-image-1.5,以保护公共 OpenAI 和 OpenAI Codex OAuth 路由;Azure 和自定义 OpenAI 兼容端点会保留其配置的部署/模型名称。

同样的设置也可用于无头 CLI 运行:

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "A simple red circle sticker on a transparent background" \
  --json

当从输入文件开始时,请将相同的 --output-format 和 --background 标志与 openclaw infer image edit 一起使用。--openai-background 仍可作为 OpenAI 专用的别名使用。使用 --quality low|medium|high|auto 控制 OpenAI Images 的质量和成本。在 image generate 和 image edit 中使用 --openai-moderation low|auto 以传递 OpenAI 的审核提示。直接的 OpenAI Images API 和 ChatGPT/Codex OAuth Responses 后端都支持文生图生成和参考图像编辑的审核。

对于 ChatGPT/Codex OAuth 安装,请保留相同的 openai/gpt-image-2 引用。当配置了 openai OAuth 配置文件时,OpenClaw 会解析存储的 OAuth 访问令牌,并通过 Codex Responses 后端发送图像请求;它不会先尝试 OPENAI_API_KEY,也不会静默回退到 API 密钥。该 Responses 请求运行在 gpt-6-astra 上。如果你的 ChatGPT 套餐拒绝该模型,OpenClaw 会使用 agents.defaults.model 中的每个 openai/* 模型依次重试(先主模型,后回退模型),因此请在那里配置你的套餐支持的模型。如果你希望改用直接的 OpenAI Images API 路由,请显式配置 models.providers.openai,并提供 API 密钥、自定义 base URL 或 Azure 端点。如果该自定义图像端点位于受信任的 LAN/私有地址上,还需设置 browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true;除非存在此项选择加入(opt-in)配置,否则 OpenClaw 会一直阻止 OpenAI 兼容的私有/内部图像端点。

生成:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

生成透明 PNG:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

编辑:

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

OpenAI 已于 2026-09-24 下线其 Sora 视频 API;支持的提供商请参见 视频生成。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw