mcpField
C
codex-gpt-image

codex-gpt-image

github.com/ningzimu创意与媒体70262 次安装7 周前更新
代码仓库

关于 codex-gpt-image

codex-gpt-image 是通过 Codex OAuth 生成和编辑图像的技能，适用于支持 SKILL.md、但没有原生图像工具的 Agent。它使用本地 Codex 认证和命令行，而非 OpenAI API 密钥路径。

主要功能

  1. 01通过 Codex OAuth 生成图像
  2. 02使用参考图像编辑图像
  3. 03检查认证状态并登录
  4. 04将生成结果保存为本地文件

适用场景

  1. 01通过 Codex 订阅生成图像
  2. 02在不使用 OPENAI_API_KEY 时编辑图像
  3. 03在不同 Agent 间复用本地图像流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ningzimu/codex-gpt-image --skill codex-gpt-image

安装后在 Claude Code 中输入/codex-gpt-image确认已加载。

附带文件references/openai-images-api-parameters.mdscripts/codex_gpt_image.py

详细介绍

Codex GPT Image

使用此技能通过 Codex OAuth 生成或编辑图像，而不是使用 OpenAI API 密钥路径。捆绑的 CLI 会读取本地 Codex 身份验证文件，并调用 Codex Images 后端端点。

适用场景

  • 用户要求通过 Codex 身份验证/订阅使用 gpt-image-2.5-flare 或 GPT Image。
  • 当前 Agent 支持 SKILL.md，但没有原生图像工具。
  • 用户明确表示不想使用 OPENAI_API_KEY。
  • 用户希望在 Codex、Claude Code、OpenClaw、Hermes Agent 或类似 Agent 中使用相同的本地图像工作流。

如果用户想使用官方 OpenAI Images API、兼容 OpenAI 的网关或按 API 密钥计费，请勿使用此技能。此技能仅支持 Codex OAuth。

核心工作流

以下所有 CLI 命令均假设当前工作目录是此技能文件夹。否则，请从此 SKILL.md 解析 scripts/codex_gpt_image.py 的绝对路径。

  1. 检查本地 Codex 身份验证：

    python3 scripts/codex_gpt_image.py auth-status

  2. 如果缺少 Codex 身份验证，请运行设备代码登录流程：

    python3 scripts/codex_gpt_image.py login --open-browser

    CLI 会输出浏览器 URL 和一段简短的用户代码。用户必须完成此步骤；切勿要求他们粘贴令牌。

  3. 使用用户提供的实际提示词生成图像。仅选择请求所需的 CLI 标志，不要重复使用此技能中的提示词措辞。

  4. 通过传入一个或多个 --image 输入来编辑图像或使用参考图像。编辑时，根据用户要求的修改和必须保持不变的内容构建提示词。

  5. 报告已保存的路径、请求的模型、检查后确认的实际输出尺寸，以及是否使用了 Codex OAuth。除非后端确认使用了请求的模型，否则不要声称已使用该模型。

默认值

  • 身份验证文件：~/.codex/auth.json
  • 覆盖身份验证文件：CODEX_AUTH_FILE=/path/to/auth.json
  • 登录备用方式：login 使用 OpenAI Codex 设备代码身份验证，并写入同一身份验证文件
  • 登录客户端 ID：依次使用 --client-id、CODEX_APP_SERVER_LOGIN_CLIENT_ID，然后使用公开的 Codex 默认值
  • Images 基础 URL：https://chatgpt.com/backend-api/codex
  • 图像模型：gpt-image-2.5-flare
  • 尺寸：auto
  • 质量：auto
  • 背景：auto
  • 内容审核：auto
  • 输出格式：png
  • 输出压缩：jpeg 和 webp 为 100

详细的参数值、默认值、特定模型的限制和 CLI 映射，请阅读 references/openai-images-api-parameters.md。

参数选择

除非用户的请求需要特定选项，否则优先使用官方 API 默认值。选择明确的 model、size、quality、background、moderation 或 output_format 值之前，请先阅读参考文档。

提示词编写

提示词应明确且面向生产用途：

  • 指明预期的素材类型。
  • 引用任何需要准确呈现的可见文字。
  • 指定构图、背景、风格和限制。
  • 编辑时，重复说明必须保持不变的内容。
  • 除非用户要求，否则不要添加徽标、水印或额外文字。

故障处理

  • 缺少身份验证文件：运行 codex_gpt_image.py login --open-browser，或让用户运行 codex login，然后重试。
  • 401/403：Codex OAuth 令牌可能已过期、账户可能没有访问权限，或者端点可能拒绝了会话。请用户刷新 Codex 身份验证。
  • 网络故障：如果请求具有幂等性且用户接受可能重复生成图像，请重试一次。
  • 切勿打印或粘贴 ~/.codex/auth.json 中的令牌。

实现说明

CLI 发送 Codex Images 请求时使用：

  • 生成端点：POST https://chatgpt.com/backend-api/codex/images/generations
  • 编辑端点：POST https://chatgpt.com/backend-api/codex/images/edits
  • 身份验证：Authorization: Bearer <access token from ~/.codex/auth.json>
  • 模型：gpt-image-2.5-flare

它会解析 JSON Images 响应，并将返回的 base64 图像数据写入本地文件。

GPT Image 2.5 兼容性

日常生成请使用默认的 Flare 模型；如需精确编辑，请选择 --model gpt-image-2.5-sunburst。这两种模型及其带日期的快照均支持 xhigh 和 max 质量，以及使用 PNG/WebP 的透明背景。旧版模型无法使用新的质量级别；此 CLI 会对旧版模型禁用透明背景。Codex OAuth 访问权限取决于账户和后端的逐步发布情况。

2026-09-11 的 Codex OAuth 探测还发现，它接受了无效的模型名称、未返回实际模型 ID，并返回了与请求尺寸不同的图像尺寸。生成成功并不能验证模型或质量选择。请将这些标志视为请求的设置；不要将公共 API 的能力描述为 OAuth 后端行为的保证。

评论

支持 Markdown