Muxla 文档

外观

gpt-image-2 接入指南 ​

gpt-image-2 适合已经使用 OpenAI Images API 调用方式的应用迁移到 Muxla。按次计费请使用支持按次计费的 Token / API Key 分组。

按次计费 ​

gpt-image-2 按次计费需要同时满足两个条件：

  1. 创建 Token / API Key 时选择支持按次计费的特定分组。一般这类分组名会带有 Count 字样。
  2. 请求体或表单中的 model 使用 gpt-image-2。

支持的按次分辨率 ​

Muxla 对 gpt-image-2 按次计费采用固定分辨率档位。请优先使用下面列出的 size，未列出的其他合法尺寸会按 4K 档计费。

计费档位支持的 size
1K1024x1024、1536x1024、1024x1536
2K2048x2048、2048x1152、1152x2048、1920x1072、1920x1088、1072x1920、1088x1920
4K其他未列出的合法 size

如果你需要使用未列出的分辨率并希望单独确认计费档位，请联系 Muxla 客服。

价格预估 ​

OpenAI 官方价格页目前提供图片输出 token 单价，但没有直接列出 gpt-image-2 的按张预估。下面按常用尺寸和质量档位估算图片输出 token，并按 $30 / 100 万 token 折算为美元价格，仅作为下单前的成本参考。

分辨率lowmediumhigh
1024x1024196 tokens / $0.005881,756 tokens / $0.052687,024 tokens / $0.21072
1024x1536158 tokens / $0.004741,372 tokens / $0.041165,488 tokens / $0.16464
2048x2048397 tokens / $0.011913,568 tokens / $0.1070414,272 tokens / $0.42816
2560x1440205 tokens / $0.006151,843 tokens / $0.055297,370 tokens / $0.22110
3840x2160371 tokens / $0.011133,336 tokens / $0.1000813,342 tokens / $0.40026
3840x2048356 tokens / $0.010683,078 tokens / $0.0923412,074 tokens / $0.36222
3840x1280139 tokens / $0.004171,328 tokens / $0.039845,311 tokens / $0.15933

1920x1080 严格来说不是合法尺寸，因为 1080 不能被 16 整除。可以使用相近尺寸：

分辨率lowmediumhigh
1920x1072147 tokens / $0.004411,315 tokens / $0.039455,260 tokens / $0.15780
1920x1088148 tokens / $0.004441,325 tokens / $0.039755,300 tokens / $0.15900

实际扣费会受官方价格更新、请求参数、分组倍率和 Muxla 控制台计费规则影响，请以最终账单为准。

文生图请求 ​

gpt-image-2 文生图使用 Images Generations 接口：

txt
https://mux.la/v1/images/generations

请求示例：

bash
curl "https://mux.la/v1/images/generations" \
  -H "Authorization: Bearer 你的 Muxla Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张极简风格的咖啡品牌海报，暖色灯光，适合移动端广告",
    "n": 1,
    "size": "1024x1024",
    "quality": "high"
  }'

这里的 gpt-image-2 是按次计费示例模型。实际调用时，请以 Muxla 控制台 模型列表为准。

文生图字段说明 ​

  • model：生图模型名称。示例使用 "gpt-image-2"。
  • prompt：文字提示词，描述要生成的图片内容、风格、构图和用途。
  • n：生成图片数量。
  • size：输出图片尺寸，例如 "1024x1024"。按次计费仅支持上方列出的固定分辨率档位；其他合法尺寸会按 4K 档计费。
  • quality：图片质量档位。示例使用 "high"。

图生图请求 ​

gpt-image-2 图生图使用 Images Edits 接口：

txt
https://mux.la/v1/images/edits

图生图使用 multipart 表单提交参考图和生成参数：

bash
curl "https://mux.la/v1/images/edits" \
  -H "Authorization: Bearer 你的 Muxla Token" \
  -F "model=gpt-image-2" \
  -F "image=@reference.png" \
  -F "prompt=参考这张图片，保持主体不变，改成更明亮的商业摄影风格" \
  -F "n=1" \
  -F "size=1024x1024" \
  -F "quality=high"

图生图字段说明 ​

  • model：图生图模型名称。示例使用 "gpt-image-2"。
  • image：参考图文件，使用 multipart 表单上传。
  • prompt：编辑说明，描述希望基于参考图做什么变化。
  • n：生成图片数量。
  • size：输出图片尺寸，例如 "1024x1024"。按次计费仅支持上方列出的固定分辨率档位；其他合法尺寸会按 4K 档计费。
  • quality：图片质量档位。示例使用 "high"。

在 Codex 中使用 gpt-image-2 ​

如果你希望在 Codex 里直接生成图片，并把结果保存为本地文件，可以安装第三方技能 codex-image。该技能基于 Images API，支持文生图、图生图、多参考图和指定输出路径。

Codex CLI 和带 GUI 的 Codex Desktop 都可以使用这个技能：CLI 可以直接执行命令；Codex Desktop 更适合通过对话让 Codex 安装和调用技能。

Codex Desktop 使用方式 ​

在 Codex Desktop 中，打开一个对话后，直接让 Codex 帮你安装技能：

text
请使用 skill-installer 安装这个 Codex 生图技能：
https://github.com/IanShaw027/codex-image

如果 Codex 需要更明确的安装路径，可以继续发送：

text
请从仓库 IanShaw027/codex-image 安装 skills/codex-image 这个 skill。

安装完成后，重启 Codex Desktop。之后在对话里直接描述生图需求即可，例如：

text
使用 gpt-image-2 生成一张 1024x1024 的极简咖啡品牌海报，质量 high，保存到 ./output/poster.png。

图生图也可以通过对话完成：

text
使用 gpt-image-2 参考 ./reference.png 做图生图，保持主体不变，改成更明亮的商业摄影风格，保存到 ./output/edit.png。

如需按次计费，请确保 Codex Desktop 使用的 Muxla Token / API Key 属于支持按次计费的分组，并在对话中明确要求模型使用 gpt-image-2。

Codex CLI 安装技能 ​

使用 Codex 自带的 skill-installer 从 GitHub 安装：

bash
python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo IanShaw027/codex-image \
  --path skills/codex-image

安装完成后，重启 Codex 让新技能生效。

Codex CLI 配置 Muxla ​

如果你的 Codex 已经按 Codex CLI 接入指南 配置了 base_url = "https://mux.la/v1" 和 API Key，codex-image 会优先读取 Codex 的配置。也可以在当前终端显式设置：

bash
export OPENAI_API_KEY="你的 Muxla Token"
export OPENAI_BASE_URL="https://mux.la/v1"
export CODEX_IMAGE_MODEL="gpt-image-2"

如需按次计费，请确保 Token / API Key 使用支持按次计费的分组，并将 CODEX_IMAGE_MODEL 或命令中的 --model 设置为 gpt-image-2。

Codex CLI 生成图片 ​

bash
bash "${CODEX_HOME:-$HOME/.codex}/skills/codex-image/scripts/codex-image" generate \
  --model gpt-image-2 \
  --size 1024x1024 \
  --quality high \
  --out ./output/poster.png \
  "生成一张极简风格的咖啡品牌海报，暖色灯光，适合移动端广告"

Codex CLI 基于参考图编辑 ​

bash
bash "${CODEX_HOME:-$HOME/.codex}/skills/codex-image/scripts/codex-image" edit \
  --model gpt-image-2 \
  --image ./reference.png \
  --size 1024x1024 \
  --quality high \
  --out ./output/edit.png \
  "参考这张图片，保持主体不变，改成更明亮的商业摄影风格"

如果需要多个参考图，可以重复传入 --image ./xxx.png。--out 用于指定单张输出文件；生成多张图片或批量任务时，可以使用 --out-dir 指定输出目录。

官方参考 ​