生图专用

在模型广场选择“生图专用”，当前使用模型 gpt-image-2，支持 1K、2K 生图，按次计费。具体价格和可用规格以模型广场当前说明为准。

1. 创建 API 密钥，填写便于识别的名称，例如 image-gen。
2. 将分组设为“生图专用”，按需要设置额度和过期时间，再保存。
3. 复制完整密钥，在本地配置为 IMAGE_GEN_API_KEY。生图技能使用独立密钥，不读取 OPENAI_API_KEY。

Codex 技能可从本地配置文件读取密钥：macOS/Linux 使用 ~/.config/vortex-api/.env，Windows 使用 %APPDATA%\vortex-api\.env。也可配置同名环境变量；下方直接调用接口的示例从当前终端环境变量读取。

IMAGE_GEN_API_KEY=你的生图专用密钥

将下面的提示词发给 Codex，由它完成技能安装、密钥配置和默认生图设置。

发送前，请将 {} 替换为你的生图专用 Key。

请按 https://vortexapi.xyz/skill/image-gen/INSTALL.md 安装 image-gen。
我的生图专用 key 为{}。
请将 image-gen 设为默认生图方式，当我需要生图或者编辑图片的时候优先调用这个 Skill。

完整技能包|安装说明

安装说明中的 Codex 用户级目录为 ~/.agents/skills/image-gen。安装后新建会话，让 Codex 加载技能；如果未识别，重启客户端后再试。--doctor 只检查鉴权和模型可见性，不生成图片，也不代表实际生图已验证。

生成第一张图片

需要验证完整流程时，发送下面的指令。此步骤会按平台规则计费：

请生成一张太空猫，保存到当前项目的 output 目录并展示。

编辑图片时，附上参考图并说明修改要求，例如：

请将这张参考图改为科技风，保留主体，保存到当前项目的 output 目录并展示。

适合在自己的程序或后端服务中接入。先在当前终端设置环境变量 IMAGE_GEN_API_KEY；以下 cURL 示例适用于 macOS/Linux 或 Bash 终端，实际请求会计费。

export IMAGE_GEN_API_KEY='你的生图专用密钥'

接口地址为 https://vortexapi.xyz。统一使用 model: gpt-image-2、stream: true 和 response_format: b64_json，请求头 Accept 为 text/event-stream。下面以 1024x1024、生成 1 张为例。

文生图

curl --fail-with-body --no-buffer --max-time 900 \
  'https://vortexapi.xyz/v1/images/generations' \
  -H "Authorization: Bearer $IMAGE_GEN_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d '{"model":"gpt-image-2","prompt":"一只戴着宇航员头盔的橘猫，简洁插画","n":1,"size":"1024x1024","quality":"auto","stream":true,"response_format":"b64_json"}'

图生图与参考图编辑

将 reference.png 替换为本地图片路径。多张参考图可重复添加 image 字段；用 prompt 描述修改要求。只想依据原图生成变化时，也可写“根据参考图生成一张新图片”。

curl --fail-with-body --no-buffer --max-time 900 \
  'https://vortexapi.xyz/v1/images/edits' \
  -H "Authorization: Bearer $IMAGE_GEN_API_KEY" \
  -H 'Accept: text/event-stream' \
  -F 'model=gpt-image-2' \
  -F 'image=@./reference.png' \
  -F 'prompt=改成科技风，保留主体' \
  -F 'n=1' \
  -F 'size=1024x1024' \
  -F 'quality=auto' \
  -F 'stream=true' \
  -F 'response_format=b64_json'

读取并保存结果

cURL 输出的是响应数据，不是可直接打开的 PNG。程序应按 Content-Type 处理 SSE 或 JSON：SSE 按事件读取 data 字段，跳过心跳、[DONE] 和 partial_image 预览事件，从最终结果中的 b64_json（或 data 数组中的 b64_json）解码并保存图片。收到错误事件时应报告错误。

请求多张图片时，应累计各事件中的最终结果，确认数量达到 n；流结束但数量不足时保留已有图片并报告不完整。超时后先检查平台记录，不要自动重复计费请求。