跳到正文
下载中心 →

codex 生图工具包

跟着中文安装向导完成配置后,直接描述生成或编辑图片,无需输入技能命令。

本页内容
目标电脑系统默认 Windows,可按实际使用的电脑切换

本页适用的服务

本页保留现有工具的原有中转服务预设。使用平台账户与平台 Key,请先查看 平台 API 接入,客户端按手动配置指南填写平台地址。原有服务的 Key 与额度继续单独管理。

装好后,在 Codex 里直接说

还没有安装?先到 codex 生图工具包下载与安装,选择你的电脑系统。
安装向导完成后,打开 Codex 新对话,直接说下面这句话即可。不必输入技能名称或命令前缀。
还没有 Key?前往中转站获取 API Key。复制后粘贴进安装窗口,不要发到聊天里。
Codex 会按请求内容自动选择 Skill。如果同时装了多个生图工具、没有选中本工具包,可以说“用生图工具包帮我生成图片”。如果工具包尚未被识别,再保存工作并重开 Codex。
text
帮我生成一张咖啡店宣传海报。

选择模型

可选 gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst。安装时可选一个默认模型,也可选“每次询问”。对话中临时指定模型不会改变已保存偏好;随时可以要求更换默认模型。模型权限和参数以当前 API Key 分组为准。
text
这次用 gpt-image-2.5-flare,生成一张雨后街景。
以后默认使用 gpt-image-2.5-sunburst。
以后每次生成前都问我使用哪个模型。

参考图编辑

在 Codex 对话中提供参考图片路径并描述改动,Skill 会调用图片编辑接口。需要遮罩时说明遮罩文件路径。可使用多张参考图,具体能力受模型和分组限制。
text
使用这张产品图,把背景改为浅灰色摄影棚,保持产品主体不变。
连接与自动备用线路
确定请求尚未发出时,主线路连接失败会自动切换备用线路。已提交后超时不会自动重发,因为可能已生成并扣费。请先查看控制台记录,再决定是否重新生成。
Key 无效、额度不足、限流和模型权限错误不会触发换线路重试。两条线路共用后端,备用线路不能解决共同后端停机。
用途地址
默认 APIhttps://gmats.mosshubs.com/v1
网络备用 APIhttps://sub.ai.mosshubs.com/v1
账户、额度、Keyhttps://sub.ai.mosshubs.com/

调整参数与重新配置

默认生成 1 张,尺寸和质量采用服务默认值。可以在对话中指定模型、尺寸、质量、输出位置和张数;客户端每次最多 4 张。不要把模型名称当作价格或能力保证。
安装包内 configure 可重新录入 Key,doctor 可检查连接和模型列表。模型列表可见不代表生图已成功;建议确认额度后先生成单张。高级地址设置会重新要求输入对应 Key,并在使用第三方地址时禁用官方备用线路。

问题处理与隐私

Key 保存于本地用户配置目录,不放进 Skill、日志或聊天内容;Windows 使用当前用户加密,macOS/Linux 使用受限文件权限。调用时,Key、提示词和参考图会发送给配置的中转服务。图片下载不会附带 API Key。
反馈请提供版本、系统、发生时间与脱敏错误,不要提交 Key。
现象处理方法
没有自动使用工具包先说“用生图工具包帮我生成图片”。仍未识别时,保存工作、退出并重开 Codex,再开始新对话。
尚未配置运行安装包内 configure,隐藏粘贴 Key。
401 / Key 无效检查 Key 是否有效并重新配置。
403 / 404 / 模型不支持核对 OpenAI 平台分组、模型权限与编辑能力。
429 / 额度不足检查额度、分组限制与调用频率,不重复点击。
超时或图片下载失败查看控制台记录,生成可能已完成;不要直接重复生成。

升级、更换配置与卸载

升级、重配与卸载请按 工具包维护步骤 操作。换电脑时重新安装并填写 Key;已有作品按结果中显示的文件路径另行复制。
生成完成后查看 Codex 返回的图片及输出路径。需要固定保存位置时,在请求中说明目录;清理安装包前先确认作品已保存。