gpt-image-2-api-format.md
3.34 KB
GPT Image 2 API Format (WanJie MaaS 万界方舟)
⚠️ GOTCHAS — 避坑(先读!2026-07-07 真机验证)
- 模型 id 字面就是
GPT Image 2(带空格) —— 不是 gpt-image-2 / image2 / gpt_image_2。 - 绝对不要传
responseFormat(camelCase) —— 传了会返回纯文本文生图获取失败(22 字节,不是 JSON),生图失败。- 正确:请求体只放
{model, prompt, n, size},不带 responseFormat,默认返回data[0].b64_json(base64 PNG)。 - 如果历史上你遇到「文生图获取失败」→ 就是这个坑,删掉 responseFormat 字段即可。
- 正确:请求体只放
- key 在环境变量
$WANJIE_API_KEY—— 若报未授权/取不到 key,检查该 env 是否设置(见文末「Key 配置」)。若 env 缺失才降级本地 PIL;env 配好后优先用 GPT Image 2(质量远超 PIL)。 - 生成的图要发微信时:先存到
/sdcard/Pictures/并触发 MediaStore 扫描,再用send_wechat_imageMCP 工具发,否则接收方收到红叹号破损图(微信图片 CDN 上传按 MediaStore 解析文件)。send_wechat_image工具已自动处理这步。
Endpoint
POST https://maas-openapi.wanjiedata.com/api/v1/images/generations
Request(正确格式,勿加 responseFormat)
{
"model": "GPT Image 2",
"prompt": "Your prompt text here...",
"n": 1,
"size": "1024x1024"
}
Response
{"created":1234567890,"data":[{"b64_json":"iVBORw0K...(base64 PNG)"}],"usage":{...}}
提取图片:data[0].b64_json → base64 decode → PNG(1024×1024,~1.5–2.3MB)。
curl(可直接跑)
curl -s -X POST 'https://maas-openapi.wanjiedata.com/api/v1/images/generations' \
-H "Authorization: Bearer $WANJIE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"GPT Image 2","prompt":"A cute orange cat","n":1,"size":"1024x1024"}' \
| python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')"
端到端:生图 + 发微信(推荐流程)
# 1. 生图 → 存到 /sdcard/Pictures/(媒体目录,微信可索引)
curl -s -X POST 'https://maas-openapi.wanjiedata.com/api/v1/images/generations' \
-H "Authorization: Bearer $WANJIE_API_KEY" -H 'Content-Type: application/json' \
-d '{"model":"GPT Image 2","prompt":"<你的 prompt>","n":1,"size":"1024x1024"}' \
| python3 -c "import sys,json,base64;d=json.load(sys.stdin);open('/sdcard/Pictures/gen.png','wb').write(base64.b64decode(d['data'][0]['b64_json']))"
# 2. 用 MCP 工具发(自动 stage 到 /sdcard/Pictures + media scan,避红叹号)
# mcp_android_phone_send_wechat_image(to="<wxid>", image_path="/sdcard/Pictures/gen.png")
Model Listing
curl https://maas-openapi.wanjiedata.com/api/v1/models -H "Authorization: Bearer $WANJIE_API_KEY"
# → 71 个模型,图像相关只有 "GPT Image 2"(+ hunyuan-vision,非文生图)
Key 配置(让 Hermes 自动用 GPT Image 2)
$WANJIE_API_KEY已写进~/.bashrc+~/.profile+~/.hermes_env.sh(BASH_ENV 兜底非交互子进程)。- 从 Termux 交互 shell 跑 hermes 会自动带上;若某次子进程取不到,
source ~/.hermes_env.sh或检查 BASH_ENV。 - key 是 JWT,明文存 rc 文件;轮换 key 时改这三个文件。