Hopimg for Codex
在 Codex 中描述画面，或修改一张现有图片。使用你的 Hopimg 生图密钥，生成结果直接保存到本地项目。
插件实际生成
绿色玻璃台灯，浅灰色背景，柔和自然光。
gpt-image-2 · PNG
安装与密钥配置
准备支持 plugin 命令的 Codex CLI、Python 3.10+ 和有余额的 Hopimg 生图密钥。下载包自带安装脚本，不需要额外的 Python 依赖。
先检查 Python 3.10+ 和 Codex CLI。若没有 plugin 子命令，先更新 CLI。
python3 --version
codex plugin --helpnpm install -g @openai/codex解压并导入插件
命令假设 ZIP 位于 Downloads。下载到了其他目录时，请替换第一条解压命令中的路径；保留解压目录供后续更新使用。更新时会覆盖该目录中的插件文件。
mkdir -p "$HOME/hopimg-plugins"
unzip -o "$HOME/Downloads/hopimg-codex-1.0.1.zip" -d "$HOME/hopimg-plugins"
cd "$HOME/hopimg-plugins/hopimg-codex"
python3 install.py配置生图密钥
在同一终端运行，按提示粘贴密钥并回车，输入不会显示。密钥独立保存在用户目录；status 仅检查配置，不产生费用。
python3 plugins/hopimg/skills/hopimg/scripts/hopimg.py configure
python3 plugins/hopimg/skills/hopimg/scripts/hopimg.py status
codex plugin list安装完成后，新建一个 Codex 对话，选择 Hopimg 技能，或在请求中明确写“使用 Hopimg”。
文生图
在新对话中发送以下请求。Codex 会调用 Hopimg，保存图片并返回本地预览。
使用 Hopimg 生成一张绿色玻璃台灯的产品摄影图，
浅灰色背景，柔和自然光，1024x1024。
保存到当前项目的 output/hopimg，并展示图片。图生图
把原图放入项目，给出实际文件路径和修改要求。下面的 input.png 请替换为你的图片路径。
使用 Hopimg 编辑 ./input.png：
保留绿色玻璃台灯的造型和角度，将背景改为干净的浅蓝色。
保存到 output/hopimg，保留原图，并展示修改后的图片。图片会直接发送到 Hopimg。文生图与图生图均使用账户余额，实际扣费以用量记录为准。 查看计费
常见问题
上游有并发限制，可以同时生图吗？
插件默认单张，按顺序执行生图请求，并通过本机锁限制同一用户同时只发起一个请求。若已有任务运行，新请求会在调用 API 前提示等待，不会自动重试。其他设备或客户端仍可能占用上游并发额度。
安装后在 Codex 中找不到插件？
先运行 codex plugin list 确认 Hopimg 已安装，再新建一个 Codex 对话。在技能选择器中选择 Hopimg，或直接说“使用 Hopimg 生图”。若插件目录仍未刷新，重启桌面应用。旧对话不会自动加载新技能。
生图密钥会发给前端或打包进插件吗？
不会。插件不含任何密钥，教学页也不收集密钥。configure 将密钥保存到 ~/.config/hopimg/credentials.json，macOS/Linux 下文件仅当前用户可读写，Windows 继承用户目录权限。插件直接从本机向 api.hopimg.com 发送密钥、提示词和待编辑图片。环境变量 HOPIMG_API_KEY 优先于配置文件。
401、403 或 429 怎么处理？
401：重新运行 configure，填写有效密钥。403：检查密钥是否开放生图权限、账户余额是否充足。429：等待限流解除后再请求。生图密钥与 Codex 对话模型的密钥独立配置。
图生图提示 400 或 application/octet-stream？
这是上传格式问题。新版插件会识别图片实际内容，为 PNG、JPEG、WebP 分别设置正确的 MIME，无需手动指定。请更新插件并新建对话；若仍报错，确认使用 Hopimg 技能和有效图片，不要反复提交同一错误请求。自行调用 API 时，图片字段必须携带 image/png、image/jpeg 或 image/webp。
502 会自动重试吗？
会。上游网关偶发 502 时，文生图和图生图默认分别等待 2 秒、4 秒再重试，最多重试 2 次（总计 3 次请求），全程串行。可用 --retries 1 减少为一次，或 --retries 0 关闭。仍失败时，请检查服务状态和用量记录后再尝试；重试可能产生额外费用，以用量记录为准。
超时后会自动重试吗？
不会。每次请求默认等待 240 秒，502 重试时总等待时间会更长。单次生成可能需要几十秒或更久。超时后上游可能已经出图并计费，请先检查用量记录，再决定是否重新生成。网络访问被沙箱拦截时，按 Codex 的网络权限提示处理。
图片保存在哪里，支持哪些参数？
默认保存到当前项目的 output/hopimg，Codex 会返回可打开的绝对路径。支持 PNG/JPEG/WebP 原图（插件限制 50 MiB）、单次 1–10 张，以及 1024x1024、1024x1536、1536x1024、auto。输出按实际图片格式保存，不覆盖已有文件。
如何更新或卸载？
更新时下载新版、解压并运行 install.py，然后新建对话。卸载运行 codex plugin remove hopimg@hopimg。卸载不会删除已经生成的图片或本地密钥；需要清除密钥时，另行删除 ~/.config/hopimg/credentials.json，并取消已设置的 HOPIMG_API_KEY。