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 | 必填 | 提示词 |
--n | 1 | 1–4,超范围直接拒 |
--size | auto | auto / 1k / 2k / 4k / 宽x高 |
--output-format | png | png / jpeg / webp / gif |
--gif | — | 等价于 --output-format gif |
--background | auto | auto / transparent / opaque(透明不能配 jpeg/gif) |
--quality | auto | auto/low/medium/high/xhigh/max,不影响价格 |
--compression | — | 0–100,只对 jpeg/webp 生效 |
--want-url | — | 让网关返回 url 而不是 b64_json |
--outdir | . | 图片保存目录 |
--budget | 500 | 点数上限(单位:点,1 元 = 100 点) |
--yes | — | 确认真实扣费 |
自定义尺寸的四条硬约束(不合规 → 400,不扣费)
- 宽高都是 16 的倍数
- 长边 / 短边 不超过 3:1
- 单边 不超过 3840
- 总像素 655,360 – 8,294,400
本包在本地就校验这四条,不合格直接退 2,不发请求。
子命令
| 子命令 | 扣费吗 | 干什么 |
|---|---|---|
models | 免费 | 列出在架图片模型(当前 221 个目录里的图片类) |
cost | 免费 | 先算钱(6 点/张) |
doctor | 免费 | 自检 Key / 模型 / 端点 |
gen | 6 点/张 | 文生图(要 --yes) |
edit | 6 点/张 | 图生图(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 插件市场。