GPT Image 2.6 六分钱出图工作台

## ⚠️ 先申请你自己的 API Key
本包不内嵌任何 Key,用的是你自己在 api.a7w.cn 注册的 Key,
扣的是你自己账户的余额。注册、充值、创建 Key 都在 api.a7w.cn。
```bash
python3 scripts/a7w.py login --key sk-你的key
```

一句话

6 点一张图。 走 api.a7w.cn 的 gpt-image-2.6,OpenAI Images API 兼容、同步出图、零依赖。

实测过的三个坑(都做成了默认动作)

坑一:端点少写一个 /api,你的模型就被静默忽略

✅ POST https://api.a7w.cn/api/v1/images/generations   ← 正确,认 model
❌ POST https://api.a7w.cn/v1/images/generations       ← 也会返回图,
                                                          但忽略 model,落到网关默认应用

实测:往 /v1/images/generations 传 model: "gpt-image-2.6"、甚至传 no-such-model-xyz,
都会路由到 nano_banana(72 点/次),而且不报错。

所以 doctor 专门探这条:发 {"model":"gpt-image-2.6","prompt":""} ——
文档规定缺 prompt 返回 422「String should have at least 1 character」,零扣费。
拿到 422 才算端点对了;拿到 404 或 400 说明路径错了。

坑二:返回默认是 b64_json,不是 URL

直接找 ["data"][0]["url"] 会拿到空。本包两种都处理,自动解码落盘。

# 想要 URL 就加 --want-url(有效期约 3 小时)
python3 scripts/run.py gen --prompt "..." --want-url --yes

坑三:不知道一张几毛钱,不敢试

6 点/张 = ¥0.06。 4 张才 0.24 元。cost 先算,--budget 兜底。

价格(文档原文)

张数价格
1 张6 点(¥0.06)
2 张12 点(¥0.12)
3 张18 点(¥0.18)
4 张24 点(¥0.24)
  • 按张计费,与尺寸、质量、输出格式都无关
  • 按 data 里实际返回的张数计费(n=2 只回 1 张就收 1 张)
  • 参数错误、请求失败、没返回图片 → 不扣费
  • 客户端中途断开 → 仍按请求张数计费

怎么用

第 0 步:拿 Key

到 api.a7w.cn 注册,创建 API Key(形如 sk-...)。

第 1 步:装依赖

零依赖。 只要 Python 3.7+,不需要 pip install 任何东西。

第 2 步:填 Key

export A7W_API_KEY=sk-你的key          # Linux / macOS
$env:A7W_API_KEY="sk-你的key"          # Windows PowerShell

# 或者存起来反复用(推荐)
python3 scripts/a7w.py login --key sk-你的key

第 3 步:自检(不扣费)

python3 scripts/run.py doctor
✓ Key 有效性 + 模型目录可达      HTTP 200
✓ 模型 gpt-image-2.6 在架       目录共 221 个
✓ 文生图端点可用(422 即正确)   HTTP 422 prompt: String should have at least 1 characte

第 4 步:先算钱

python3 scripts/run.py cost --n 4
# 张数:4 × 6 点 = 24 点 = 0.24 元

第 5 步:出图

# 文生图
python3 scripts/run.py gen --prompt "一只橘猫坐在窗台上晒太阳,写实风格" \
    --size 1024x1024 --yes

# 一次 4 张
python3 scripts/run.py gen --prompt "四种风格的猫" --n 4 --budget 30 --yes

# 图生图(把帽子戴到猫头上)
python3 scripts/run.py edit --prompt "把第二张图里的帽子戴到第一张图的猫头上" \
    --image cat.png --image hat.png --yes

# GIF 动图
python3 scripts/run.py gen --prompt "一只橘猫在挥手" --gif --yes

# 透明背景(只能配 png / webp)
python3 scripts/run.py gen --prompt "一个图标" --background transparent --yes

不加 --yes 会退 4,并告诉你这次要花多少点。想先看不花钱的请求:

python3 scripts/run.py gen --prompt "一只橘猫" --dry-run

实测记录

2026-11-07  gpt-image-2.6  1024x1024  n=1
  出图   43.6 秒
  返回   1 张(b64_json)
  产物   1,639,194 字节 PNG(1024×1024)
  扣费   6 点(¥0.06)

参数

参数默认说明
--prompt必填提示词
--n11–4,超范围直接拒
--sizeautoauto / 1k / 2k / 4k / 宽x高
--output-formatpngpng / jpeg / webp / gif
--gif—等价于 --output-format gif
--backgroundautoauto / transparent / opaque(透明不能配 jpeg/gif)
--qualityautoauto/low/medium/high/xhigh/max,不影响价格
--compression—0–100,只对 jpeg/webp 生效
--want-url—让网关返回 url 而不是 b64_json
--outdir.图片保存目录
--budget500点数上限(单位:点,1 元 = 100 点)
--yes—确认真实扣费

自定义尺寸的四条硬约束(不合规 → 400,不扣费)

  • 宽高都是 16 的倍数
  • 长边 / 短边 不超过 3:1
  • 单边 不超过 3840
  • 总像素 655,360 – 8,294,400

本包在本地就校验这四条,不合格直接退 2,不发请求。

子命令

子命令扣费吗干什么
models免费列出在架图片模型(当前 221 个目录里的图片类)
cost免费先算钱(6 点/张)
doctor免费自检 Key / 模型 / 端点
gen6 点/张文生图(要 --yes)
edit6 点/张图生图(multipart,要 --yes)
log免费本地台账

退出码

码含义
0成功
2用法错(缺 --prompt、尺寸不合规、n 越界、选项缩写)
4需要确认 —— 没给 --yes
5预算不足 —— 一个请求都不发
6调用失败 / 响应里没有图
1内部错误
130被 Ctrl-C 中断

--json 契约

{"ok": true, "mode": "gen", "model": "gpt-image-2.6", "elapsed": 43.6,
 "requested": 1, "returned": 1, "source": "b64_json",
 "files": ["./gptimg-01.png"], "urls": [], "billedPoints": 6,
 "size": "1024x1024", "output_format": "png"}

失败:

{"ok": false, "exit": 5, "error": {"kind": "budget", "message": "…"}}

--json 写在子命令前面或后面都可以,stdout 只有一个 JSON 文档。

文件结构

sanjianke-gpt-image/
├── SKILL.md
├── README.md
├── LICENSE.md
├── references/
│   ├── api-contract.md       接口契约(文档原文 + 实测)
│   └── troubleshooting.md    排错:按报错找原因
└── scripts/
    ├── a7w.py                零依赖客户端(全家族共用,逐字节一致)
    └── run.py                本包命令层

免责

  • 图片链接有效期约 3 小时,请及时下载;链接请原样使用(追加查询参数会 404);下载不需要 Key。
  • quality 只是提示,不影响价格,也不要指望它切换画质档位。
  • 真实扣费以响应里实际返回的张数为准,cost 给的是预估。

联系我们

  • 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
  • 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
  • 更多 AI 插件与接口:AI 插件市场。

同类文章